Regen all docs. (#700)
* Stop recursing if discovery == {}
* Generate docs with 'make docs'.
diff --git a/docs/dyn/sourcerepo_v1.projects.repos.html b/docs/dyn/sourcerepo_v1.projects.repos.html
index 45b3b7c..34a0474 100644
--- a/docs/dyn/sourcerepo_v1.projects.repos.html
+++ b/docs/dyn/sourcerepo_v1.projects.repos.html
@@ -93,9 +93,15 @@
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
<p class="firstline">Retrieves the next page of results.</p>
<p class="toc_element">
+ <code><a href="#patch">patch(name, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Updates information about a repo.</p>
+<p class="toc_element">
<code><a href="#setIamPolicy">setIamPolicy(resource, body, x__xgafv=None)</a></code></p>
<p class="firstline">Sets the access control policy on the specified resource. Replaces any</p>
<p class="toc_element">
+ <code><a href="#sync">sync(name, body=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Synchronize a connected repo.</p>
+<p class="toc_element">
<code><a href="#testIamPermissions">testIamPermissions(resource, body, x__xgafv=None)</a></code></p>
<p class="firstline">Returns permissions that a caller has on the specified resource.</p>
<h3>Method Details</h3>
@@ -114,16 +120,32 @@
{ # A repository (or repo) is a Git repository storing versioned source content.
"url": "A String", # URL to clone the repository from Google Cloud Source Repositories.
- "size": "A String", # The disk usage of the repo, in bytes.
- # Only returned by GetRepo.
+ # Read-only field.
+ "pubsubConfigs": { # How this repository publishes a change in the repository through Cloud
+ # Pub/Sub. Keyed by the topic names.
+ "a_key": { # Configuration to publish a Cloud Pub/Sub message.
+ "topic": "A String", # A topic of Cloud Pub/Sub. Values are of the form
+ # `projects/<project>/topics/<topic>`. The project needs to be the same
+ # project as this config is in.
+ "messageFormat": "A String", # The format of the Cloud Pub/Sub messages.
+ "serviceAccountEmail": "A String", # Email address of the service account used for publishing Cloud Pub/Sub
+ # messages. This service account needs to be in the same project as the
+ # PubsubConfig. When added, the caller needs to have
+ # iam.serviceAccounts.actAs permission on this service account. If
+ # unspecified, it defaults to the compute engine default service account.
+ },
+ },
+ "size": "A String", # The disk usage of the repo, in bytes. Read-only field. Size is only
+ # returned by GetRepo.
"name": "A String", # Resource name of the repository, of the form
# `projects/<project>/repos/<repo>`. The repo name may contain slashes.
# eg, `projects/myproject/repos/name/with/slash`
"mirrorConfig": { # Configuration to automatically mirror a repository from another # How this repository mirrors a repository managed by another service.
- # hosting service, for example GitHub or BitBucket.
+ # Read-only field.
+ # hosting service, for example GitHub or Bitbucket.
"url": "A String", # URL of the main repository at the other hosting service.
"webhookId": "A String", # ID of the webhook listening to updates to trigger mirroring.
- # Removing this webook from the other hosting service will stop
+ # Removing this webhook from the other hosting service will stop
# Google Cloud Source Repositories from receiving notifications,
# and thereby disabling mirroring.
"deployKeyId": "A String", # ID of the SSH deploy key at the other hosting service.
@@ -142,16 +164,32 @@
{ # A repository (or repo) is a Git repository storing versioned source content.
"url": "A String", # URL to clone the repository from Google Cloud Source Repositories.
- "size": "A String", # The disk usage of the repo, in bytes.
- # Only returned by GetRepo.
+ # Read-only field.
+ "pubsubConfigs": { # How this repository publishes a change in the repository through Cloud
+ # Pub/Sub. Keyed by the topic names.
+ "a_key": { # Configuration to publish a Cloud Pub/Sub message.
+ "topic": "A String", # A topic of Cloud Pub/Sub. Values are of the form
+ # `projects/<project>/topics/<topic>`. The project needs to be the same
+ # project as this config is in.
+ "messageFormat": "A String", # The format of the Cloud Pub/Sub messages.
+ "serviceAccountEmail": "A String", # Email address of the service account used for publishing Cloud Pub/Sub
+ # messages. This service account needs to be in the same project as the
+ # PubsubConfig. When added, the caller needs to have
+ # iam.serviceAccounts.actAs permission on this service account. If
+ # unspecified, it defaults to the compute engine default service account.
+ },
+ },
+ "size": "A String", # The disk usage of the repo, in bytes. Read-only field. Size is only
+ # returned by GetRepo.
"name": "A String", # Resource name of the repository, of the form
# `projects/<project>/repos/<repo>`. The repo name may contain slashes.
# eg, `projects/myproject/repos/name/with/slash`
"mirrorConfig": { # Configuration to automatically mirror a repository from another # How this repository mirrors a repository managed by another service.
- # hosting service, for example GitHub or BitBucket.
+ # Read-only field.
+ # hosting service, for example GitHub or Bitbucket.
"url": "A String", # URL of the main repository at the other hosting service.
"webhookId": "A String", # ID of the webhook listening to updates to trigger mirroring.
- # Removing this webook from the other hosting service will stop
+ # Removing this webhook from the other hosting service will stop
# Google Cloud Source Repositories from receiving notifications,
# and thereby disabling mirroring.
"deployKeyId": "A String", # ID of the SSH deploy key at the other hosting service.
@@ -205,16 +243,32 @@
{ # A repository (or repo) is a Git repository storing versioned source content.
"url": "A String", # URL to clone the repository from Google Cloud Source Repositories.
- "size": "A String", # The disk usage of the repo, in bytes.
- # Only returned by GetRepo.
+ # Read-only field.
+ "pubsubConfigs": { # How this repository publishes a change in the repository through Cloud
+ # Pub/Sub. Keyed by the topic names.
+ "a_key": { # Configuration to publish a Cloud Pub/Sub message.
+ "topic": "A String", # A topic of Cloud Pub/Sub. Values are of the form
+ # `projects/<project>/topics/<topic>`. The project needs to be the same
+ # project as this config is in.
+ "messageFormat": "A String", # The format of the Cloud Pub/Sub messages.
+ "serviceAccountEmail": "A String", # Email address of the service account used for publishing Cloud Pub/Sub
+ # messages. This service account needs to be in the same project as the
+ # PubsubConfig. When added, the caller needs to have
+ # iam.serviceAccounts.actAs permission on this service account. If
+ # unspecified, it defaults to the compute engine default service account.
+ },
+ },
+ "size": "A String", # The disk usage of the repo, in bytes. Read-only field. Size is only
+ # returned by GetRepo.
"name": "A String", # Resource name of the repository, of the form
# `projects/<project>/repos/<repo>`. The repo name may contain slashes.
# eg, `projects/myproject/repos/name/with/slash`
"mirrorConfig": { # Configuration to automatically mirror a repository from another # How this repository mirrors a repository managed by another service.
- # hosting service, for example GitHub or BitBucket.
+ # Read-only field.
+ # hosting service, for example GitHub or Bitbucket.
"url": "A String", # URL of the main repository at the other hosting service.
"webhookId": "A String", # ID of the webhook listening to updates to trigger mirroring.
- # Removing this webook from the other hosting service will stop
+ # Removing this webhook from the other hosting service will stop
# Google Cloud Source Repositories from receiving notifications,
# and thereby disabling mirroring.
"deployKeyId": "A String", # ID of the SSH deploy key at the other hosting service.
@@ -245,12 +299,12 @@
# specify access control policies for Cloud Platform resources.
#
#
- # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+ # A `Policy` consists of a list of `bindings`. A `binding` binds a list of
# `members` to a `role`, where the members can be user accounts, Google groups,
# Google domains, and service accounts. A `role` is a named list of permissions
# defined by IAM.
#
- # **Example**
+ # **JSON Example**
#
# {
# "bindings": [
@@ -260,7 +314,7 @@
# "user:mike@example.com",
# "group:admins@example.com",
# "domain:google.com",
- # "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+ # "serviceAccount:my-other-app@appspot.gserviceaccount.com"
# ]
# },
# {
@@ -270,8 +324,22 @@
# ]
# }
#
+ # **YAML Example**
+ #
+ # bindings:
+ # - members:
+ # - user:mike@example.com
+ # - group:admins@example.com
+ # - domain:google.com
+ # - serviceAccount:my-other-app@appspot.gserviceaccount.com
+ # role: roles/owner
+ # - members:
+ # - user:sean@example.com
+ # role: roles/viewer
+ #
+ #
# For a description of IAM and its features, see the
- # [IAM developer's guide](https://cloud.google.com/iam).
+ # [IAM developer's guide](https://cloud.google.com/iam/docs).
"auditConfigs": [ # Specifies cloud audit logging configuration for this policy.
{ # Specifies the audit configuration for a service.
# The configuration determines which permission types are logged, and what
@@ -281,7 +349,7 @@
# If there are AuditConfigs for both `allServices` and a specific service,
# the union of the two AuditConfigs is used for that service: the log_types
# specified in each AuditConfig are enabled, and the exempted_members in each
- # AuditConfig are exempted.
+ # AuditLogConfig are exempted.
#
# Example Policy with multiple AuditConfigs:
#
@@ -324,11 +392,7 @@
# For fooservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
# logging. It also exempts foo@gmail.com from DATA_READ logging, and
# bar@gmail.com from DATA_WRITE logging.
- "exemptedMembers": [
- "A String",
- ],
"auditLogConfigs": [ # The configuration for logging of each type of permission.
- # Next ID: 4
{ # Provides the configuration for logging a type of permissions.
# Example:
#
@@ -361,61 +425,58 @@
# `allServices` is a special value that covers all services.
},
],
- "version": 42, # Version of the `Policy`. The default version is 0.
- "rules": [ # If more than one rule is specified, the rules are applied in the following
- # manner:
- # - All matching LOG rules are always applied.
- # - If any DENY/DENY_WITH_LOG rule matches, permission is denied.
- # Logging will be applied if one or more matching rule requires logging.
- # - Otherwise, if any ALLOW/ALLOW_WITH_LOG rule matches, permission is
- # granted.
- # Logging will be applied if one or more matching rule requires logging.
- # - Otherwise, if no rule applies, permission is denied.
- { # A rule to be applied in a Policy.
- "notIn": [ # If one or more 'not_in' clauses are specified, the rule matches
- # if the PRINCIPAL/AUTHORITY_SELECTOR is in none of the entries.
- # The format for in and not_in entries is the same as for members in a
- # Binding (see google/iam/v1/policy.proto).
+ "version": 42, # Deprecated.
+ "bindings": [ # Associates a list of `members` to a `role`.
+ # `bindings` with no members will result in an error.
+ { # Associates `members` with a `role`.
+ "role": "A String", # Role that is assigned to `members`.
+ # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+ "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
+ # `members` can have the following values:
+ #
+ # * `allUsers`: A special identifier that represents anyone who is
+ # on the internet; with or without a Google account.
+ #
+ # * `allAuthenticatedUsers`: A special identifier that represents anyone
+ # who is authenticated with a Google account or a service account.
+ #
+ # * `user:{emailid}`: An email address that represents a specific Google
+ # account. For example, `alice@gmail.com` .
+ #
+ #
+ # * `serviceAccount:{emailid}`: An email address that represents a service
+ # account. For example, `my-other-app@appspot.gserviceaccount.com`.
+ #
+ # * `group:{emailid}`: An email address that represents a Google group.
+ # For example, `admins@example.com`.
+ #
+ #
+ # * `domain:{domain}`: The G Suite domain (primary) that represents all the
+ # users of that domain. For example, `google.com` or `example.com`.
+ #
"A String",
],
- "description": "A String", # Human-readable description of the rule.
- "in": [ # If one or more 'in' clauses are specified, the rule matches if
- # the PRINCIPAL/AUTHORITY_SELECTOR is in at least one of these entries.
- "A String",
- ],
- "action": "A String", # Required
- "conditions": [ # Additional restrictions that must be met
- { # A condition to be met.
- "iam": "A String", # Trusted attributes supplied by the IAM system.
- "svc": "A String", # Trusted attributes discharged by the service.
- "value": "A String", # DEPRECATED. Use 'values' instead.
- "sys": "A String", # Trusted attributes supplied by any service that owns resources and uses
- # the IAM system for access control.
- "values": [ # The objects of the condition. This is mutually exclusive with 'value'.
- "A String",
- ],
- "op": "A String", # An operator to apply the subject with.
- },
- ],
- "logConfig": [ # The config returned to callers of tech.iam.IAM.CheckPolicy for any entries
- # that match the LOG action.
- { # Specifies what kind of log the caller must write
- "counter": { # Options for counters # Counter options.
- "field": "A String", # The field value to attribute.
- "metric": "A String", # The metric to update.
- },
- "dataAccess": { # Write a Data Access (Gin) log # Data access options.
- },
- "cloudAudit": { # Write a Cloud Audit log # Cloud audit options.
- "logName": "A String", # The log_name to populate in the Cloud Audit Record.
- },
- },
- ],
- "permissions": [ # A permission is a string of form '<service>.<resource type>.<verb>'
- # (e.g., 'storage.buckets.list'). A value of '*' matches all permissions,
- # and a verb part of '*' (e.g., 'storage.buckets.*') matches all verbs.
- "A String",
- ],
+ "condition": { # Represents an expression text. Example: # The condition that is associated with this binding.
+ # NOTE: An unsatisfied condition will not allow user access via current
+ # binding. Different bindings, including their conditions, are examined
+ # independently.
+ #
+ # title: "User account presence"
+ # description: "Determines whether the request has a user account"
+ # expression: "size(request.user) > 0"
+ "location": "A String", # An optional string indicating the location of the expression for error
+ # reporting, e.g. a file name and a position in the file.
+ "expression": "A String", # Textual representation of an expression in
+ # Common Expression Language syntax.
+ #
+ # The application context of the containing message determines which
+ # well-known feature set of CEL is supported.
+ "description": "A String", # An optional description of the expression. This is a longer text which
+ # describes the expression, e.g. when hovered over it in a UI.
+ "title": "A String", # An optional title for the expression, i.e. a short string describing
+ # its purpose. This can be used e.g. in UIs which allow to enter the
+ # expression.
+ },
},
],
"etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
@@ -428,41 +489,6 @@
#
# If no `etag` is provided in the call to `setIamPolicy`, then the existing
# policy is overwritten blindly.
- "bindings": [ # Associates a list of `members` to a `role`.
- # Multiple `bindings` must not be specified for the same `role`.
- # `bindings` with no members will result in an error.
- { # Associates `members` with a `role`.
- "role": "A String", # Role that is assigned to `members`.
- # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
- # Required
- "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
- # `members` can have the following values:
- #
- # * `allUsers`: A special identifier that represents anyone who is
- # on the internet; with or without a Google account.
- #
- # * `allAuthenticatedUsers`: A special identifier that represents anyone
- # who is authenticated with a Google account or a service account.
- #
- # * `user:{emailid}`: An email address that represents a specific Google
- # account. For example, `alice@gmail.com` or `joe@example.com`.
- #
- #
- # * `serviceAccount:{emailid}`: An email address that represents a service
- # account. For example, `my-other-app@appspot.gserviceaccount.com`.
- #
- # * `group:{emailid}`: An email address that represents a Google group.
- # For example, `admins@example.com`.
- #
- #
- # * `domain:{domain}`: A Google Apps domain name that represents all the
- # users of that domain. For example, `google.com` or `example.com`.
- #
- "A String",
- ],
- },
- ],
- "iamOwned": True or False,
}</pre>
</div>
@@ -494,16 +520,32 @@
"repos": [ # The listed repos.
{ # A repository (or repo) is a Git repository storing versioned source content.
"url": "A String", # URL to clone the repository from Google Cloud Source Repositories.
- "size": "A String", # The disk usage of the repo, in bytes.
- # Only returned by GetRepo.
+ # Read-only field.
+ "pubsubConfigs": { # How this repository publishes a change in the repository through Cloud
+ # Pub/Sub. Keyed by the topic names.
+ "a_key": { # Configuration to publish a Cloud Pub/Sub message.
+ "topic": "A String", # A topic of Cloud Pub/Sub. Values are of the form
+ # `projects/<project>/topics/<topic>`. The project needs to be the same
+ # project as this config is in.
+ "messageFormat": "A String", # The format of the Cloud Pub/Sub messages.
+ "serviceAccountEmail": "A String", # Email address of the service account used for publishing Cloud Pub/Sub
+ # messages. This service account needs to be in the same project as the
+ # PubsubConfig. When added, the caller needs to have
+ # iam.serviceAccounts.actAs permission on this service account. If
+ # unspecified, it defaults to the compute engine default service account.
+ },
+ },
+ "size": "A String", # The disk usage of the repo, in bytes. Read-only field. Size is only
+ # returned by GetRepo.
"name": "A String", # Resource name of the repository, of the form
# `projects/<project>/repos/<repo>`. The repo name may contain slashes.
# eg, `projects/myproject/repos/name/with/slash`
"mirrorConfig": { # Configuration to automatically mirror a repository from another # How this repository mirrors a repository managed by another service.
- # hosting service, for example GitHub or BitBucket.
+ # Read-only field.
+ # hosting service, for example GitHub or Bitbucket.
"url": "A String", # URL of the main repository at the other hosting service.
"webhookId": "A String", # ID of the webhook listening to updates to trigger mirroring.
- # Removing this webook from the other hosting service will stop
+ # Removing this webhook from the other hosting service will stop
# Google Cloud Source Repositories from receiving notifications,
# and thereby disabling mirroring.
"deployKeyId": "A String", # ID of the SSH deploy key at the other hosting service.
@@ -530,6 +572,102 @@
</div>
<div class="method">
+ <code class="details" id="patch">patch(name, body, x__xgafv=None)</code>
+ <pre>Updates information about a repo.
+
+Args:
+ name: string, The name of the requested repository. Values are of the form
+`projects/<project>/repos/<repo>`. (required)
+ body: object, The request body. (required)
+ The object takes the form of:
+
+{ # Request for UpdateRepo.
+ "repo": { # A repository (or repo) is a Git repository storing versioned source content. # The new configuration for the repository.
+ "url": "A String", # URL to clone the repository from Google Cloud Source Repositories.
+ # Read-only field.
+ "pubsubConfigs": { # How this repository publishes a change in the repository through Cloud
+ # Pub/Sub. Keyed by the topic names.
+ "a_key": { # Configuration to publish a Cloud Pub/Sub message.
+ "topic": "A String", # A topic of Cloud Pub/Sub. Values are of the form
+ # `projects/<project>/topics/<topic>`. The project needs to be the same
+ # project as this config is in.
+ "messageFormat": "A String", # The format of the Cloud Pub/Sub messages.
+ "serviceAccountEmail": "A String", # Email address of the service account used for publishing Cloud Pub/Sub
+ # messages. This service account needs to be in the same project as the
+ # PubsubConfig. When added, the caller needs to have
+ # iam.serviceAccounts.actAs permission on this service account. If
+ # unspecified, it defaults to the compute engine default service account.
+ },
+ },
+ "size": "A String", # The disk usage of the repo, in bytes. Read-only field. Size is only
+ # returned by GetRepo.
+ "name": "A String", # Resource name of the repository, of the form
+ # `projects/<project>/repos/<repo>`. The repo name may contain slashes.
+ # eg, `projects/myproject/repos/name/with/slash`
+ "mirrorConfig": { # Configuration to automatically mirror a repository from another # How this repository mirrors a repository managed by another service.
+ # Read-only field.
+ # hosting service, for example GitHub or Bitbucket.
+ "url": "A String", # URL of the main repository at the other hosting service.
+ "webhookId": "A String", # ID of the webhook listening to updates to trigger mirroring.
+ # Removing this webhook from the other hosting service will stop
+ # Google Cloud Source Repositories from receiving notifications,
+ # and thereby disabling mirroring.
+ "deployKeyId": "A String", # ID of the SSH deploy key at the other hosting service.
+ # Removing this key from the other service would deauthorize
+ # Google Cloud Source Repositories from mirroring.
+ },
+ },
+ "updateMask": "A String", # A FieldMask specifying which fields of the repo to modify. Only the fields
+ # in the mask will be modified. If no mask is provided, this request is
+ # no-op.
+ }
+
+ x__xgafv: string, V1 error format.
+ Allowed values
+ 1 - v1 error format
+ 2 - v2 error format
+
+Returns:
+ An object of the form:
+
+ { # A repository (or repo) is a Git repository storing versioned source content.
+ "url": "A String", # URL to clone the repository from Google Cloud Source Repositories.
+ # Read-only field.
+ "pubsubConfigs": { # How this repository publishes a change in the repository through Cloud
+ # Pub/Sub. Keyed by the topic names.
+ "a_key": { # Configuration to publish a Cloud Pub/Sub message.
+ "topic": "A String", # A topic of Cloud Pub/Sub. Values are of the form
+ # `projects/<project>/topics/<topic>`. The project needs to be the same
+ # project as this config is in.
+ "messageFormat": "A String", # The format of the Cloud Pub/Sub messages.
+ "serviceAccountEmail": "A String", # Email address of the service account used for publishing Cloud Pub/Sub
+ # messages. This service account needs to be in the same project as the
+ # PubsubConfig. When added, the caller needs to have
+ # iam.serviceAccounts.actAs permission on this service account. If
+ # unspecified, it defaults to the compute engine default service account.
+ },
+ },
+ "size": "A String", # The disk usage of the repo, in bytes. Read-only field. Size is only
+ # returned by GetRepo.
+ "name": "A String", # Resource name of the repository, of the form
+ # `projects/<project>/repos/<repo>`. The repo name may contain slashes.
+ # eg, `projects/myproject/repos/name/with/slash`
+ "mirrorConfig": { # Configuration to automatically mirror a repository from another # How this repository mirrors a repository managed by another service.
+ # Read-only field.
+ # hosting service, for example GitHub or Bitbucket.
+ "url": "A String", # URL of the main repository at the other hosting service.
+ "webhookId": "A String", # ID of the webhook listening to updates to trigger mirroring.
+ # Removing this webhook from the other hosting service will stop
+ # Google Cloud Source Repositories from receiving notifications,
+ # and thereby disabling mirroring.
+ "deployKeyId": "A String", # ID of the SSH deploy key at the other hosting service.
+ # Removing this key from the other service would deauthorize
+ # Google Cloud Source Repositories from mirroring.
+ },
+ }</pre>
+</div>
+
+<div class="method">
<code class="details" id="setIamPolicy">setIamPolicy(resource, body, x__xgafv=None)</code>
<pre>Sets the access control policy on the specified resource. Replaces any
existing policy.
@@ -548,12 +686,12 @@
# specify access control policies for Cloud Platform resources.
#
#
- # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+ # A `Policy` consists of a list of `bindings`. A `binding` binds a list of
# `members` to a `role`, where the members can be user accounts, Google groups,
# Google domains, and service accounts. A `role` is a named list of permissions
# defined by IAM.
#
- # **Example**
+ # **JSON Example**
#
# {
# "bindings": [
@@ -563,7 +701,7 @@
# "user:mike@example.com",
# "group:admins@example.com",
# "domain:google.com",
- # "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+ # "serviceAccount:my-other-app@appspot.gserviceaccount.com"
# ]
# },
# {
@@ -573,8 +711,22 @@
# ]
# }
#
+ # **YAML Example**
+ #
+ # bindings:
+ # - members:
+ # - user:mike@example.com
+ # - group:admins@example.com
+ # - domain:google.com
+ # - serviceAccount:my-other-app@appspot.gserviceaccount.com
+ # role: roles/owner
+ # - members:
+ # - user:sean@example.com
+ # role: roles/viewer
+ #
+ #
# For a description of IAM and its features, see the
- # [IAM developer's guide](https://cloud.google.com/iam).
+ # [IAM developer's guide](https://cloud.google.com/iam/docs).
"auditConfigs": [ # Specifies cloud audit logging configuration for this policy.
{ # Specifies the audit configuration for a service.
# The configuration determines which permission types are logged, and what
@@ -584,7 +736,7 @@
# If there are AuditConfigs for both `allServices` and a specific service,
# the union of the two AuditConfigs is used for that service: the log_types
# specified in each AuditConfig are enabled, and the exempted_members in each
- # AuditConfig are exempted.
+ # AuditLogConfig are exempted.
#
# Example Policy with multiple AuditConfigs:
#
@@ -627,11 +779,7 @@
# For fooservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
# logging. It also exempts foo@gmail.com from DATA_READ logging, and
# bar@gmail.com from DATA_WRITE logging.
- "exemptedMembers": [
- "A String",
- ],
"auditLogConfigs": [ # The configuration for logging of each type of permission.
- # Next ID: 4
{ # Provides the configuration for logging a type of permissions.
# Example:
#
@@ -664,61 +812,58 @@
# `allServices` is a special value that covers all services.
},
],
- "version": 42, # Version of the `Policy`. The default version is 0.
- "rules": [ # If more than one rule is specified, the rules are applied in the following
- # manner:
- # - All matching LOG rules are always applied.
- # - If any DENY/DENY_WITH_LOG rule matches, permission is denied.
- # Logging will be applied if one or more matching rule requires logging.
- # - Otherwise, if any ALLOW/ALLOW_WITH_LOG rule matches, permission is
- # granted.
- # Logging will be applied if one or more matching rule requires logging.
- # - Otherwise, if no rule applies, permission is denied.
- { # A rule to be applied in a Policy.
- "notIn": [ # If one or more 'not_in' clauses are specified, the rule matches
- # if the PRINCIPAL/AUTHORITY_SELECTOR is in none of the entries.
- # The format for in and not_in entries is the same as for members in a
- # Binding (see google/iam/v1/policy.proto).
+ "version": 42, # Deprecated.
+ "bindings": [ # Associates a list of `members` to a `role`.
+ # `bindings` with no members will result in an error.
+ { # Associates `members` with a `role`.
+ "role": "A String", # Role that is assigned to `members`.
+ # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+ "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
+ # `members` can have the following values:
+ #
+ # * `allUsers`: A special identifier that represents anyone who is
+ # on the internet; with or without a Google account.
+ #
+ # * `allAuthenticatedUsers`: A special identifier that represents anyone
+ # who is authenticated with a Google account or a service account.
+ #
+ # * `user:{emailid}`: An email address that represents a specific Google
+ # account. For example, `alice@gmail.com` .
+ #
+ #
+ # * `serviceAccount:{emailid}`: An email address that represents a service
+ # account. For example, `my-other-app@appspot.gserviceaccount.com`.
+ #
+ # * `group:{emailid}`: An email address that represents a Google group.
+ # For example, `admins@example.com`.
+ #
+ #
+ # * `domain:{domain}`: The G Suite domain (primary) that represents all the
+ # users of that domain. For example, `google.com` or `example.com`.
+ #
"A String",
],
- "description": "A String", # Human-readable description of the rule.
- "in": [ # If one or more 'in' clauses are specified, the rule matches if
- # the PRINCIPAL/AUTHORITY_SELECTOR is in at least one of these entries.
- "A String",
- ],
- "action": "A String", # Required
- "conditions": [ # Additional restrictions that must be met
- { # A condition to be met.
- "iam": "A String", # Trusted attributes supplied by the IAM system.
- "svc": "A String", # Trusted attributes discharged by the service.
- "value": "A String", # DEPRECATED. Use 'values' instead.
- "sys": "A String", # Trusted attributes supplied by any service that owns resources and uses
- # the IAM system for access control.
- "values": [ # The objects of the condition. This is mutually exclusive with 'value'.
- "A String",
- ],
- "op": "A String", # An operator to apply the subject with.
- },
- ],
- "logConfig": [ # The config returned to callers of tech.iam.IAM.CheckPolicy for any entries
- # that match the LOG action.
- { # Specifies what kind of log the caller must write
- "counter": { # Options for counters # Counter options.
- "field": "A String", # The field value to attribute.
- "metric": "A String", # The metric to update.
- },
- "dataAccess": { # Write a Data Access (Gin) log # Data access options.
- },
- "cloudAudit": { # Write a Cloud Audit log # Cloud audit options.
- "logName": "A String", # The log_name to populate in the Cloud Audit Record.
- },
- },
- ],
- "permissions": [ # A permission is a string of form '<service>.<resource type>.<verb>'
- # (e.g., 'storage.buckets.list'). A value of '*' matches all permissions,
- # and a verb part of '*' (e.g., 'storage.buckets.*') matches all verbs.
- "A String",
- ],
+ "condition": { # Represents an expression text. Example: # The condition that is associated with this binding.
+ # NOTE: An unsatisfied condition will not allow user access via current
+ # binding. Different bindings, including their conditions, are examined
+ # independently.
+ #
+ # title: "User account presence"
+ # description: "Determines whether the request has a user account"
+ # expression: "size(request.user) > 0"
+ "location": "A String", # An optional string indicating the location of the expression for error
+ # reporting, e.g. a file name and a position in the file.
+ "expression": "A String", # Textual representation of an expression in
+ # Common Expression Language syntax.
+ #
+ # The application context of the containing message determines which
+ # well-known feature set of CEL is supported.
+ "description": "A String", # An optional description of the expression. This is a longer text which
+ # describes the expression, e.g. when hovered over it in a UI.
+ "title": "A String", # An optional title for the expression, i.e. a short string describing
+ # its purpose. This can be used e.g. in UIs which allow to enter the
+ # expression.
+ },
},
],
"etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
@@ -731,41 +876,6 @@
#
# If no `etag` is provided in the call to `setIamPolicy`, then the existing
# policy is overwritten blindly.
- "bindings": [ # Associates a list of `members` to a `role`.
- # Multiple `bindings` must not be specified for the same `role`.
- # `bindings` with no members will result in an error.
- { # Associates `members` with a `role`.
- "role": "A String", # Role that is assigned to `members`.
- # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
- # Required
- "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
- # `members` can have the following values:
- #
- # * `allUsers`: A special identifier that represents anyone who is
- # on the internet; with or without a Google account.
- #
- # * `allAuthenticatedUsers`: A special identifier that represents anyone
- # who is authenticated with a Google account or a service account.
- #
- # * `user:{emailid}`: An email address that represents a specific Google
- # account. For example, `alice@gmail.com` or `joe@example.com`.
- #
- #
- # * `serviceAccount:{emailid}`: An email address that represents a service
- # account. For example, `my-other-app@appspot.gserviceaccount.com`.
- #
- # * `group:{emailid}`: An email address that represents a Google group.
- # For example, `admins@example.com`.
- #
- #
- # * `domain:{domain}`: A Google Apps domain name that represents all the
- # users of that domain. For example, `google.com` or `example.com`.
- #
- "A String",
- ],
- },
- ],
- "iamOwned": True or False,
},
"updateMask": "A String", # OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only
# the fields in the mask will be modified. If no mask is provided, the
@@ -786,12 +896,12 @@
# specify access control policies for Cloud Platform resources.
#
#
- # A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+ # A `Policy` consists of a list of `bindings`. A `binding` binds a list of
# `members` to a `role`, where the members can be user accounts, Google groups,
# Google domains, and service accounts. A `role` is a named list of permissions
# defined by IAM.
#
- # **Example**
+ # **JSON Example**
#
# {
# "bindings": [
@@ -801,7 +911,7 @@
# "user:mike@example.com",
# "group:admins@example.com",
# "domain:google.com",
- # "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+ # "serviceAccount:my-other-app@appspot.gserviceaccount.com"
# ]
# },
# {
@@ -811,8 +921,22 @@
# ]
# }
#
+ # **YAML Example**
+ #
+ # bindings:
+ # - members:
+ # - user:mike@example.com
+ # - group:admins@example.com
+ # - domain:google.com
+ # - serviceAccount:my-other-app@appspot.gserviceaccount.com
+ # role: roles/owner
+ # - members:
+ # - user:sean@example.com
+ # role: roles/viewer
+ #
+ #
# For a description of IAM and its features, see the
- # [IAM developer's guide](https://cloud.google.com/iam).
+ # [IAM developer's guide](https://cloud.google.com/iam/docs).
"auditConfigs": [ # Specifies cloud audit logging configuration for this policy.
{ # Specifies the audit configuration for a service.
# The configuration determines which permission types are logged, and what
@@ -822,7 +946,7 @@
# If there are AuditConfigs for both `allServices` and a specific service,
# the union of the two AuditConfigs is used for that service: the log_types
# specified in each AuditConfig are enabled, and the exempted_members in each
- # AuditConfig are exempted.
+ # AuditLogConfig are exempted.
#
# Example Policy with multiple AuditConfigs:
#
@@ -865,11 +989,7 @@
# For fooservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
# logging. It also exempts foo@gmail.com from DATA_READ logging, and
# bar@gmail.com from DATA_WRITE logging.
- "exemptedMembers": [
- "A String",
- ],
"auditLogConfigs": [ # The configuration for logging of each type of permission.
- # Next ID: 4
{ # Provides the configuration for logging a type of permissions.
# Example:
#
@@ -902,61 +1022,58 @@
# `allServices` is a special value that covers all services.
},
],
- "version": 42, # Version of the `Policy`. The default version is 0.
- "rules": [ # If more than one rule is specified, the rules are applied in the following
- # manner:
- # - All matching LOG rules are always applied.
- # - If any DENY/DENY_WITH_LOG rule matches, permission is denied.
- # Logging will be applied if one or more matching rule requires logging.
- # - Otherwise, if any ALLOW/ALLOW_WITH_LOG rule matches, permission is
- # granted.
- # Logging will be applied if one or more matching rule requires logging.
- # - Otherwise, if no rule applies, permission is denied.
- { # A rule to be applied in a Policy.
- "notIn": [ # If one or more 'not_in' clauses are specified, the rule matches
- # if the PRINCIPAL/AUTHORITY_SELECTOR is in none of the entries.
- # The format for in and not_in entries is the same as for members in a
- # Binding (see google/iam/v1/policy.proto).
+ "version": 42, # Deprecated.
+ "bindings": [ # Associates a list of `members` to a `role`.
+ # `bindings` with no members will result in an error.
+ { # Associates `members` with a `role`.
+ "role": "A String", # Role that is assigned to `members`.
+ # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+ "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
+ # `members` can have the following values:
+ #
+ # * `allUsers`: A special identifier that represents anyone who is
+ # on the internet; with or without a Google account.
+ #
+ # * `allAuthenticatedUsers`: A special identifier that represents anyone
+ # who is authenticated with a Google account or a service account.
+ #
+ # * `user:{emailid}`: An email address that represents a specific Google
+ # account. For example, `alice@gmail.com` .
+ #
+ #
+ # * `serviceAccount:{emailid}`: An email address that represents a service
+ # account. For example, `my-other-app@appspot.gserviceaccount.com`.
+ #
+ # * `group:{emailid}`: An email address that represents a Google group.
+ # For example, `admins@example.com`.
+ #
+ #
+ # * `domain:{domain}`: The G Suite domain (primary) that represents all the
+ # users of that domain. For example, `google.com` or `example.com`.
+ #
"A String",
],
- "description": "A String", # Human-readable description of the rule.
- "in": [ # If one or more 'in' clauses are specified, the rule matches if
- # the PRINCIPAL/AUTHORITY_SELECTOR is in at least one of these entries.
- "A String",
- ],
- "action": "A String", # Required
- "conditions": [ # Additional restrictions that must be met
- { # A condition to be met.
- "iam": "A String", # Trusted attributes supplied by the IAM system.
- "svc": "A String", # Trusted attributes discharged by the service.
- "value": "A String", # DEPRECATED. Use 'values' instead.
- "sys": "A String", # Trusted attributes supplied by any service that owns resources and uses
- # the IAM system for access control.
- "values": [ # The objects of the condition. This is mutually exclusive with 'value'.
- "A String",
- ],
- "op": "A String", # An operator to apply the subject with.
- },
- ],
- "logConfig": [ # The config returned to callers of tech.iam.IAM.CheckPolicy for any entries
- # that match the LOG action.
- { # Specifies what kind of log the caller must write
- "counter": { # Options for counters # Counter options.
- "field": "A String", # The field value to attribute.
- "metric": "A String", # The metric to update.
- },
- "dataAccess": { # Write a Data Access (Gin) log # Data access options.
- },
- "cloudAudit": { # Write a Cloud Audit log # Cloud audit options.
- "logName": "A String", # The log_name to populate in the Cloud Audit Record.
- },
- },
- ],
- "permissions": [ # A permission is a string of form '<service>.<resource type>.<verb>'
- # (e.g., 'storage.buckets.list'). A value of '*' matches all permissions,
- # and a verb part of '*' (e.g., 'storage.buckets.*') matches all verbs.
- "A String",
- ],
+ "condition": { # Represents an expression text. Example: # The condition that is associated with this binding.
+ # NOTE: An unsatisfied condition will not allow user access via current
+ # binding. Different bindings, including their conditions, are examined
+ # independently.
+ #
+ # title: "User account presence"
+ # description: "Determines whether the request has a user account"
+ # expression: "size(request.user) > 0"
+ "location": "A String", # An optional string indicating the location of the expression for error
+ # reporting, e.g. a file name and a position in the file.
+ "expression": "A String", # Textual representation of an expression in
+ # Common Expression Language syntax.
+ #
+ # The application context of the containing message determines which
+ # well-known feature set of CEL is supported.
+ "description": "A String", # An optional description of the expression. This is a longer text which
+ # describes the expression, e.g. when hovered over it in a UI.
+ "title": "A String", # An optional title for the expression, i.e. a short string describing
+ # its purpose. This can be used e.g. in UIs which allow to enter the
+ # expression.
+ },
},
],
"etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
@@ -969,41 +1086,119 @@
#
# If no `etag` is provided in the call to `setIamPolicy`, then the existing
# policy is overwritten blindly.
- "bindings": [ # Associates a list of `members` to a `role`.
- # Multiple `bindings` must not be specified for the same `role`.
- # `bindings` with no members will result in an error.
- { # Associates `members` with a `role`.
- "role": "A String", # Role that is assigned to `members`.
- # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
- # Required
- "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
- # `members` can have the following values:
- #
- # * `allUsers`: A special identifier that represents anyone who is
- # on the internet; with or without a Google account.
- #
- # * `allAuthenticatedUsers`: A special identifier that represents anyone
- # who is authenticated with a Google account or a service account.
- #
- # * `user:{emailid}`: An email address that represents a specific Google
- # account. For example, `alice@gmail.com` or `joe@example.com`.
- #
- #
- # * `serviceAccount:{emailid}`: An email address that represents a service
- # account. For example, `my-other-app@appspot.gserviceaccount.com`.
- #
- # * `group:{emailid}`: An email address that represents a Google group.
- # For example, `admins@example.com`.
- #
- #
- # * `domain:{domain}`: A Google Apps domain name that represents all the
- # users of that domain. For example, `google.com` or `example.com`.
- #
- "A String",
- ],
- },
- ],
- "iamOwned": True or False,
+ }</pre>
+</div>
+
+<div class="method">
+ <code class="details" id="sync">sync(name, body=None, x__xgafv=None)</code>
+ <pre>Synchronize a connected repo.
+
+The response contains SyncRepoMetadata in the metadata field.
+
+Args:
+ name: string, The name of the repo to synchronize. Values are of the form
+`projects/<project>/repos/<repo>`. (required)
+ body: object, The request body.
+ The object takes the form of:
+
+{ # Request for SyncRepo.
+ }
+
+ x__xgafv: string, V1 error format.
+ Allowed values
+ 1 - v1 error format
+ 2 - v2 error format
+
+Returns:
+ An object of the form:
+
+ { # This resource represents a long-running operation that is the result of a
+ # network API call.
+ "response": { # The normal response of the operation in case of success. If the original
+ # method returns no data on success, such as `Delete`, the response is
+ # `google.protobuf.Empty`. If the original method is standard
+ # `Get`/`Create`/`Update`, the response should be the resource. For other
+ # methods, the response should have the type `XxxResponse`, where `Xxx`
+ # is the original method name. For example, if the original method name
+ # is `TakeSnapshot()`, the inferred response type is
+ # `TakeSnapshotResponse`.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "metadata": { # Service-specific metadata associated with the operation. It typically
+ # contains progress information and common metadata such as create time.
+ # Some services might not provide such metadata. Any method that returns a
+ # long-running operation should document the metadata type, if any.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "done": True or False, # If the value is `false`, it means the operation is still in progress.
+ # If `true`, the operation is completed, and either `error` or `response` is
+ # available.
+ "name": "A String", # The server-assigned name, which is only unique within the same service that
+ # originally returns it. If you use the default HTTP mapping, the
+ # `name` should have the format of `operations/some/unique/name`.
+ "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.
+ # different programming environments, including REST APIs and RPC APIs. It is
+ # used by [gRPC](https://github.com/grpc). The error model is designed to be:
+ #
+ # - Simple to use and understand for most users
+ # - Flexible enough to meet unexpected needs
+ #
+ # # Overview
+ #
+ # The `Status` message contains three pieces of data: error code, error
+ # message, and error details. The error code should be an enum value of
+ # google.rpc.Code, but it may accept additional error codes if needed. The
+ # error message should be a developer-facing English message that helps
+ # developers *understand* and *resolve* the error. If a localized user-facing
+ # error message is needed, put the localized message in the error details or
+ # localize it in the client. The optional error details may contain arbitrary
+ # information about the error. There is a predefined set of error detail types
+ # in the package `google.rpc` that can be used for common error conditions.
+ #
+ # # Language mapping
+ #
+ # The `Status` message is the logical representation of the error model, but it
+ # is not necessarily the actual wire format. When the `Status` message is
+ # exposed in different client libraries and different wire protocols, it can be
+ # mapped differently. For example, it will likely be mapped to some exceptions
+ # in Java, but more likely mapped to some error codes in C.
+ #
+ # # Other uses
+ #
+ # The error model and the `Status` message can be used in a variety of
+ # environments, either with or without APIs, to provide a
+ # consistent developer experience across different environments.
+ #
+ # Example uses of this error model include:
+ #
+ # - Partial errors. If a service needs to return partial errors to the client,
+ # it may embed the `Status` in the normal response to indicate the partial
+ # errors.
+ #
+ # - Workflow errors. A typical workflow has multiple steps. Each step may
+ # have a `Status` message for error reporting.
+ #
+ # - Batch operations. If a client uses batch request and batch response, the
+ # `Status` message should be used directly inside batch response, one for
+ # each error sub-response.
+ #
+ # - Asynchronous operations. If an API call embeds asynchronous operation
+ # results in its response, the status of those operations should be
+ # represented directly using the `Status` message.
+ #
+ # - Logging. If some API errors are stored in logs, the message `Status` could
+ # be used directly after any stripping needed for security/privacy reasons.
+ "message": "A String", # A developer-facing error message, which should be in English. Any
+ # user-facing error message should be localized and sent in the
+ # google.rpc.Status.details field, or localized by the client.
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "details": [ # A list of messages that carry the error details. There is a common set of
+ # message types for APIs to use.
+ {
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ ],
+ },
}</pre>
</div>