mirror of
https://github.com/OMGeeky/google-apis-rs.git
synced 2026-02-23 15:49:49 +01:00
regenerate all crates with updated patch level
This commit is contained in:
@@ -4,12 +4,12 @@
|
||||
[package]
|
||||
|
||||
name = "google-binaryauthorization1_beta1"
|
||||
version = "1.0.12+20190628"
|
||||
version = "1.0.13+20200327"
|
||||
authors = ["Sebastian Thiel <byronimo@gmail.com>"]
|
||||
description = "A complete library to interact with Binary Authorization (protocol v1beta1)"
|
||||
repository = "https://github.com/Byron/google-apis-rs/tree/master/gen/binaryauthorization1_beta1"
|
||||
homepage = "https://cloud.google.com/binary-authorization/"
|
||||
documentation = "https://docs.rs/google-binaryauthorization1_beta1/1.0.12+20190628"
|
||||
documentation = "https://docs.rs/google-binaryauthorization1_beta1/1.0.13+20200327"
|
||||
license = "MIT"
|
||||
keywords = ["binaryauthorization", "google", "protocol", "web", "api"]
|
||||
autobins = false
|
||||
|
||||
@@ -5,16 +5,16 @@ DO NOT EDIT !
|
||||
-->
|
||||
The `google-binaryauthorization1_beta1` library allows access to all features of the *Google Binary Authorization* service.
|
||||
|
||||
This documentation was generated from *Binary Authorization* crate version *1.0.12+20190628*, where *20190628* is the exact revision of the *binaryauthorization:v1beta1* schema built by the [mako](http://www.makotemplates.org/) code generator *v1.0.12*.
|
||||
This documentation was generated from *Binary Authorization* crate version *1.0.13+20200327*, where *20200327* is the exact revision of the *binaryauthorization:v1beta1* schema built by the [mako](http://www.makotemplates.org/) code generator *v1.0.13*.
|
||||
|
||||
Everything else about the *Binary Authorization* *v1_beta1* API can be found at the
|
||||
[official documentation site](https://cloud.google.com/binary-authorization/).
|
||||
# Features
|
||||
|
||||
Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-binaryauthorization1_beta1/1.0.12+20190628/google_binaryauthorization1_beta1/struct.BinaryAuthorization.html) ...
|
||||
Handle the following *Resources* with ease from the central [hub](https://docs.rs/google-binaryauthorization1_beta1/1.0.13+20200327/google_binaryauthorization1_beta1/struct.BinaryAuthorization.html) ...
|
||||
|
||||
* projects
|
||||
* [*attestors create*](https://docs.rs/google-binaryauthorization1_beta1/1.0.12+20190628/google_binaryauthorization1_beta1/struct.ProjectAttestorCreateCall.html), [*attestors delete*](https://docs.rs/google-binaryauthorization1_beta1/1.0.12+20190628/google_binaryauthorization1_beta1/struct.ProjectAttestorDeleteCall.html), [*attestors get*](https://docs.rs/google-binaryauthorization1_beta1/1.0.12+20190628/google_binaryauthorization1_beta1/struct.ProjectAttestorGetCall.html), [*attestors get iam policy*](https://docs.rs/google-binaryauthorization1_beta1/1.0.12+20190628/google_binaryauthorization1_beta1/struct.ProjectAttestorGetIamPolicyCall.html), [*attestors list*](https://docs.rs/google-binaryauthorization1_beta1/1.0.12+20190628/google_binaryauthorization1_beta1/struct.ProjectAttestorListCall.html), [*attestors set iam policy*](https://docs.rs/google-binaryauthorization1_beta1/1.0.12+20190628/google_binaryauthorization1_beta1/struct.ProjectAttestorSetIamPolicyCall.html), [*attestors test iam permissions*](https://docs.rs/google-binaryauthorization1_beta1/1.0.12+20190628/google_binaryauthorization1_beta1/struct.ProjectAttestorTestIamPermissionCall.html), [*attestors update*](https://docs.rs/google-binaryauthorization1_beta1/1.0.12+20190628/google_binaryauthorization1_beta1/struct.ProjectAttestorUpdateCall.html), [*get policy*](https://docs.rs/google-binaryauthorization1_beta1/1.0.12+20190628/google_binaryauthorization1_beta1/struct.ProjectGetPolicyCall.html), [*policy get iam policy*](https://docs.rs/google-binaryauthorization1_beta1/1.0.12+20190628/google_binaryauthorization1_beta1/struct.ProjectPolicyGetIamPolicyCall.html), [*policy set iam policy*](https://docs.rs/google-binaryauthorization1_beta1/1.0.12+20190628/google_binaryauthorization1_beta1/struct.ProjectPolicySetIamPolicyCall.html), [*policy test iam permissions*](https://docs.rs/google-binaryauthorization1_beta1/1.0.12+20190628/google_binaryauthorization1_beta1/struct.ProjectPolicyTestIamPermissionCall.html) and [*update policy*](https://docs.rs/google-binaryauthorization1_beta1/1.0.12+20190628/google_binaryauthorization1_beta1/struct.ProjectUpdatePolicyCall.html)
|
||||
* [*attestors create*](https://docs.rs/google-binaryauthorization1_beta1/1.0.13+20200327/google_binaryauthorization1_beta1/struct.ProjectAttestorCreateCall.html), [*attestors delete*](https://docs.rs/google-binaryauthorization1_beta1/1.0.13+20200327/google_binaryauthorization1_beta1/struct.ProjectAttestorDeleteCall.html), [*attestors get*](https://docs.rs/google-binaryauthorization1_beta1/1.0.13+20200327/google_binaryauthorization1_beta1/struct.ProjectAttestorGetCall.html), [*attestors get iam policy*](https://docs.rs/google-binaryauthorization1_beta1/1.0.13+20200327/google_binaryauthorization1_beta1/struct.ProjectAttestorGetIamPolicyCall.html), [*attestors list*](https://docs.rs/google-binaryauthorization1_beta1/1.0.13+20200327/google_binaryauthorization1_beta1/struct.ProjectAttestorListCall.html), [*attestors set iam policy*](https://docs.rs/google-binaryauthorization1_beta1/1.0.13+20200327/google_binaryauthorization1_beta1/struct.ProjectAttestorSetIamPolicyCall.html), [*attestors test iam permissions*](https://docs.rs/google-binaryauthorization1_beta1/1.0.13+20200327/google_binaryauthorization1_beta1/struct.ProjectAttestorTestIamPermissionCall.html), [*attestors update*](https://docs.rs/google-binaryauthorization1_beta1/1.0.13+20200327/google_binaryauthorization1_beta1/struct.ProjectAttestorUpdateCall.html), [*get policy*](https://docs.rs/google-binaryauthorization1_beta1/1.0.13+20200327/google_binaryauthorization1_beta1/struct.ProjectGetPolicyCall.html), [*policy get iam policy*](https://docs.rs/google-binaryauthorization1_beta1/1.0.13+20200327/google_binaryauthorization1_beta1/struct.ProjectPolicyGetIamPolicyCall.html), [*policy set iam policy*](https://docs.rs/google-binaryauthorization1_beta1/1.0.13+20200327/google_binaryauthorization1_beta1/struct.ProjectPolicySetIamPolicyCall.html), [*policy test iam permissions*](https://docs.rs/google-binaryauthorization1_beta1/1.0.13+20200327/google_binaryauthorization1_beta1/struct.ProjectPolicyTestIamPermissionCall.html) and [*update policy*](https://docs.rs/google-binaryauthorization1_beta1/1.0.13+20200327/google_binaryauthorization1_beta1/struct.ProjectUpdatePolicyCall.html)
|
||||
|
||||
|
||||
|
||||
@@ -23,17 +23,17 @@ Handle the following *Resources* with ease from the central [hub](https://docs.r
|
||||
|
||||
The API is structured into the following primary items:
|
||||
|
||||
* **[Hub](https://docs.rs/google-binaryauthorization1_beta1/1.0.12+20190628/google_binaryauthorization1_beta1/struct.BinaryAuthorization.html)**
|
||||
* **[Hub](https://docs.rs/google-binaryauthorization1_beta1/1.0.13+20200327/google_binaryauthorization1_beta1/struct.BinaryAuthorization.html)**
|
||||
* a central object to maintain state and allow accessing all *Activities*
|
||||
* creates [*Method Builders*](https://docs.rs/google-binaryauthorization1_beta1/1.0.12+20190628/google_binaryauthorization1_beta1/trait.MethodsBuilder.html) which in turn
|
||||
allow access to individual [*Call Builders*](https://docs.rs/google-binaryauthorization1_beta1/1.0.12+20190628/google_binaryauthorization1_beta1/trait.CallBuilder.html)
|
||||
* **[Resources](https://docs.rs/google-binaryauthorization1_beta1/1.0.12+20190628/google_binaryauthorization1_beta1/trait.Resource.html)**
|
||||
* creates [*Method Builders*](https://docs.rs/google-binaryauthorization1_beta1/1.0.13+20200327/google_binaryauthorization1_beta1/trait.MethodsBuilder.html) which in turn
|
||||
allow access to individual [*Call Builders*](https://docs.rs/google-binaryauthorization1_beta1/1.0.13+20200327/google_binaryauthorization1_beta1/trait.CallBuilder.html)
|
||||
* **[Resources](https://docs.rs/google-binaryauthorization1_beta1/1.0.13+20200327/google_binaryauthorization1_beta1/trait.Resource.html)**
|
||||
* primary types that you can apply *Activities* to
|
||||
* a collection of properties and *Parts*
|
||||
* **[Parts](https://docs.rs/google-binaryauthorization1_beta1/1.0.12+20190628/google_binaryauthorization1_beta1/trait.Part.html)**
|
||||
* **[Parts](https://docs.rs/google-binaryauthorization1_beta1/1.0.13+20200327/google_binaryauthorization1_beta1/trait.Part.html)**
|
||||
* a collection of properties
|
||||
* never directly used in *Activities*
|
||||
* **[Activities](https://docs.rs/google-binaryauthorization1_beta1/1.0.12+20190628/google_binaryauthorization1_beta1/trait.CallBuilder.html)**
|
||||
* **[Activities](https://docs.rs/google-binaryauthorization1_beta1/1.0.13+20200327/google_binaryauthorization1_beta1/trait.CallBuilder.html)**
|
||||
* operations to apply to *Resources*
|
||||
|
||||
All *structures* are marked with applicable traits to further categorize them and ease browsing.
|
||||
@@ -133,17 +133,17 @@ match result {
|
||||
```
|
||||
## Handling Errors
|
||||
|
||||
All errors produced by the system are provided either as [Result](https://docs.rs/google-binaryauthorization1_beta1/1.0.12+20190628/google_binaryauthorization1_beta1/enum.Result.html) enumeration as return value of
|
||||
All errors produced by the system are provided either as [Result](https://docs.rs/google-binaryauthorization1_beta1/1.0.13+20200327/google_binaryauthorization1_beta1/enum.Result.html) enumeration as return value of
|
||||
the doit() methods, or handed as possibly intermediate results to either the
|
||||
[Hub Delegate](https://docs.rs/google-binaryauthorization1_beta1/1.0.12+20190628/google_binaryauthorization1_beta1/trait.Delegate.html), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html).
|
||||
[Hub Delegate](https://docs.rs/google-binaryauthorization1_beta1/1.0.13+20200327/google_binaryauthorization1_beta1/trait.Delegate.html), or the [Authenticator Delegate](https://docs.rs/yup-oauth2/*/yup_oauth2/trait.AuthenticatorDelegate.html).
|
||||
|
||||
When delegates handle errors or intermediate values, they may have a chance to instruct the system to retry. This
|
||||
makes the system potentially resilient to all kinds of errors.
|
||||
|
||||
## Uploads and Downloads
|
||||
If a method supports downloads, the response body, which is part of the [Result](https://docs.rs/google-binaryauthorization1_beta1/1.0.12+20190628/google_binaryauthorization1_beta1/enum.Result.html), should be
|
||||
If a method supports downloads, the response body, which is part of the [Result](https://docs.rs/google-binaryauthorization1_beta1/1.0.13+20200327/google_binaryauthorization1_beta1/enum.Result.html), should be
|
||||
read by you to obtain the media.
|
||||
If such a method also supports a [Response Result](https://docs.rs/google-binaryauthorization1_beta1/1.0.12+20190628/google_binaryauthorization1_beta1/trait.ResponseResult.html), it will return that by default.
|
||||
If such a method also supports a [Response Result](https://docs.rs/google-binaryauthorization1_beta1/1.0.13+20200327/google_binaryauthorization1_beta1/trait.ResponseResult.html), it will return that by default.
|
||||
You can see it as meta-data for the actual media. To trigger a media download, you will have to set up the builder by making
|
||||
this call: `.param("alt", "media")`.
|
||||
|
||||
@@ -153,29 +153,29 @@ Methods supporting uploads can do so using up to 2 different protocols:
|
||||
|
||||
## Customization and Callbacks
|
||||
|
||||
You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-binaryauthorization1_beta1/1.0.12+20190628/google_binaryauthorization1_beta1/trait.Delegate.html) to the
|
||||
[Method Builder](https://docs.rs/google-binaryauthorization1_beta1/1.0.12+20190628/google_binaryauthorization1_beta1/trait.CallBuilder.html) before making the final `doit()` call.
|
||||
You may alter the way an `doit()` method is called by providing a [delegate](https://docs.rs/google-binaryauthorization1_beta1/1.0.13+20200327/google_binaryauthorization1_beta1/trait.Delegate.html) to the
|
||||
[Method Builder](https://docs.rs/google-binaryauthorization1_beta1/1.0.13+20200327/google_binaryauthorization1_beta1/trait.CallBuilder.html) before making the final `doit()` call.
|
||||
Respective methods will be called to provide progress information, as well as determine whether the system should
|
||||
retry on failure.
|
||||
|
||||
The [delegate trait](https://docs.rs/google-binaryauthorization1_beta1/1.0.12+20190628/google_binaryauthorization1_beta1/trait.Delegate.html) is default-implemented, allowing you to customize it with minimal effort.
|
||||
The [delegate trait](https://docs.rs/google-binaryauthorization1_beta1/1.0.13+20200327/google_binaryauthorization1_beta1/trait.Delegate.html) is default-implemented, allowing you to customize it with minimal effort.
|
||||
|
||||
## Optional Parts in Server-Requests
|
||||
|
||||
All structures provided by this library are made to be [enocodable](https://docs.rs/google-binaryauthorization1_beta1/1.0.12+20190628/google_binaryauthorization1_beta1/trait.RequestValue.html) and
|
||||
[decodable](https://docs.rs/google-binaryauthorization1_beta1/1.0.12+20190628/google_binaryauthorization1_beta1/trait.ResponseResult.html) via *json*. Optionals are used to indicate that partial requests are responses
|
||||
All structures provided by this library are made to be [enocodable](https://docs.rs/google-binaryauthorization1_beta1/1.0.13+20200327/google_binaryauthorization1_beta1/trait.RequestValue.html) and
|
||||
[decodable](https://docs.rs/google-binaryauthorization1_beta1/1.0.13+20200327/google_binaryauthorization1_beta1/trait.ResponseResult.html) via *json*. Optionals are used to indicate that partial requests are responses
|
||||
are valid.
|
||||
Most optionals are are considered [Parts](https://docs.rs/google-binaryauthorization1_beta1/1.0.12+20190628/google_binaryauthorization1_beta1/trait.Part.html) which are identifiable by name, which will be sent to
|
||||
Most optionals are are considered [Parts](https://docs.rs/google-binaryauthorization1_beta1/1.0.13+20200327/google_binaryauthorization1_beta1/trait.Part.html) which are identifiable by name, which will be sent to
|
||||
the server to indicate either the set parts of the request or the desired parts in the response.
|
||||
|
||||
## Builder Arguments
|
||||
|
||||
Using [method builders](https://docs.rs/google-binaryauthorization1_beta1/1.0.12+20190628/google_binaryauthorization1_beta1/trait.CallBuilder.html), you are able to prepare an action call by repeatedly calling it's methods.
|
||||
Using [method builders](https://docs.rs/google-binaryauthorization1_beta1/1.0.13+20200327/google_binaryauthorization1_beta1/trait.CallBuilder.html), you are able to prepare an action call by repeatedly calling it's methods.
|
||||
These will always take a single argument, for which the following statements are true.
|
||||
|
||||
* [PODs][wiki-pod] are handed by copy
|
||||
* strings are passed as `&str`
|
||||
* [request values](https://docs.rs/google-binaryauthorization1_beta1/1.0.12+20190628/google_binaryauthorization1_beta1/trait.RequestValue.html) are moved
|
||||
* [request values](https://docs.rs/google-binaryauthorization1_beta1/1.0.13+20200327/google_binaryauthorization1_beta1/trait.RequestValue.html) are moved
|
||||
|
||||
Arguments will always be copied or cloned into the builder, to make them independent of their original life times.
|
||||
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
// This file was generated automatically from 'src/mako/api/lib.rs.mako'
|
||||
// DO NOT EDIT !
|
||||
|
||||
//! This documentation was generated from *Binary Authorization* crate version *1.0.12+20190628*, where *20190628* is the exact revision of the *binaryauthorization:v1beta1* schema built by the [mako](http://www.makotemplates.org/) code generator *v1.0.12*.
|
||||
//! This documentation was generated from *Binary Authorization* crate version *1.0.13+20200327*, where *20200327* is the exact revision of the *binaryauthorization:v1beta1* schema built by the [mako](http://www.makotemplates.org/) code generator *v1.0.13*.
|
||||
//!
|
||||
//! Everything else about the *Binary Authorization* *v1_beta1* API can be found at the
|
||||
//! [official documentation site](https://cloud.google.com/binary-authorization/).
|
||||
@@ -332,7 +332,7 @@ impl<'a, C, A> BinaryAuthorization<C, A>
|
||||
BinaryAuthorization {
|
||||
client: RefCell::new(client),
|
||||
auth: RefCell::new(authenticator),
|
||||
_user_agent: "google-api-rust-client/1.0.12".to_string(),
|
||||
_user_agent: "google-api-rust-client/1.0.13".to_string(),
|
||||
_base_url: "https://binaryauthorization.googleapis.com/".to_string(),
|
||||
_root_url: "https://binaryauthorization.googleapis.com/".to_string(),
|
||||
}
|
||||
@@ -343,7 +343,7 @@ impl<'a, C, A> BinaryAuthorization<C, A>
|
||||
}
|
||||
|
||||
/// Set the user-agent header field to use in all requests to the server.
|
||||
/// It defaults to `google-api-rust-client/1.0.12`.
|
||||
/// It defaults to `google-api-rust-client/1.0.13`.
|
||||
///
|
||||
/// Returns the previously set user-agent.
|
||||
pub fn user_agent(&mut self, agent_name: String) -> String {
|
||||
@@ -471,30 +471,59 @@ pub struct AdmissionRule {
|
||||
impl Part for AdmissionRule {}
|
||||
|
||||
|
||||
/// Represents an expression text. Example:
|
||||
/// Represents a textual expression in the Common Expression Language (CEL)
|
||||
/// syntax. CEL is a C-like expression language. The syntax and semantics of CEL
|
||||
/// are documented at https://github.com/google/cel-spec.
|
||||
///
|
||||
/// Example (Comparison):
|
||||
///
|
||||
/// ````text
|
||||
/// title: "User account presence"
|
||||
/// description: "Determines whether the request has a user account"
|
||||
/// expression: "size(request.user) > 0"
|
||||
/// title: "Summary size limit"
|
||||
/// description: "Determines if a summary is less than 100 chars"
|
||||
/// expression: "document.summary.size() < 100"
|
||||
/// ````
|
||||
///
|
||||
/// Example (Equality):
|
||||
///
|
||||
/// ````text
|
||||
/// title: "Requestor is owner"
|
||||
/// description: "Determines if requestor is the document owner"
|
||||
/// expression: "document.owner == request.auth.claims.email"
|
||||
/// ````
|
||||
///
|
||||
/// Example (Logic):
|
||||
///
|
||||
/// ````text
|
||||
/// title: "Public documents"
|
||||
/// description: "Determine whether the document should be publicly visible"
|
||||
/// expression: "document.type != 'private' && document.type != 'internal'"
|
||||
/// ````
|
||||
///
|
||||
/// Example (Data Manipulation):
|
||||
///
|
||||
/// ````text
|
||||
/// title: "Notification string"
|
||||
/// description: "Create a notification string with a timestamp."
|
||||
/// expression: "'New message received at ' + string(document.create_time)"
|
||||
/// ````
|
||||
///
|
||||
/// The exact variables and functions that may be referenced within an expression
|
||||
/// are determined by the service that evaluates it. See the service
|
||||
/// documentation for additional information.
|
||||
///
|
||||
/// This type is not used in any activity, and only used as *part* of another schema.
|
||||
#[derive(Default, Clone, Debug, Serialize, Deserialize)]
|
||||
pub struct Expr {
|
||||
/// An optional description of the expression. This is a longer text which
|
||||
/// Optional. Description of the expression. This is a longer text which
|
||||
/// describes the expression, e.g. when hovered over it in a UI.
|
||||
pub description: Option<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.
|
||||
/// Textual representation of an expression in Common Expression Language
|
||||
/// syntax.
|
||||
pub expression: Option<String>,
|
||||
/// An optional string indicating the location of the expression for error
|
||||
/// Optional. String indicating the location of the expression for error
|
||||
/// reporting, e.g. a file name and a position in the file.
|
||||
pub location: Option<String>,
|
||||
/// An optional title for the expression, i.e. a short string describing
|
||||
/// 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.
|
||||
pub title: Option<String>,
|
||||
@@ -527,7 +556,7 @@ pub struct Binding {
|
||||
/// 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` .
|
||||
/// account. For example, `alice@example.com` .
|
||||
///
|
||||
///
|
||||
/// * `serviceAccount:{emailid}`: An email address that represents a service
|
||||
@@ -536,6 +565,26 @@ pub struct Binding {
|
||||
/// * `group:{emailid}`: An email address that represents a Google group.
|
||||
/// For example, `admins@example.com`.
|
||||
///
|
||||
/// * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique
|
||||
/// identifier) representing a user that has been recently deleted. For
|
||||
/// example, `alice@example.com?uid=123456789012345678901`. If the user is
|
||||
/// recovered, this value reverts to `user:{emailid}` and the recovered user
|
||||
/// retains the role in the binding.
|
||||
///
|
||||
/// * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus
|
||||
/// unique identifier) representing a service account that has been recently
|
||||
/// deleted. For example,
|
||||
/// `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.
|
||||
/// If the service account is undeleted, this value reverts to
|
||||
/// `serviceAccount:{emailid}` and the undeleted service account retains the
|
||||
/// role in the binding.
|
||||
///
|
||||
/// * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique
|
||||
/// identifier) representing a Google group that has been recently
|
||||
/// deleted. For example, `admins@example.com?uid=123456789012345678901`. If
|
||||
/// the group is recovered, this value reverts to `group:{emailid}` and the
|
||||
/// recovered group retains the role in the binding.
|
||||
///
|
||||
///
|
||||
/// * `domain:{domain}`: The G Suite domain (primary) that represents all the
|
||||
/// users of that domain. For example, `google.com` or `example.com`.
|
||||
@@ -547,37 +596,50 @@ pub struct Binding {
|
||||
impl Part for Binding {}
|
||||
|
||||
|
||||
/// Defines an Identity and Access Management (IAM) policy. It is used to
|
||||
/// specify access control policies for Cloud Platform resources.
|
||||
/// An Identity and Access Management (IAM) policy, which specifies access
|
||||
/// controls for Google Cloud resources.
|
||||
///
|
||||
/// 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.
|
||||
/// A `Policy` is a collection of `bindings`. A `binding` binds one or more
|
||||
/// `members` to a single `role`. Members can be user accounts, service accounts,
|
||||
/// Google groups, and domains (such as G Suite). A `role` is a named list of
|
||||
/// permissions; each `role` can be an IAM predefined role or a user-created
|
||||
/// custom role.
|
||||
///
|
||||
/// **JSON Example**
|
||||
/// Optionally, a `binding` can specify a `condition`, which is a logical
|
||||
/// expression that allows access to a resource only if the expression evaluates
|
||||
/// to `true`. A condition can add constraints based on attributes of the
|
||||
/// request, the resource, or both.
|
||||
///
|
||||
/// **JSON example:**
|
||||
///
|
||||
/// ````text
|
||||
/// {
|
||||
/// "bindings": [
|
||||
/// {
|
||||
/// "role": "roles/owner",
|
||||
/// "role": "roles/resourcemanager.organizationAdmin",
|
||||
/// "members": [
|
||||
/// "user:mike@example.com",
|
||||
/// "group:admins@example.com",
|
||||
/// "domain:google.com",
|
||||
/// "serviceAccount:my-other-app@appspot.gserviceaccount.com"
|
||||
/// "serviceAccount:my-project-id@appspot.gserviceaccount.com"
|
||||
/// ]
|
||||
/// },
|
||||
/// {
|
||||
/// "role": "roles/viewer",
|
||||
/// "members": ["user:sean@example.com"]
|
||||
/// "role": "roles/resourcemanager.organizationViewer",
|
||||
/// "members": ["user:eve@example.com"],
|
||||
/// "condition": {
|
||||
/// "title": "expirable access",
|
||||
/// "description": "Does not grant access after Sep 2020",
|
||||
/// "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')",
|
||||
/// }
|
||||
/// }
|
||||
/// ]
|
||||
/// ],
|
||||
/// "etag": "BwWWja0YfJA=",
|
||||
/// "version": 3
|
||||
/// }
|
||||
/// ````
|
||||
///
|
||||
/// **YAML Example**
|
||||
/// **YAML example:**
|
||||
///
|
||||
/// ````text
|
||||
/// bindings:
|
||||
@@ -585,15 +647,21 @@ impl Part for Binding {}
|
||||
/// - user:mike@example.com
|
||||
/// - group:admins@example.com
|
||||
/// - domain:google.com
|
||||
/// - serviceAccount:my-other-app@appspot.gserviceaccount.com
|
||||
/// role: roles/owner
|
||||
/// - serviceAccount:my-project-id@appspot.gserviceaccount.com
|
||||
/// role: roles/resourcemanager.organizationAdmin
|
||||
/// - members:
|
||||
/// - user:sean@example.com
|
||||
/// role: roles/viewer
|
||||
/// - user:eve@example.com
|
||||
/// role: roles/resourcemanager.organizationViewer
|
||||
/// condition:
|
||||
/// title: expirable access
|
||||
/// description: Does not grant access after Sep 2020
|
||||
/// expression: request.time < timestamp('2020-10-01T00:00:00.000Z')
|
||||
/// - etag: BwWWja0YfJA=
|
||||
/// - version: 3
|
||||
/// ````
|
||||
///
|
||||
/// For a description of IAM and its features, see the
|
||||
/// [IAM developer's guide](https://cloud.google.com/iam/docs).
|
||||
/// [IAM documentation](https://cloud.google.com/iam/docs/).
|
||||
///
|
||||
/// # Activities
|
||||
///
|
||||
@@ -606,8 +674,9 @@ impl Part for Binding {}
|
||||
/// * [attestors get iam policy projects](struct.ProjectAttestorGetIamPolicyCall.html) (response)
|
||||
#[derive(Default, Clone, Debug, Serialize, Deserialize)]
|
||||
pub struct IamPolicy {
|
||||
/// Associates a list of `members` to a `role`.
|
||||
/// `bindings` with no members will result in an error.
|
||||
/// Associates a list of `members` to a `role`. Optionally, may specify a
|
||||
/// `condition` that determines how and when the `bindings` are applied. Each
|
||||
/// of the `bindings` must contain at least one member.
|
||||
pub bindings: Option<Vec<Binding>>,
|
||||
/// `etag` is used for optimistic concurrency control as a way to help
|
||||
/// prevent simultaneous updates of a policy from overwriting each other.
|
||||
@@ -617,10 +686,32 @@ pub struct IamPolicy {
|
||||
/// systems are expected to put that etag in the request to `setIamPolicy` to
|
||||
/// ensure that their change will be applied to the same version of the policy.
|
||||
///
|
||||
/// If no `etag` is provided in the call to `setIamPolicy`, then the existing
|
||||
/// policy is overwritten blindly.
|
||||
/// **Important:** If you use IAM Conditions, you must include the `etag` field
|
||||
/// whenever you call `setIamPolicy`. If you omit this field, then IAM allows
|
||||
/// you to overwrite a version `3` policy with a version `1` policy, and all of
|
||||
/// the conditions in the version `3` policy are lost.
|
||||
pub etag: Option<String>,
|
||||
/// Deprecated.
|
||||
/// Specifies the format of the policy.
|
||||
///
|
||||
/// Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
|
||||
/// are rejected.
|
||||
///
|
||||
/// Any operation that affects conditional role bindings must specify version
|
||||
/// `3`. This requirement applies to the following operations:
|
||||
///
|
||||
/// * Getting a policy that includes a conditional role binding
|
||||
/// * Adding a conditional role binding to a policy
|
||||
/// * Changing a conditional role binding in a policy
|
||||
/// * Removing any role binding, with or without a condition, from a policy
|
||||
/// that includes conditions
|
||||
///
|
||||
/// **Important:** If you use IAM Conditions, you must include the `etag` field
|
||||
/// whenever you call `setIamPolicy`. If you omit this field, then IAM allows
|
||||
/// you to overwrite a version `3` policy with a version `1` policy, and all of
|
||||
/// the conditions in the version `3` policy are lost.
|
||||
///
|
||||
/// If a policy does not include any conditions, operations on that policy may
|
||||
/// specify any valid version or leave the field unset.
|
||||
pub version: Option<i32>,
|
||||
}
|
||||
|
||||
@@ -949,6 +1040,8 @@ impl<'a, C, A> ProjectMethods<'a, C, A> {
|
||||
/// Sets the access control policy on the specified resource. Replaces any
|
||||
/// existing policy.
|
||||
///
|
||||
/// Can return Public Errors: NOT_FOUND, INVALID_ARGUMENT and PERMISSION_DENIED
|
||||
///
|
||||
/// # Arguments
|
||||
///
|
||||
/// * `request` - No description provided.
|
||||
@@ -1128,6 +1221,8 @@ impl<'a, C, A> ProjectMethods<'a, C, A> {
|
||||
/// Sets the access control policy on the specified resource. Replaces any
|
||||
/// existing policy.
|
||||
///
|
||||
/// Can return Public Errors: NOT_FOUND, INVALID_ARGUMENT and PERMISSION_DENIED
|
||||
///
|
||||
/// # Arguments
|
||||
///
|
||||
/// * `request` - No description provided.
|
||||
@@ -1498,6 +1593,8 @@ impl<'a, C, A> ProjectAttestorListCall<'a, C, A> where C: BorrowMut<hyper::Clien
|
||||
|
||||
/// Sets the access control policy on the specified resource. Replaces any
|
||||
/// existing policy.
|
||||
///
|
||||
/// Can return Public Errors: NOT_FOUND, INVALID_ARGUMENT and PERMISSION_DENIED
|
||||
///
|
||||
/// A builder for the *policy.setIamPolicy* method supported by a *project* resource.
|
||||
/// It is not used directly, but through a `ProjectMethods` instance.
|
||||
@@ -2551,9 +2648,13 @@ impl<'a, C, A> ProjectPolicyGetIamPolicyCall<'a, C, A> where C: BorrowMut<hyper:
|
||||
self
|
||||
}
|
||||
/// Optional. The policy format version to be returned.
|
||||
/// Acceptable values are 0 and 1.
|
||||
/// If the value is 0, or the field is omitted, policy format version 1 will be
|
||||
/// returned.
|
||||
///
|
||||
/// Valid values are 0, 1, and 3. Requests specifying an invalid value will be
|
||||
/// rejected.
|
||||
///
|
||||
/// Requests for policies with any conditional bindings must specify version 3.
|
||||
/// Policies without any conditional bindings may specify any valid value or
|
||||
/// leave the field unset.
|
||||
///
|
||||
/// Sets the *options.requested policy version* query property to the given value.
|
||||
pub fn options_requested_policy_version(mut self, new_value: i32) -> ProjectPolicyGetIamPolicyCall<'a, C, A> {
|
||||
@@ -3322,9 +3423,13 @@ impl<'a, C, A> ProjectAttestorGetIamPolicyCall<'a, C, A> where C: BorrowMut<hype
|
||||
self
|
||||
}
|
||||
/// Optional. The policy format version to be returned.
|
||||
/// Acceptable values are 0 and 1.
|
||||
/// If the value is 0, or the field is omitted, policy format version 1 will be
|
||||
/// returned.
|
||||
///
|
||||
/// Valid values are 0, 1, and 3. Requests specifying an invalid value will be
|
||||
/// rejected.
|
||||
///
|
||||
/// Requests for policies with any conditional bindings must specify version 3.
|
||||
/// Policies without any conditional bindings may specify any valid value or
|
||||
/// leave the field unset.
|
||||
///
|
||||
/// Sets the *options.requested policy version* query property to the given value.
|
||||
pub fn options_requested_policy_version(mut self, new_value: i32) -> ProjectAttestorGetIamPolicyCall<'a, C, A> {
|
||||
@@ -3680,6 +3785,8 @@ impl<'a, C, A> ProjectUpdatePolicyCall<'a, C, A> where C: BorrowMut<hyper::Clien
|
||||
|
||||
/// Sets the access control policy on the specified resource. Replaces any
|
||||
/// existing policy.
|
||||
///
|
||||
/// Can return Public Errors: NOT_FOUND, INVALID_ARGUMENT and PERMISSION_DENIED
|
||||
///
|
||||
/// A builder for the *attestors.setIamPolicy* method supported by a *project* resource.
|
||||
/// It is not used directly, but through a `ProjectMethods` instance.
|
||||
|
||||
Reference in New Issue
Block a user