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

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

[diff] [blame]

201

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

202

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

203

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

204

#

205

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

206

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

Bu Sun Kim

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

[diff] [blame]

207

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

208

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

Bu Sun Kim

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

[diff] [blame]

209

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

210

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

Bu Sun Kim

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

[diff] [blame]

211

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

Bu Sun Kim

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

[diff] [blame]

212

# message types for APIs to use.

213

{

Bu Sun Kim

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

[diff] [blame]

214

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

Bu Sun Kim

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

[diff] [blame]

215

},

216

],

217

},

Bu Sun Kim

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

[diff] [blame]

218

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

219

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

220

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

221

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

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.

Bu Sun Kim

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

[diff] [blame^]

252

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

253

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

254

# MoveFolder.

255

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

Bu Sun Kim

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

[diff] [blame]

256

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

Dan O'Meara

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

[diff] [blame]

257

# Updates to the lifecycle_state must be performed via

258

# DeleteFolder and

259

# UndeleteFolder.

Bu Sun Kim

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

[diff] [blame]

260

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

261

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

262

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

Bu Sun Kim

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

[diff] [blame]

263

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

264

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

265

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

266

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

267

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

268

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

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.

Bu Sun Kim

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

[diff] [blame^]

293

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

294

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

295

# MoveFolder.

296

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

Bu Sun Kim

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

[diff] [blame]

297

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

Dan O'Meara

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

[diff] [blame]

298

# Updates to the lifecycle_state must be performed via

299

# DeleteFolder and

300

# UndeleteFolder.

Bu Sun Kim

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

[diff] [blame]

301

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

302

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

303

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

Bu Sun Kim

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

[diff] [blame]

304

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

305

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

306

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

307

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

308

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

309

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

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-27 12:20:54 -0700

[diff] [blame^]

420

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

421

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

422

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

423

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

424

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

425

#

426

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

427

# current request.

428

#

429

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

430

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

431

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

432

#

433

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

434

# [IAM

435

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

436

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

437

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

438

#

439

# Example (Comparison):

440

#

441

# title: "Summary size limit"

442

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

443

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

444

#

445

# Example (Equality):

446

#

447

# title: "Requestor is owner"

448

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

449

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

#

# Example (Logic):

#

# title: "Public documents"

454

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

455

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

456

#

457

# Example (Data Manipulation):

458

#

459

# title: "Notification string"

460

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

461

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

462

#

463

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

464

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

465

# documentation for additional information.

466

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

467

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

468

# expression.

469

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

470

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

471

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

472

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

473

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

474

# syntax.

475

},

476

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

477

# `members` can have the following values:

478

#

479

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

480

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

481

#

482

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

483

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

484

#

485

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

486

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

487

#

488

#

489

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

490

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

491

#

492

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

493

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

494

#

495

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

496

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

497

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

498

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

499

# retains the role in the binding.

500

#

501

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

502

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

503

# deleted. For example,

504

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

505

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

506

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

507

# role in the binding.

508

#

509

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

510

# identifier) representing a Google group that has been recently

511

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

512

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

513

# recovered group retains the role in the binding.

514

#

515

#

516

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

517

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

#

"A String",

],

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

522

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

523

},

524

],

Bu Sun Kim

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

[diff] [blame]

525

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

526

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

527

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

528

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

529

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

530

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

531

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

532

#

533

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

534

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

535

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

536

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

537

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

Dan O'Meara

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

[diff] [blame]

538

#

539

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

540

# are rejected.

541

#

542

# Any operation that affects conditional role bindings must specify version

543

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

544

#

545

# * Getting a policy that includes a conditional role binding

546

# * Adding a conditional role binding to a policy

547

# * Changing a conditional role binding in a policy

548

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

549

# that includes conditions

550

#

551

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

552

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

553

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

554

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

555

#

556

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

557

# specify any valid version or leave the field unset.

Bu Sun Kim

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

[diff] [blame]

558

#

559

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

560

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

561

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

562

