Fix method doc signatures for multiline required parameters (#374)
* Fix method doc signatures for multiline required parameters.
Existing doc generator failed to recognize parameters as required when parameter descriptions
extended over more than one line. Besides presenting incorrect information, resulting
inconsistencies broke checks for automated sample generation.
* Regen docs
diff --git a/docs/dyn/cloudresourcemanager_v1.projects.html b/docs/dyn/cloudresourcemanager_v1.projects.html
index 661a574..4c490e5 100644
--- a/docs/dyn/cloudresourcemanager_v1.projects.html
+++ b/docs/dyn/cloudresourcemanager_v1.projects.html
@@ -84,13 +84,13 @@
<code><a href="#create">create(body, x__xgafv=None)</a></code></p>
<p class="firstline">Request that a new Project be created. The result is an Operation which</p>
<p class="toc_element">
- <code><a href="#delete">delete(projectId=None, x__xgafv=None)</a></code></p>
+ <code><a href="#delete">delete(projectId, x__xgafv=None)</a></code></p>
<p class="firstline">Marks the Project identified by the specified</p>
<p class="toc_element">
- <code><a href="#get">get(projectId=None, x__xgafv=None)</a></code></p>
+ <code><a href="#get">get(projectId, x__xgafv=None)</a></code></p>
<p class="firstline">Retrieves the Project identified by the specified</p>
<p class="toc_element">
- <code><a href="#getAncestry">getAncestry(projectId=None, body, x__xgafv=None)</a></code></p>
+ <code><a href="#getAncestry">getAncestry(projectId, body, x__xgafv=None)</a></code></p>
<p class="firstline">Gets a list of ancestors in the resource hierarchy for the Project</p>
<p class="toc_element">
<code><a href="#getEffectiveOrgPolicy">getEffectiveOrgPolicy(resource, body, x__xgafv=None)</a></code></p>
@@ -99,7 +99,7 @@
<code><a href="#getEffectiveOrgPolicyV1">getEffectiveOrgPolicyV1(resource, body, x__xgafv=None)</a></code></p>
<p class="firstline">Gets the effective `Policy` on a resource. This is the result of merging</p>
<p class="toc_element">
- <code><a href="#getIamPolicy">getIamPolicy(resource=None, body, x__xgafv=None)</a></code></p>
+ <code><a href="#getIamPolicy">getIamPolicy(resource, body, x__xgafv=None)</a></code></p>
<p class="firstline">Returns the IAM access control policy for the specified Project.</p>
<p class="toc_element">
<code><a href="#getOrgPolicy">getOrgPolicy(resource, body, x__xgafv=None)</a></code></p>
@@ -126,7 +126,7 @@
<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="#setIamPolicy">setIamPolicy(resource=None, body, x__xgafv=None)</a></code></p>
+ <code><a href="#setIamPolicy">setIamPolicy(resource, body, x__xgafv=None)</a></code></p>
<p class="firstline">Sets the IAM access control policy for the specified Project. Replaces</p>
<p class="toc_element">
<code><a href="#setOrgPolicy">setOrgPolicy(resource, body, x__xgafv=None)</a></code></p>
@@ -135,13 +135,13 @@
<code><a href="#setOrgPolicyV1">setOrgPolicyV1(resource, body, x__xgafv=None)</a></code></p>
<p class="firstline">Updates the specified `Policy` on the resource. Creates a new `Policy` for</p>
<p class="toc_element">
- <code><a href="#testIamPermissions">testIamPermissions(resource=None, body, x__xgafv=None)</a></code></p>
+ <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 Project.</p>
<p class="toc_element">
- <code><a href="#undelete">undelete(projectId=None, body, x__xgafv=None)</a></code></p>
+ <code><a href="#undelete">undelete(projectId, body, x__xgafv=None)</a></code></p>
<p class="firstline">Restores the Project identified by the specified</p>
<p class="toc_element">
- <code><a href="#update">update(projectId=None, body, x__xgafv=None)</a></code></p>
+ <code><a href="#update">update(projectId, body, x__xgafv=None)</a></code></p>
<p class="firstline">Updates the attributes of the Project identified by the specified</p>
<h3>Method Details</h3>
<div class="method">
@@ -230,66 +230,66 @@
The object takes the form of:
{ # A Project is a high-level Google Cloud Platform entity. It is a
- # container for ACLs, APIs, App Engine Apps, VMs, and other
- # Google Cloud Platform resources.
- "name": "A String", # The user-assigned display name of the Project.
- # It must be 4 to 30 characters.
- # Allowed characters are: lowercase and uppercase letters, numbers,
- # hyphen, single-quote, double-quote, space, and exclamation point.
- #
- # Example: <code>My Project</code>
- # Read-write.
- "parent": { # A container to reference an id for any resource type. A `resource` in Google # An optional reference to a parent Resource.
- #
- # The only supported parent type is "organization". Once set, the parent
- # cannot be modified. The `parent` can be set on creation or using the
- # `UpdateProject` method; the end user must have the
- # `resourcemanager.projects.create` permission on the parent.
- #
- # Read-write.
- # Cloud Platform is a generic term for something you (a developer) may want to
- # interact with through one of our API's. Some examples are an App Engine app,
- # a Compute Engine instance, a Cloud SQL database, and so on.
- "type": "A String", # Required field representing the resource type this id is for.
- # At present, the valid types are: "organization"
- "id": "A String", # Required field for the type-specific id. This should correspond to the id
- # used in the type-specific API's.
- },
- "projectId": "A String", # The unique, user-assigned ID of the Project.
- # It must be 6 to 30 lowercase letters, digits, or hyphens.
- # It must start with a letter.
- # Trailing hyphens are prohibited.
- #
- # Example: <code>tokyo-rain-123</code>
- # Read-only after creation.
- "labels": { # The labels associated with this Project.
- #
- # Label keys must be between 1 and 63 characters long and must conform
- # to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?.
- #
- # Label values must be between 0 and 63 characters long and must conform
- # to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?.
- #
- # No more than 256 labels can be associated with a given resource.
- #
- # Clients should store labels in a representation such as JSON that does not
- # depend on specific characters being disallowed.
- #
- # Example: <code>"environment" : "dev"</code>
- # Read-write.
- "a_key": "A String",
- },
- "projectNumber": "A String", # The number uniquely identifying the project.
- #
- # Example: <code>415104041262</code>
- # Read-only.
- "lifecycleState": "A String", # The Project lifecycle state.
- #
- # Read-only.
- "createTime": "A String", # Creation time.
- #
- # Read-only.
-}
+ # container for ACLs, APIs, App Engine Apps, VMs, and other
+ # Google Cloud Platform resources.
+ "name": "A String", # The user-assigned display name of the Project.
+ # It must be 4 to 30 characters.
+ # Allowed characters are: lowercase and uppercase letters, numbers,
+ # hyphen, single-quote, double-quote, space, and exclamation point.
+ #
+ # Example: <code>My Project</code>
+ # Read-write.
+ "parent": { # A container to reference an id for any resource type. A `resource` in Google # An optional reference to a parent Resource.
+ #
+ # The only supported parent type is "organization". Once set, the parent
+ # cannot be modified. The `parent` can be set on creation or using the
+ # `UpdateProject` method; the end user must have the
+ # `resourcemanager.projects.create` permission on the parent.
+ #
+ # Read-write.
+ # Cloud Platform is a generic term for something you (a developer) may want to
+ # interact with through one of our API's. Some examples are an App Engine app,
+ # a Compute Engine instance, a Cloud SQL database, and so on.
+ "type": "A String", # Required field representing the resource type this id is for.
+ # At present, the valid types are: "organization"
+ "id": "A String", # Required field for the type-specific id. This should correspond to the id
+ # used in the type-specific API's.
+ },
+ "projectId": "A String", # The unique, user-assigned ID of the Project.
+ # It must be 6 to 30 lowercase letters, digits, or hyphens.
+ # It must start with a letter.
+ # Trailing hyphens are prohibited.
+ #
+ # Example: <code>tokyo-rain-123</code>
+ # Read-only after creation.
+ "labels": { # The labels associated with this Project.
+ #
+ # Label keys must be between 1 and 63 characters long and must conform
+ # to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?.
+ #
+ # Label values must be between 0 and 63 characters long and must conform
+ # to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?.
+ #
+ # No more than 256 labels can be associated with a given resource.
+ #
+ # Clients should store labels in a representation such as JSON that does not
+ # depend on specific characters being disallowed.
+ #
+ # Example: <code>"environment" : "dev"</code>
+ # Read-write.
+ "a_key": "A String",
+ },
+ "projectNumber": "A String", # The number uniquely identifying the project.
+ #
+ # Example: <code>415104041262</code>
+ # Read-only.
+ "lifecycleState": "A String", # The Project lifecycle state.
+ #
+ # Read-only.
+ "createTime": "A String", # Creation time.
+ #
+ # Read-only.
+ }
x__xgafv: string, V1 error format.
Allowed values
@@ -307,22 +307,6 @@
# 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.
- "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.
- },
- "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 different # The error result of the operation in case of failure or cancellation.
# programming environments, including REST APIs and RPC APIs. It is used by
# [gRPC](https://github.com/grpc). The error model is designed to be:
@@ -386,11 +370,27 @@
},
],
},
+ "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.
+ "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.
+ },
+ "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`.
}</pre>
</div>
<div class="method">
- <code class="details" id="delete">delete(projectId=None, x__xgafv=None)</code>
+ <code class="details" id="delete">delete(projectId, x__xgafv=None)</code>
<pre>Marks the Project identified by the specified
`project_id` (for example, `my-project-123`) for deletion.
This method will only affect the Project if the following criteria are met:
@@ -441,7 +441,7 @@
</div>
<div class="method">
- <code class="details" id="get">get(projectId=None, x__xgafv=None)</code>
+ <code class="details" id="get">get(projectId, x__xgafv=None)</code>
<pre>Retrieves the Project identified by the specified
`project_id` (for example, `my-project-123`).
@@ -460,70 +460,70 @@
An object of the form:
{ # A Project is a high-level Google Cloud Platform entity. It is a
- # container for ACLs, APIs, App Engine Apps, VMs, and other
- # Google Cloud Platform resources.
- "name": "A String", # The user-assigned display name of the Project.
- # It must be 4 to 30 characters.
- # Allowed characters are: lowercase and uppercase letters, numbers,
- # hyphen, single-quote, double-quote, space, and exclamation point.
- #
- # Example: <code>My Project</code>
- # Read-write.
- "parent": { # A container to reference an id for any resource type. A `resource` in Google # An optional reference to a parent Resource.
- #
- # The only supported parent type is "organization". Once set, the parent
- # cannot be modified. The `parent` can be set on creation or using the
- # `UpdateProject` method; the end user must have the
- # `resourcemanager.projects.create` permission on the parent.
- #
- # Read-write.
- # Cloud Platform is a generic term for something you (a developer) may want to
- # interact with through one of our API's. Some examples are an App Engine app,
- # a Compute Engine instance, a Cloud SQL database, and so on.
- "type": "A String", # Required field representing the resource type this id is for.
- # At present, the valid types are: "organization"
- "id": "A String", # Required field for the type-specific id. This should correspond to the id
- # used in the type-specific API's.
- },
- "projectId": "A String", # The unique, user-assigned ID of the Project.
- # It must be 6 to 30 lowercase letters, digits, or hyphens.
- # It must start with a letter.
- # Trailing hyphens are prohibited.
- #
- # Example: <code>tokyo-rain-123</code>
- # Read-only after creation.
- "labels": { # The labels associated with this Project.
- #
- # Label keys must be between 1 and 63 characters long and must conform
- # to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?.
- #
- # Label values must be between 0 and 63 characters long and must conform
- # to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?.
- #
- # No more than 256 labels can be associated with a given resource.
- #
- # Clients should store labels in a representation such as JSON that does not
- # depend on specific characters being disallowed.
- #
- # Example: <code>"environment" : "dev"</code>
- # Read-write.
- "a_key": "A String",
- },
- "projectNumber": "A String", # The number uniquely identifying the project.
- #
- # Example: <code>415104041262</code>
- # Read-only.
- "lifecycleState": "A String", # The Project lifecycle state.
- #
- # Read-only.
- "createTime": "A String", # Creation time.
- #
- # Read-only.
- }</pre>
+ # container for ACLs, APIs, App Engine Apps, VMs, and other
+ # Google Cloud Platform resources.
+ "name": "A String", # The user-assigned display name of the Project.
+ # It must be 4 to 30 characters.
+ # Allowed characters are: lowercase and uppercase letters, numbers,
+ # hyphen, single-quote, double-quote, space, and exclamation point.
+ #
+ # Example: <code>My Project</code>
+ # Read-write.
+ "parent": { # A container to reference an id for any resource type. A `resource` in Google # An optional reference to a parent Resource.
+ #
+ # The only supported parent type is "organization". Once set, the parent
+ # cannot be modified. The `parent` can be set on creation or using the
+ # `UpdateProject` method; the end user must have the
+ # `resourcemanager.projects.create` permission on the parent.
+ #
+ # Read-write.
+ # Cloud Platform is a generic term for something you (a developer) may want to
+ # interact with through one of our API's. Some examples are an App Engine app,
+ # a Compute Engine instance, a Cloud SQL database, and so on.
+ "type": "A String", # Required field representing the resource type this id is for.
+ # At present, the valid types are: "organization"
+ "id": "A String", # Required field for the type-specific id. This should correspond to the id
+ # used in the type-specific API's.
+ },
+ "projectId": "A String", # The unique, user-assigned ID of the Project.
+ # It must be 6 to 30 lowercase letters, digits, or hyphens.
+ # It must start with a letter.
+ # Trailing hyphens are prohibited.
+ #
+ # Example: <code>tokyo-rain-123</code>
+ # Read-only after creation.
+ "labels": { # The labels associated with this Project.
+ #
+ # Label keys must be between 1 and 63 characters long and must conform
+ # to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?.
+ #
+ # Label values must be between 0 and 63 characters long and must conform
+ # to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?.
+ #
+ # No more than 256 labels can be associated with a given resource.
+ #
+ # Clients should store labels in a representation such as JSON that does not
+ # depend on specific characters being disallowed.
+ #
+ # Example: <code>"environment" : "dev"</code>
+ # Read-write.
+ "a_key": "A String",
+ },
+ "projectNumber": "A String", # The number uniquely identifying the project.
+ #
+ # Example: <code>415104041262</code>
+ # Read-only.
+ "lifecycleState": "A String", # The Project lifecycle state.
+ #
+ # Read-only.
+ "createTime": "A String", # Creation time.
+ #
+ # Read-only.
+ }</pre>
</div>
<div class="method">
- <code class="details" id="getAncestry">getAncestry(projectId=None, body, x__xgafv=None)</code>
+ <code class="details" id="getAncestry">getAncestry(projectId, body, x__xgafv=None)</code>
<pre>Gets a list of ancestors in the resource hierarchy for the Project
identified by the specified `project_id` (for example, `my-project-123`).
@@ -597,6 +597,7 @@
# server, not specified by the caller, and represents the last time a call to
# `SetOrgPolicy` was made for that `Policy`. Any value set by the client will
# be ignored.
+ "version": 42, # Version of the `Policy`. Default version is 0;
"constraint": "A String", # The name of the `Constraint` the `Policy` is configuring, for example,
# `constraints/serviceuser.services`.
#
@@ -769,7 +770,6 @@
# The constraint at `projects/bar` is not enforced, because
# `constraint_default` for the `Constraint` is `ALLOW`.
},
- "version": 42, # Version of the `Policy`. Default version is 0;
"etag": "A String", # An opaque tag indicating the current version of the `Policy`, used for
# concurrency control.
#
@@ -817,6 +817,7 @@
# server, not specified by the caller, and represents the last time a call to
# `SetOrgPolicy` was made for that `Policy`. Any value set by the client will
# be ignored.
+ "version": 42, # Version of the `Policy`. Default version is 0;
"constraint": "A String", # The name of the `Constraint` the `Policy` is configuring, for example,
# `constraints/serviceuser.services`.
#
@@ -989,7 +990,6 @@
# The constraint at `projects/bar` is not enforced, because
# `constraint_default` for the `Constraint` is `ALLOW`.
},
- "version": 42, # Version of the `Policy`. Default version is 0;
"etag": "A String", # An opaque tag indicating the current version of the `Policy`, used for
# concurrency control.
#
@@ -1009,7 +1009,7 @@
</div>
<div class="method">
- <code class="details" id="getIamPolicy">getIamPolicy(resource=None, body, x__xgafv=None)</code>
+ <code class="details" id="getIamPolicy">getIamPolicy(resource, body, x__xgafv=None)</code>
<pre>Returns the IAM access control policy for the specified Project.
Permission is denied if the policy or the resource does not exist.
@@ -1223,6 +1223,7 @@
# server, not specified by the caller, and represents the last time a call to
# `SetOrgPolicy` was made for that `Policy`. Any value set by the client will
# be ignored.
+ "version": 42, # Version of the `Policy`. Default version is 0;
"constraint": "A String", # The name of the `Constraint` the `Policy` is configuring, for example,
# `constraints/serviceuser.services`.
#
@@ -1395,7 +1396,6 @@
# The constraint at `projects/bar` is not enforced, because
# `constraint_default` for the `Constraint` is `ALLOW`.
},
- "version": 42, # Version of the `Policy`. Default version is 0;
"etag": "A String", # An opaque tag indicating the current version of the `Policy`, used for
# concurrency control.
#
@@ -1446,6 +1446,7 @@
# server, not specified by the caller, and represents the last time a call to
# `SetOrgPolicy` was made for that `Policy`. Any value set by the client will
# be ignored.
+ "version": 42, # Version of the `Policy`. Default version is 0;
"constraint": "A String", # The name of the `Constraint` the `Policy` is configuring, for example,
# `constraints/serviceuser.services`.
#
@@ -1618,7 +1619,6 @@
# The constraint at `projects/bar` is not enforced, because
# `constraint_default` for the `Constraint` is `ALLOW`.
},
- "version": 42, # Version of the `Policy`. Default version is 0;
"etag": "A String", # An opaque tag indicating the current version of the `Policy`, used for
# concurrency control.
#
@@ -1703,66 +1703,66 @@
"projects": [ # The list of Projects that matched the list filter. This list can
# be paginated.
{ # A Project is a high-level Google Cloud Platform entity. It is a
- # container for ACLs, APIs, App Engine Apps, VMs, and other
- # Google Cloud Platform resources.
- "name": "A String", # The user-assigned display name of the Project.
- # It must be 4 to 30 characters.
- # Allowed characters are: lowercase and uppercase letters, numbers,
- # hyphen, single-quote, double-quote, space, and exclamation point.
- #
- # Example: <code>My Project</code>
- # Read-write.
- "parent": { # A container to reference an id for any resource type. A `resource` in Google # An optional reference to a parent Resource.
- #
- # The only supported parent type is "organization". Once set, the parent
- # cannot be modified. The `parent` can be set on creation or using the
- # `UpdateProject` method; the end user must have the
- # `resourcemanager.projects.create` permission on the parent.
- #
- # Read-write.
- # Cloud Platform is a generic term for something you (a developer) may want to
- # interact with through one of our API's. Some examples are an App Engine app,
- # a Compute Engine instance, a Cloud SQL database, and so on.
- "type": "A String", # Required field representing the resource type this id is for.
- # At present, the valid types are: "organization"
- "id": "A String", # Required field for the type-specific id. This should correspond to the id
- # used in the type-specific API's.
+ # container for ACLs, APIs, App Engine Apps, VMs, and other
+ # Google Cloud Platform resources.
+ "name": "A String", # The user-assigned display name of the Project.
+ # It must be 4 to 30 characters.
+ # Allowed characters are: lowercase and uppercase letters, numbers,
+ # hyphen, single-quote, double-quote, space, and exclamation point.
+ #
+ # Example: <code>My Project</code>
+ # Read-write.
+ "parent": { # A container to reference an id for any resource type. A `resource` in Google # An optional reference to a parent Resource.
+ #
+ # The only supported parent type is "organization". Once set, the parent
+ # cannot be modified. The `parent` can be set on creation or using the
+ # `UpdateProject` method; the end user must have the
+ # `resourcemanager.projects.create` permission on the parent.
+ #
+ # Read-write.
+ # Cloud Platform is a generic term for something you (a developer) may want to
+ # interact with through one of our API's. Some examples are an App Engine app,
+ # a Compute Engine instance, a Cloud SQL database, and so on.
+ "type": "A String", # Required field representing the resource type this id is for.
+ # At present, the valid types are: "organization"
+ "id": "A String", # Required field for the type-specific id. This should correspond to the id
+ # used in the type-specific API's.
+ },
+ "projectId": "A String", # The unique, user-assigned ID of the Project.
+ # It must be 6 to 30 lowercase letters, digits, or hyphens.
+ # It must start with a letter.
+ # Trailing hyphens are prohibited.
+ #
+ # Example: <code>tokyo-rain-123</code>
+ # Read-only after creation.
+ "labels": { # The labels associated with this Project.
+ #
+ # Label keys must be between 1 and 63 characters long and must conform
+ # to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?.
+ #
+ # Label values must be between 0 and 63 characters long and must conform
+ # to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?.
+ #
+ # No more than 256 labels can be associated with a given resource.
+ #
+ # Clients should store labels in a representation such as JSON that does not
+ # depend on specific characters being disallowed.
+ #
+ # Example: <code>"environment" : "dev"</code>
+ # Read-write.
+ "a_key": "A String",
+ },
+ "projectNumber": "A String", # The number uniquely identifying the project.
+ #
+ # Example: <code>415104041262</code>
+ # Read-only.
+ "lifecycleState": "A String", # The Project lifecycle state.
+ #
+ # Read-only.
+ "createTime": "A String", # Creation time.
+ #
+ # Read-only.
},
- "projectId": "A String", # The unique, user-assigned ID of the Project.
- # It must be 6 to 30 lowercase letters, digits, or hyphens.
- # It must start with a letter.
- # Trailing hyphens are prohibited.
- #
- # Example: <code>tokyo-rain-123</code>
- # Read-only after creation.
- "labels": { # The labels associated with this Project.
- #
- # Label keys must be between 1 and 63 characters long and must conform
- # to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?.
- #
- # Label values must be between 0 and 63 characters long and must conform
- # to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?.
- #
- # No more than 256 labels can be associated with a given resource.
- #
- # Clients should store labels in a representation such as JSON that does not
- # depend on specific characters being disallowed.
- #
- # Example: <code>"environment" : "dev"</code>
- # Read-write.
- "a_key": "A String",
- },
- "projectNumber": "A String", # The number uniquely identifying the project.
- #
- # Example: <code>415104041262</code>
- # Read-only.
- "lifecycleState": "A String", # The Project lifecycle state.
- #
- # Read-only.
- "createTime": "A String", # Creation time.
- #
- # Read-only.
- },
],
}</pre>
</div>
@@ -1817,8 +1817,10 @@
"displayName": "A String", # The human readable name.
#
# Mutable.
- "name": "A String", # Immutable value, required to globally be unique. For example,
- # `constraints/serviceuser.services`
+ "description": "A String", # Detailed description of what this `Constraint` controls as well as how and
+ # where it is enforced.
+ #
+ # Mutable.
"booleanConstraint": { # A `Constraint` that is either enforced or not. # Defines this constraint as being a BooleanConstraint.
#
# For example a constraint `constraints/compute.disableSerialPortAccess`.
@@ -1831,10 +1833,8 @@
"suggestedValue": "A String", # Optional. The Google Cloud Console will try to default to a configuration
# that matches the value specified in this `Constraint`.
},
- "description": "A String", # Detailed description of what this `Constraint` controls as well as how and
- # where it is enforced.
- #
- # Mutable.
+ "name": "A String", # Immutable value, required to globally be unique. For example,
+ # `constraints/serviceuser.services`
},
],
}</pre>
@@ -1891,6 +1891,7 @@
# server, not specified by the caller, and represents the last time a call to
# `SetOrgPolicy` was made for that `Policy`. Any value set by the client will
# be ignored.
+ "version": 42, # Version of the `Policy`. Default version is 0;
"constraint": "A String", # The name of the `Constraint` the `Policy` is configuring, for example,
# `constraints/serviceuser.services`.
#
@@ -2063,7 +2064,6 @@
# The constraint at `projects/bar` is not enforced, because
# `constraint_default` for the `Constraint` is `ALLOW`.
},
- "version": 42, # Version of the `Policy`. Default version is 0;
"etag": "A String", # An opaque tag indicating the current version of the `Policy`, used for
# concurrency control.
#
@@ -2113,7 +2113,7 @@
</div>
<div class="method">
- <code class="details" id="setIamPolicy">setIamPolicy(resource=None, body, x__xgafv=None)</code>
+ <code class="details" id="setIamPolicy">setIamPolicy(resource, body, x__xgafv=None)</code>
<pre>Sets the IAM access control policy for the specified Project. Replaces
any existing policy.
@@ -2518,6 +2518,7 @@
# server, not specified by the caller, and represents the last time a call to
# `SetOrgPolicy` was made for that `Policy`. Any value set by the client will
# be ignored.
+ "version": 42, # Version of the `Policy`. Default version is 0;
"constraint": "A String", # The name of the `Constraint` the `Policy` is configuring, for example,
# `constraints/serviceuser.services`.
#
@@ -2690,7 +2691,6 @@
# The constraint at `projects/bar` is not enforced, because
# `constraint_default` for the `Constraint` is `ALLOW`.
},
- "version": 42, # Version of the `Policy`. Default version is 0;
"etag": "A String", # An opaque tag indicating the current version of the `Policy`, used for
# concurrency control.
#
@@ -2723,6 +2723,7 @@
# server, not specified by the caller, and represents the last time a call to
# `SetOrgPolicy` was made for that `Policy`. Any value set by the client will
# be ignored.
+ "version": 42, # Version of the `Policy`. Default version is 0;
"constraint": "A String", # The name of the `Constraint` the `Policy` is configuring, for example,
# `constraints/serviceuser.services`.
#
@@ -2895,7 +2896,6 @@
# The constraint at `projects/bar` is not enforced, because
# `constraint_default` for the `Constraint` is `ALLOW`.
},
- "version": 42, # Version of the `Policy`. Default version is 0;
"etag": "A String", # An opaque tag indicating the current version of the `Policy`, used for
# concurrency control.
#
@@ -2934,6 +2934,7 @@
# server, not specified by the caller, and represents the last time a call to
# `SetOrgPolicy` was made for that `Policy`. Any value set by the client will
# be ignored.
+ "version": 42, # Version of the `Policy`. Default version is 0;
"constraint": "A String", # The name of the `Constraint` the `Policy` is configuring, for example,
# `constraints/serviceuser.services`.
#
@@ -3106,7 +3107,6 @@
# The constraint at `projects/bar` is not enforced, because
# `constraint_default` for the `Constraint` is `ALLOW`.
},
- "version": 42, # Version of the `Policy`. Default version is 0;
"etag": "A String", # An opaque tag indicating the current version of the `Policy`, used for
# concurrency control.
#
@@ -3139,6 +3139,7 @@
# server, not specified by the caller, and represents the last time a call to
# `SetOrgPolicy` was made for that `Policy`. Any value set by the client will
# be ignored.
+ "version": 42, # Version of the `Policy`. Default version is 0;
"constraint": "A String", # The name of the `Constraint` the `Policy` is configuring, for example,
# `constraints/serviceuser.services`.
#
@@ -3311,7 +3312,6 @@
# The constraint at `projects/bar` is not enforced, because
# `constraint_default` for the `Constraint` is `ALLOW`.
},
- "version": 42, # Version of the `Policy`. Default version is 0;
"etag": "A String", # An opaque tag indicating the current version of the `Policy`, used for
# concurrency control.
#
@@ -3331,7 +3331,7 @@
</div>
<div class="method">
- <code class="details" id="testIamPermissions">testIamPermissions(resource=None, body, x__xgafv=None)</code>
+ <code class="details" id="testIamPermissions">testIamPermissions(resource, body, x__xgafv=None)</code>
<pre>Returns permissions that a caller has on the specified Project.
Args:
@@ -3366,7 +3366,7 @@
</div>
<div class="method">
- <code class="details" id="undelete">undelete(projectId=None, body, x__xgafv=None)</code>
+ <code class="details" id="undelete">undelete(projectId, body, x__xgafv=None)</code>
<pre>Restores the Project identified by the specified
`project_id` (for example, `my-project-123`).
You can only use this method for a Project that has a lifecycle state of
@@ -3407,7 +3407,7 @@
</div>
<div class="method">
- <code class="details" id="update">update(projectId=None, body, x__xgafv=None)</code>
+ <code class="details" id="update">update(projectId, body, x__xgafv=None)</code>
<pre>Updates the attributes of the Project identified by the specified
`project_id` (for example, `my-project-123`).
@@ -3421,92 +3421,22 @@
The object takes the form of:
{ # A Project is a high-level Google Cloud Platform entity. It is a
- # container for ACLs, APIs, App Engine Apps, VMs, and other
- # Google Cloud Platform resources.
- "name": "A String", # The user-assigned display name of the Project.
- # It must be 4 to 30 characters.
- # Allowed characters are: lowercase and uppercase letters, numbers,
- # hyphen, single-quote, double-quote, space, and exclamation point.
- #
- # Example: <code>My Project</code>
- # Read-write.
- "parent": { # A container to reference an id for any resource type. A `resource` in Google # An optional reference to a parent Resource.
- #
- # The only supported parent type is "organization". Once set, the parent
- # cannot be modified. The `parent` can be set on creation or using the
- # `UpdateProject` method; the end user must have the
- # `resourcemanager.projects.create` permission on the parent.
- #
- # Read-write.
- # Cloud Platform is a generic term for something you (a developer) may want to
- # interact with through one of our API's. Some examples are an App Engine app,
- # a Compute Engine instance, a Cloud SQL database, and so on.
- "type": "A String", # Required field representing the resource type this id is for.
- # At present, the valid types are: "organization"
- "id": "A String", # Required field for the type-specific id. This should correspond to the id
- # used in the type-specific API's.
- },
- "projectId": "A String", # The unique, user-assigned ID of the Project.
- # It must be 6 to 30 lowercase letters, digits, or hyphens.
- # It must start with a letter.
- # Trailing hyphens are prohibited.
- #
- # Example: <code>tokyo-rain-123</code>
- # Read-only after creation.
- "labels": { # The labels associated with this Project.
- #
- # Label keys must be between 1 and 63 characters long and must conform
- # to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?.
- #
- # Label values must be between 0 and 63 characters long and must conform
- # to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?.
- #
- # No more than 256 labels can be associated with a given resource.
- #
- # Clients should store labels in a representation such as JSON that does not
- # depend on specific characters being disallowed.
- #
- # Example: <code>"environment" : "dev"</code>
- # Read-write.
- "a_key": "A String",
- },
- "projectNumber": "A String", # The number uniquely identifying the project.
- #
- # Example: <code>415104041262</code>
- # Read-only.
- "lifecycleState": "A String", # The Project lifecycle state.
- #
- # Read-only.
- "createTime": "A String", # Creation time.
- #
- # Read-only.
-}
-
- x__xgafv: string, V1 error format.
- Allowed values
- 1 - v1 error format
- 2 - v2 error format
-
-Returns:
- An object of the form:
-
- { # A Project is a high-level Google Cloud Platform entity. It is a
# container for ACLs, APIs, App Engine Apps, VMs, and other
# Google Cloud Platform resources.
"name": "A String", # The user-assigned display name of the Project.
# It must be 4 to 30 characters.
# Allowed characters are: lowercase and uppercase letters, numbers,
# hyphen, single-quote, double-quote, space, and exclamation point.
- #
+ #
# Example: <code>My Project</code>
# Read-write.
"parent": { # A container to reference an id for any resource type. A `resource` in Google # An optional reference to a parent Resource.
- #
+ #
# The only supported parent type is "organization". Once set, the parent
# cannot be modified. The `parent` can be set on creation or using the
# `UpdateProject` method; the end user must have the
# `resourcemanager.projects.create` permission on the parent.
- #
+ #
# Read-write.
# Cloud Platform is a generic term for something you (a developer) may want to
# interact with through one of our API's. Some examples are an App Engine app,
@@ -3520,37 +3450,107 @@
# It must be 6 to 30 lowercase letters, digits, or hyphens.
# It must start with a letter.
# Trailing hyphens are prohibited.
- #
+ #
# Example: <code>tokyo-rain-123</code>
# Read-only after creation.
"labels": { # The labels associated with this Project.
- #
+ #
# Label keys must be between 1 and 63 characters long and must conform
# to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?.
- #
+ #
# Label values must be between 0 and 63 characters long and must conform
# to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?.
- #
+ #
# No more than 256 labels can be associated with a given resource.
- #
+ #
# Clients should store labels in a representation such as JSON that does not
# depend on specific characters being disallowed.
- #
+ #
# Example: <code>"environment" : "dev"</code>
# Read-write.
"a_key": "A String",
},
"projectNumber": "A String", # The number uniquely identifying the project.
- #
+ #
# Example: <code>415104041262</code>
# Read-only.
"lifecycleState": "A String", # The Project lifecycle state.
- #
+ #
# Read-only.
"createTime": "A String", # Creation time.
- #
+ #
# Read-only.
- }</pre>
+ }
+
+ x__xgafv: string, V1 error format.
+ Allowed values
+ 1 - v1 error format
+ 2 - v2 error format
+
+Returns:
+ An object of the form:
+
+ { # A Project is a high-level Google Cloud Platform entity. It is a
+ # container for ACLs, APIs, App Engine Apps, VMs, and other
+ # Google Cloud Platform resources.
+ "name": "A String", # The user-assigned display name of the Project.
+ # It must be 4 to 30 characters.
+ # Allowed characters are: lowercase and uppercase letters, numbers,
+ # hyphen, single-quote, double-quote, space, and exclamation point.
+ #
+ # Example: <code>My Project</code>
+ # Read-write.
+ "parent": { # A container to reference an id for any resource type. A `resource` in Google # An optional reference to a parent Resource.
+ #
+ # The only supported parent type is "organization". Once set, the parent
+ # cannot be modified. The `parent` can be set on creation or using the
+ # `UpdateProject` method; the end user must have the
+ # `resourcemanager.projects.create` permission on the parent.
+ #
+ # Read-write.
+ # Cloud Platform is a generic term for something you (a developer) may want to
+ # interact with through one of our API's. Some examples are an App Engine app,
+ # a Compute Engine instance, a Cloud SQL database, and so on.
+ "type": "A String", # Required field representing the resource type this id is for.
+ # At present, the valid types are: "organization"
+ "id": "A String", # Required field for the type-specific id. This should correspond to the id
+ # used in the type-specific API's.
+ },
+ "projectId": "A String", # The unique, user-assigned ID of the Project.
+ # It must be 6 to 30 lowercase letters, digits, or hyphens.
+ # It must start with a letter.
+ # Trailing hyphens are prohibited.
+ #
+ # Example: <code>tokyo-rain-123</code>
+ # Read-only after creation.
+ "labels": { # The labels associated with this Project.
+ #
+ # Label keys must be between 1 and 63 characters long and must conform
+ # to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?.
+ #
+ # Label values must be between 0 and 63 characters long and must conform
+ # to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?.
+ #
+ # No more than 256 labels can be associated with a given resource.
+ #
+ # Clients should store labels in a representation such as JSON that does not
+ # depend on specific characters being disallowed.
+ #
+ # Example: <code>"environment" : "dev"</code>
+ # Read-write.
+ "a_key": "A String",
+ },
+ "projectNumber": "A String", # The number uniquely identifying the project.
+ #
+ # Example: <code>415104041262</code>
+ # Read-only.
+ "lifecycleState": "A String", # The Project lifecycle state.
+ #
+ # Read-only.
+ "createTime": "A String", # Creation time.
+ #
+ # Read-only.
+ }</pre>
</div>
</body></html>
\ No newline at end of file