{ # Specifies the audit configuration for a service.

563

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

564

# identities, if any, are exempted from logging.

565

# An AuditConfig must have one or more AuditLogConfigs.

566

#

567

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

568

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

569

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

570

# AuditLogConfig are exempted.

571

#

572

# Example Policy with multiple AuditConfigs:

#

# {

# "audit_configs": [

# {

# "service": "allServices"

578

# "audit_log_configs": [

579

# {

580

# "log_type": "DATA_READ",

581

# "exempted_members": [

582

# "user:jose@example.com"

# ]

# },

# {

# "log_type": "DATA_WRITE",

587

# },

588

# {

589

# "log_type": "ADMIN_READ",

# }

# ]

# },

# {

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

595

# "audit_log_configs": [

596

# {

597

# "log_type": "DATA_READ",

598

# },

599

# {

600

# "log_type": "DATA_WRITE",

601

# "exempted_members": [

602

# "user:aliya@example.com"

# ]

# }

# ]

# }

# ]

# }

#

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

611

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

612

# aliya@example.com from DATA_WRITE logging.

613

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

614

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

615

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

616

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

617

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

# Example:

#

# {

# "audit_log_configs": [

622

# {

623

# "log_type": "DATA_READ",

624

# "exempted_members": [

625

# "user:jose@example.com"

# ]

# },

# {

# "log_type": "DATA_WRITE",

# }

# ]

# }

#

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

635

# jose@example.com from DATA_READ logging.

636

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

637

# permission.

638

# Follows the same format of Binding.members.

639

"A String",

640

],

641

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

},

],

},

],

Bu Sun Kim

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

[diff] [blame]

}</pre>

</div>

Bu Sun Kim

2020-05-20 12:08:20 -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-20 12:08:20 -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-20 12:08:20 -0700

[diff] [blame]

680

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

Bu Sun Kim

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

[diff] [blame]

681

# the specified parent resource.

Bu Sun Kim

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

[diff] [blame]

682

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

683

# organize that Organization's resources.

Bu Sun Kim

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

[diff] [blame^]

684

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

685

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

686

# MoveFolder.

687

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

Bu Sun Kim

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

[diff] [blame]

688

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

Dan O'Meara

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

[diff] [blame]

689

# Updates to the lifecycle_state must be performed via

690

# DeleteFolder and

691

# UndeleteFolder.

Bu Sun Kim

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

[diff] [blame]

692

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

693

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

694

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

Bu Sun Kim

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

[diff] [blame]

695

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

696

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

697

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

698

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

699

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

700

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

Bu Sun Kim

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

[diff] [blame]

701

},

702

],

Bu Sun Kim

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

[diff] [blame^]

703

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

704

# that indicates from where listing should continue.

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

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

765

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

766

# available.

767

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

Bu Sun Kim

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

[diff] [blame]

768

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

769

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

770

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

771

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

772

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

773

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

774

# `TakeSnapshotResponse`.

Bu Sun Kim

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

[diff] [blame]

775

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

Bu Sun Kim

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

[diff] [blame]

776

},

Bu Sun Kim

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

[diff] [blame]

777

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

Bu Sun Kim

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

[diff] [blame]

778

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

779

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

Bu Sun Kim

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

[diff] [blame]

780

"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.

Bu Sun Kim

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

[diff] [blame]

781

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

782

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

783

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

784

#

785

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

786

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

Bu Sun Kim

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

[diff] [blame]

787

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

788

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

Bu Sun Kim

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

[diff] [blame]

789

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

790

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

Bu Sun Kim

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

[diff] [blame]

791

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

Bu Sun Kim

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

[diff] [blame]

792

# message types for APIs to use.

793

{

Bu Sun Kim

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

[diff] [blame]

794

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

Bu Sun Kim

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

[diff] [blame]

795

},

796

],

797

},

Bu Sun Kim

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

[diff] [blame]

798

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

799

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

800

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

801

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

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.

Bu Sun Kim

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

[diff] [blame^]

833

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

834

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

835

# MoveFolder.

836

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

Bu Sun Kim

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

[diff] [blame]

837

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

Dan O'Meara

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

[diff] [blame]

838

# Updates to the lifecycle_state must be performed via

839

# DeleteFolder and

840

# UndeleteFolder.

Bu Sun Kim

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

[diff] [blame]

841

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

842

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

843

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

Bu Sun Kim

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

[diff] [blame]

844

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

845

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

846

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

847

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

848

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

849

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

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.

Bu Sun Kim

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

[diff] [blame^]

864

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

865

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

866

# MoveFolder.

867

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

Bu Sun Kim

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

[diff] [blame]

868

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

Dan O'Meara

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

[diff] [blame]

869

# Updates to the lifecycle_state must be performed via

870

# DeleteFolder and

871

# UndeleteFolder.

Bu Sun Kim

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

[diff] [blame]

872

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

873

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

874

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

Bu Sun Kim

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

[diff] [blame]

875

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

876

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

877

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

878

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

879

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

880

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

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-20 12:08:20 -0700

[diff] [blame]

898

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

Bu Sun Kim

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

[diff] [blame]

899

# that indicates from where search should continue.

Bu Sun Kim

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

[diff] [blame]

900

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

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.

Bu Sun Kim

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

[diff] [blame^]

939

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

940

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

941

# MoveFolder.

942

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

Bu Sun Kim

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

[diff] [blame]

943

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

Dan O'Meara

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

[diff] [blame]

944

# Updates to the lifecycle_state must be performed via

945

# DeleteFolder and

946

# UndeleteFolder.

Bu Sun Kim

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

[diff] [blame]

947

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

948

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

949

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

Bu Sun Kim

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

[diff] [blame]

950

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

951

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

952

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

953

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

954

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

955

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

Bu Sun Kim

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

[diff] [blame]

956

},

957

],

Bu Sun Kim

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

[diff] [blame^]

958

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

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-20 12:08:20 -0700

[diff] [blame]

992

"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]

993

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

994

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

995

# might reject them.

Dan O'Meara

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

[diff] [blame]

996

# controls for Google Cloud resources.

Bu Sun Kim

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

[diff] [blame]

997

#

998

#

Dan O'Meara

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

[diff] [blame]

999

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

1000

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

1001

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

1002

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

1003

# custom role.

Bu Sun Kim

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

[diff] [blame]

1004

#

Bu Sun Kim

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

[diff] [blame]

1005

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

1006

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

1007

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

1008

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

1009

# resources support conditions in their IAM policies, see the

1010

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

Dan O'Meara

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

[diff] [blame]

1011

#

1012

# **JSON example:**

Bu Sun Kim

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

[diff] [blame]

1013

#

1014

# {

Bu Sun Kim

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

[diff] [blame]

1015

# "bindings": [

Bu Sun Kim

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

[diff] [blame]

1016

# {

Bu Sun Kim

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

[diff] [blame]

1017

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

1018

# "members": [

1019

# "user:mike@example.com",

1020

# "group:admins@example.com",

1021

# "domain:google.com",

1022

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

Bu Sun Kim

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

[diff] [blame]

1023

# ]

1024

# },

1025

# {

Bu Sun Kim

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

[diff] [blame]

1026

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

1027

# "members": [

1028

# "user:eve@example.com"

1029

# ],

1030

# "condition": {

1031

# "title": "expirable access",

1032

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

1033

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

Dan O'Meara

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

[diff] [blame]

1034

# }

Bu Sun Kim

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

[diff] [blame]

1035

# }

Dan O'Meara

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

[diff] [blame]

1036

# ],

Bu Sun Kim

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

[diff] [blame]

1037

# "etag": "BwWWja0YfJA=",

1038

# "version": 3

Bu Sun Kim

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

[diff] [blame]

1039

# }

1040

#

Dan O'Meara

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

[diff] [blame]

1041

# **YAML example:**

Bu Sun Kim

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

[diff] [blame]

#

# bindings:

# - members:

# - user:mike@example.com

1046

# - group:admins@example.com

1047

# - domain:google.com

Dan O'Meara

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

[diff] [blame]

1048

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

1049

# role: roles/resourcemanager.organizationAdmin

Bu Sun Kim

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

[diff] [blame]

1050

# - members:

Dan O'Meara

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

[diff] [blame]

1051

# - user:eve@example.com

1052

# role: roles/resourcemanager.organizationViewer

1053

# condition:

1054

# title: expirable access

1055

# description: Does not grant access after Sep 2020

Bu Sun Kim

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

[diff] [blame]

1056

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

Dan O'Meara

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

[diff] [blame]

1057

# - etag: BwWWja0YfJA=

1058

# - version: 3

Bu Sun Kim

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

[diff] [blame]

1059

#

1060

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

Dan O'Meara

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

[diff] [blame]

1061

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

Bu Sun Kim

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

[diff] [blame^]

1062

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

1063

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

1064

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

1065

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

1066

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

1067

#

1068

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

1069

# current request.

1070

#

1071

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

1072

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

1073

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

1074

#

1075

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

1076

# [IAM

1077

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

1078

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

1079

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

1080

#

1081

# Example (Comparison):

1082

#

1083

# title: "Summary size limit"

1084

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

1085

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

1086

#

1087

# Example (Equality):

1088

#

1089

# title: "Requestor is owner"

1090

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

1091

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

#

# Example (Logic):

#

# title: "Public documents"

1096

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

1097

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

1098

#

1099

# Example (Data Manipulation):

1100

#

1101

# title: "Notification string"

1102

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

1103

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

1104

#

1105

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

1106

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

1107

# documentation for additional information.

1108

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

1109

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

1110

# expression.

1111

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

1112

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

1113

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

1114

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

1115

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

1116

# syntax.

1117

},

1118

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

1119

# `members` can have the following values:

1120

#

1121

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

1122

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

1123

#

1124

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

1125

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

1126

#

1127

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

1128

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

1129

#

1130

#

1131

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

1132

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

1133

#

1134

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

1135

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

1136

#

1137

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

1138

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

1139

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

1140

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

1141

# retains the role in the binding.

1142

#

1143

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

1144

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

1145

# deleted. For example,

1146

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

1147

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

1148

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

1149

# role in the binding.

1150

#

1151

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

1152

# identifier) representing a Google group that has been recently

1153

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

1154

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

1155

# recovered group retains the role in the binding.

1156

#

1157

#

1158

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

1159

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

#

"A String",

],

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

1164

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

1165

},

1166

],

Bu Sun Kim

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

[diff] [blame]

1167

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

1168

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

1169

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

1170

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

1171

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

1172

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

1173

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

1174

#

1175

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

1176

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

1177

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

1178

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

1179

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

Dan O'Meara

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

[diff] [blame]

1180

#

1181

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

1182

# are rejected.

1183

#

1184

# Any operation that affects conditional role bindings must specify version

1185

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

1186

#

1187

# * Getting a policy that includes a conditional role binding

1188

# * Adding a conditional role binding to a policy

1189

# * Changing a conditional role binding in a policy

1190

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

1191

# that includes conditions

1192

#

1193

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

1194

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

1195

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

1196

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

1197

#

1198

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

1199

# specify any valid version or leave the field unset.

Bu Sun Kim

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

[diff] [blame]

1200

#

1201

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

1202

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

1203

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

1204

{ # Specifies the audit configuration for a service.

1205

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

1206

# identities, if any, are exempted from logging.

1207

# An AuditConfig must have one or more AuditLogConfigs.

1208

#

1209

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

1210

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

1211

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

1212

# AuditLogConfig are exempted.

1213

#

1214

# Example Policy with multiple AuditConfigs:

#

# {

# "audit_configs": [

# {

# "service": "allServices"

1220

# "audit_log_configs": [

1221

# {

1222

# "log_type": "DATA_READ",

1223

# "exempted_members": [

1224

# "user:jose@example.com"

# ]

# },

# {

# "log_type": "DATA_WRITE",

1229

# },

1230

# {

1231

# "log_type": "ADMIN_READ",

# }

# ]

# },

# {

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

1237

# "audit_log_configs": [

1238

# {

1239

# "log_type": "DATA_READ",

1240

# },

1241

# {

1242

# "log_type": "DATA_WRITE",

1243

# "exempted_members": [

1244

# "user:aliya@example.com"

# ]

# }

# ]

# }

# ]

# }

#

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

1253

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

1254

# aliya@example.com from DATA_WRITE logging.

1255

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

1256

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

1257

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

1258

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

1259

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

# Example:

#

# {

# "audit_log_configs": [

1264

# {

1265

# "log_type": "DATA_READ",

1266

# "exempted_members": [

1267

# "user:jose@example.com"

# ]

# },

# {

# "log_type": "DATA_WRITE",

# }

# ]

# }

#

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

1277

# jose@example.com from DATA_READ logging.

1278

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

1279

# permission.

1280

# Follows the same format of Binding.members.

1281

"A String",

1282

],

1283

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

},

],

},

],

Bu Sun Kim

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

[diff] [blame]

1288

},

Bu Sun Kim

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

[diff] [blame]

1289

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

Bu Sun Kim

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

[diff] [blame]

1290

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

1291

# following default mask is used:

Dan O'Meara

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

[diff] [blame]

1292

#

Bu Sun Kim

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

[diff] [blame]

1293

# `paths: "bindings, etag"`

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-27 12:20:54 -0700

[diff] [blame^]

1371

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

1372

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

1373

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

1374

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

1375

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

1376

#

1377

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

1378

# current request.

1379

#

1380

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

1381

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

1382

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

1383

#

1384

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

1385

# [IAM

1386

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

1387

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

1388

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

1389

#

1390

# Example (Comparison):

1391

#

1392

# title: "Summary size limit"

1393

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

1394

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

1395

#

1396

# Example (Equality):

1397

#

1398

# title: "Requestor is owner"

1399

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

1400

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

#

# Example (Logic):

#

# title: "Public documents"

1405

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

1406

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

1407

#

1408

# Example (Data Manipulation):

1409

#

1410

# title: "Notification string"

1411

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

1412

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

1413

#

1414

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

1415

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

1416

# documentation for additional information.

1417

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

1418

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

1419

# expression.

1420

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

1421

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

1422

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

1423

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

1424

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

1425

# syntax.

1426

},

1427

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

1428

# `members` can have the following values:

1429

#

1430

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

1431

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

1432

#

1433

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

1434

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

1435

#

1436

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

1437

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

1438

#

1439

#

1440

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

1441

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

1442

#

1443

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

1444

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

1445

#

1446

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

1447

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

1448

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

1449

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

1450

# retains the role in the binding.

1451

#

1452

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

1453

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

1454

# deleted. For example,

1455

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

1456

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

1457

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

1458

# role in the binding.

1459

#

1460

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

1461

# identifier) representing a Google group that has been recently

1462

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

1463

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

1464

# recovered group retains the role in the binding.

1465

#

1466

#

1467

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

1468

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

#

"A String",

],

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

1473

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

1474

},

1475

],

Bu Sun Kim

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

[diff] [blame]

1476

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

1477

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

1478

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

1479

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

1480

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

1481

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

1482

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

1483

#

1484

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

1485

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

1486

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

1487

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

1488

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

Dan O'Meara

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

[diff] [blame]

1489

#

1490

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

1491

# are rejected.

1492

#

1493

# Any operation that affects conditional role bindings must specify version

1494

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

1495

#

1496

# * Getting a policy that includes a conditional role binding

1497

# * Adding a conditional role binding to a policy

1498

# * Changing a conditional role binding in a policy

1499

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

1500

# that includes conditions

1501

#

1502

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

1503

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

1504

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

1505

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

1506

#

1507

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

1508

# specify any valid version or leave the field unset.

Bu Sun Kim

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

[diff] [blame]

1509

#

1510

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

1511

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

1512

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

1513

{ # Specifies the audit configuration for a service.

1514

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

1515

# identities, if any, are exempted from logging.

1516

# An AuditConfig must have one or more AuditLogConfigs.

1517

#

1518

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

1519

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

1520

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

1521

# AuditLogConfig are exempted.

1522

#

1523

# Example Policy with multiple AuditConfigs:

#

# {

# "audit_configs": [

# {

# "service": "allServices"

1529

# "audit_log_configs": [

1530

# {

1531

# "log_type": "DATA_READ",

1532

# "exempted_members": [

1533

# "user:jose@example.com"

# ]

# },

# {

# "log_type": "DATA_WRITE",

1538

# },

1539

# {

1540

# "log_type": "ADMIN_READ",

# }

# ]

# },

# {

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

1546

# "audit_log_configs": [

1547

# {

1548

# "log_type": "DATA_READ",

1549

# },

1550

# {

1551

# "log_type": "DATA_WRITE",

1552

# "exempted_members": [

1553

# "user:aliya@example.com"

# ]

# }

# ]

# }

# ]

# }

#

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

1562

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

1563

# aliya@example.com from DATA_WRITE logging.

1564

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

1565

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

1566

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

1567

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

1568

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

# Example:

#

# {

# "audit_log_configs": [

1573

# {

1574

# "log_type": "DATA_READ",

1575

# "exempted_members": [

1576

# "user:jose@example.com"

# ]

# },

# {

# "log_type": "DATA_WRITE",

# }

# ]

# }

#

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

1586

# jose@example.com from DATA_READ logging.

1587

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

1588

# permission.

1589

# Follows the same format of Binding.members.

1590

"A String",

1591

],

1592

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

},

],

},

],

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.

Bu Sun Kim

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

[diff] [blame^]

1671

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

1672

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

1673

# MoveFolder.

1674

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

Bu Sun Kim

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

[diff] [blame]

1675

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

Dan O'Meara

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

[diff] [blame]

1676

# Updates to the lifecycle_state must be performed via

1677

# DeleteFolder and

1678

# UndeleteFolder.

Bu Sun Kim

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

[diff] [blame]

1679

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

1680

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

1681

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

Bu Sun Kim

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

[diff] [blame]

1682

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

1683

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

1684

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

1685

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

1686

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

1687

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

Bu Sun Kim