api: google.golang.org/api/iam/v1 Index | Files

package iam

import "google.golang.org/api/iam/v1"

Package iam provides access to the Identity and Access Management (IAM) API.

For product documentation, see: https://cloud.google.com/iam/

Creating a client

Usage example:

import "google.golang.org/api/iam/v1"
...
ctx := context.Background()
iamService, err := iam.NewService(ctx)

In this example, Google Application Default Credentials are used for authentication.

For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.

Other authentication options

To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:

iamService, err := iam.NewService(ctx, option.WithAPIKey("AIza..."))

To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:

config := &oauth2.Config{...}
// ...
token, err := config.Exchange(ctx, ...)
iamService, err := iam.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))

See https://godoc.org/google.golang.org/api/option/ for details on options.

Index

Package Files

iam-gen.go

Constants

const (
    // View and manage your data across Google Cloud Platform services
    CloudPlatformScope = "https://www.googleapis.com/auth/cloud-platform"
)

OAuth2 scopes used by this API.

type AdminAuditData Uses

type AdminAuditData struct {
    // PermissionDelta: The permission_delta when when creating or updating
    // a Role.
    PermissionDelta *PermissionDelta `json:"permissionDelta,omitempty"`

    // ForceSendFields is a list of field names (e.g. "PermissionDelta") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "PermissionDelta") to
    // include in API requests with the JSON null value. By default, fields
    // with empty values are omitted from API requests. However, any field
    // with an empty value appearing in NullFields will be sent to the
    // server as null. It is an error if a field in this list has a
    // non-empty value. This may be used to include null fields in Patch
    // requests.
    NullFields []string `json:"-"`
}

AdminAuditData: Audit log information specific to Cloud IAM admin APIs. This message is serialized as an `Any` type in the `ServiceData` message of an `AuditLog` message.

func (*AdminAuditData) MarshalJSON Uses

func (s *AdminAuditData) MarshalJSON() ([]byte, error)

type AuditConfig Uses

type AuditConfig struct {
    // AuditLogConfigs: The configuration for logging of each type of
    // permission.
    AuditLogConfigs []*AuditLogConfig `json:"auditLogConfigs,omitempty"`

    // Service: Specifies a service that will be enabled for audit
    // logging.
    // For example, `storage.googleapis.com`,
    // `cloudsql.googleapis.com`.
    // `allServices` is a special value that covers all services.
    Service string `json:"service,omitempty"`

    // ForceSendFields is a list of field names (e.g. "AuditLogConfigs") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "AuditLogConfigs") to
    // include in API requests with the JSON null value. By default, fields
    // with empty values are omitted from API requests. However, any field
    // with an empty value appearing in NullFields will be sent to the
    // server as null. It is an error if a field in this list has a
    // non-empty value. This may be used to include null fields in Patch
    // requests.
    NullFields []string `json:"-"`
}

AuditConfig: Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs.

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 AuditLogConfig are exempted.

Example Policy with multiple AuditConfigs:

{
  "audit_configs": [
    {
      "service": "allServices"
      "audit_log_configs": [
        {
          "log_type": "DATA_READ",
          "exempted_members": [
            "user:jose@example.com"
          ]
        },
        {
          "log_type": "DATA_WRITE",
        },
        {
          "log_type": "ADMIN_READ",
        }
      ]
    },
    {
      "service": "sampleservice.googleapis.com"
      "audit_log_configs": [
        {
          "log_type": "DATA_READ",
        },
        {
          "log_type": "DATA_WRITE",
          "exempted_members": [
            "user:aliya@example.com"
          ]
        }
      ]
    }
  ]
}

For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts jose@example.com from DATA_READ logging, and aliya@example.com from DATA_WRITE logging.

func (*AuditConfig) MarshalJSON Uses

func (s *AuditConfig) MarshalJSON() ([]byte, error)

type AuditData Uses

type AuditData struct {
    // PolicyDelta: Policy delta between the original policy and the newly
    // set policy.
    PolicyDelta *PolicyDelta `json:"policyDelta,omitempty"`

    // ForceSendFields is a list of field names (e.g. "PolicyDelta") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "PolicyDelta") to include
    // in API requests with the JSON null value. By default, fields with
    // empty values are omitted from API requests. However, any field with
    // an empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

AuditData: Audit log information specific to Cloud IAM. This message is serialized as an `Any` type in the `ServiceData` message of an `AuditLog` message.

func (*AuditData) MarshalJSON Uses

func (s *AuditData) MarshalJSON() ([]byte, error)

type AuditLogConfig Uses

type AuditLogConfig struct {
    // ExemptedMembers: Specifies the identities that do not cause logging
    // for this type of
    // permission.
    // Follows the same format of Binding.members.
    ExemptedMembers []string `json:"exemptedMembers,omitempty"`

    // LogType: The log type that this config enables.
    //
    // Possible values:
    //   "LOG_TYPE_UNSPECIFIED" - Default case. Should never be this.
    //   "ADMIN_READ" - Admin reads. Example: CloudIAM getIamPolicy
    //   "DATA_WRITE" - Data writes. Example: CloudSQL Users create
    //   "DATA_READ" - Data reads. Example: CloudSQL Users list
    LogType string `json:"logType,omitempty"`

    // ForceSendFields is a list of field names (e.g. "ExemptedMembers") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "ExemptedMembers") to
    // include in API requests with the JSON null value. By default, fields
    // with empty values are omitted from API requests. However, any field
    // with an empty value appearing in NullFields will be sent to the
    // server as null. It is an error if a field in this list has a
    // non-empty value. This may be used to include null fields in Patch
    // requests.
    NullFields []string `json:"-"`
}

AuditLogConfig: Provides the configuration for logging a type of permissions. Example:

{
  "audit_log_configs": [
    {
      "log_type": "DATA_READ",
      "exempted_members": [
        "user:jose@example.com"
      ]
    },
    {
      "log_type": "DATA_WRITE",
    }
  ]
}

This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting jose@example.com from DATA_READ logging.

func (*AuditLogConfig) MarshalJSON Uses

func (s *AuditLogConfig) MarshalJSON() ([]byte, error)

type AuditableService Uses

type AuditableService struct {
    // Name: Public name of the service.
    // For example, the service name for Cloud IAM is 'iam.googleapis.com'.
    Name string `json:"name,omitempty"`

    // ForceSendFields is a list of field names (e.g. "Name") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Name") to include in API
    // requests with the JSON null value. By default, fields with empty
    // values are omitted from API requests. However, any field with an
    // empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

AuditableService: Contains information about an auditable service.

func (*AuditableService) MarshalJSON Uses

func (s *AuditableService) MarshalJSON() ([]byte, error)

type Binding Uses

type Binding struct {
    // Condition: 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.
    Condition *Expr `json:"condition,omitempty"`

    // 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@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}`: The G Suite domain (primary) that represents all
    // the
    //    users of that domain. For example, `google.com` or
    // `example.com`.
    //
    //
    Members []string `json:"members,omitempty"`

    // Role: Role that is assigned to `members`.
    // For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
    Role string `json:"role,omitempty"`

    // ForceSendFields is a list of field names (e.g. "Condition") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Condition") to include in
    // API requests with the JSON null value. By default, fields with empty
    // values are omitted from API requests. However, any field with an
    // empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

Binding: Associates `members` with a `role`.

func (*Binding) MarshalJSON Uses

func (s *Binding) MarshalJSON() ([]byte, error)

type BindingDelta Uses

type BindingDelta struct {
    // Action: The action that was performed on a Binding.
    // Required
    //
    // Possible values:
    //   "ACTION_UNSPECIFIED" - Unspecified.
    //   "ADD" - Addition of a Binding.
    //   "REMOVE" - Removal of a Binding.
    Action string `json:"action,omitempty"`

    // Condition: The condition that is associated with this binding.
    Condition *Expr `json:"condition,omitempty"`

    // Member: A single identity requesting access for a Cloud Platform
    // resource.
    // Follows the same format of Binding.members.
    // Required
    Member string `json:"member,omitempty"`

    // Role: Role that is assigned to `members`.
    // For example, `roles/viewer`, `roles/editor`, or
    // `roles/owner`.
    // Required
    Role string `json:"role,omitempty"`

    // ForceSendFields is a list of field names (e.g. "Action") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Action") to include in API
    // requests with the JSON null value. By default, fields with empty
    // values are omitted from API requests. However, any field with an
    // empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

BindingDelta: One delta entry for Binding. Each individual change (only one member in each entry) to a binding will be a separate entry.

func (*BindingDelta) MarshalJSON Uses

func (s *BindingDelta) MarshalJSON() ([]byte, error)

type CreateRoleRequest Uses

type CreateRoleRequest struct {
    // Role: The Role resource to create.
    Role *Role `json:"role,omitempty"`

    // RoleId: The role ID to use for this role.
    RoleId string `json:"roleId,omitempty"`

    // ForceSendFields is a list of field names (e.g. "Role") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Role") to include in API
    // requests with the JSON null value. By default, fields with empty
    // values are omitted from API requests. However, any field with an
    // empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

CreateRoleRequest: The request to create a new role.

func (*CreateRoleRequest) MarshalJSON Uses

func (s *CreateRoleRequest) MarshalJSON() ([]byte, error)

type CreateServiceAccountKeyRequest Uses

type CreateServiceAccountKeyRequest struct {
    // KeyAlgorithm: Which type of key and algorithm to use for the key.
    // The default is currently a 2K RSA key.  However this may change in
    // the
    // future.
    //
    // Possible values:
    //   "KEY_ALG_UNSPECIFIED" - An unspecified key algorithm.
    //   "KEY_ALG_RSA_1024" - 1k RSA Key.
    //   "KEY_ALG_RSA_2048" - 2k RSA Key.
    KeyAlgorithm string `json:"keyAlgorithm,omitempty"`

    // PrivateKeyType: The output format of the private key. The default
    // value is
    // `TYPE_GOOGLE_CREDENTIALS_FILE`, which is the Google Credentials
    // File
    // format.
    //
    // Possible values:
    //   "TYPE_UNSPECIFIED" - Unspecified. Equivalent to
    // `TYPE_GOOGLE_CREDENTIALS_FILE`.
    //   "TYPE_PKCS12_FILE" - PKCS12 format.
    // The password for the PKCS12 file is `notasecret`.
    // For more information, see https://tools.ietf.org/html/rfc7292.
    //   "TYPE_GOOGLE_CREDENTIALS_FILE" - Google Credentials File format.
    PrivateKeyType string `json:"privateKeyType,omitempty"`

    // ForceSendFields is a list of field names (e.g. "KeyAlgorithm") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "KeyAlgorithm") to include
    // in API requests with the JSON null value. By default, fields with
    // empty values are omitted from API requests. However, any field with
    // an empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

CreateServiceAccountKeyRequest: The service account key create request.

func (*CreateServiceAccountKeyRequest) MarshalJSON Uses

func (s *CreateServiceAccountKeyRequest) MarshalJSON() ([]byte, error)

type CreateServiceAccountRequest Uses

type CreateServiceAccountRequest struct {
    // AccountId: Required. The account id that is used to generate the
    // service account
    // email address and a stable unique id. It is unique within a
    // project,
    // must be 6-30 characters long, and match the regular
    // expression
    // `[a-z]([-a-z0-9]*[a-z0-9])` to comply with RFC1035.
    AccountId string `json:"accountId,omitempty"`

    // ServiceAccount: The ServiceAccount resource to
    // create. Currently, only the following values are user
    // assignable:
    // `display_name` .
    ServiceAccount *ServiceAccount `json:"serviceAccount,omitempty"`

    // ForceSendFields is a list of field names (e.g. "AccountId") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "AccountId") to include in
    // API requests with the JSON null value. By default, fields with empty
    // values are omitted from API requests. However, any field with an
    // empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

CreateServiceAccountRequest: The service account create request.

func (*CreateServiceAccountRequest) MarshalJSON Uses

func (s *CreateServiceAccountRequest) MarshalJSON() ([]byte, error)

type DisableServiceAccountRequest Uses

type DisableServiceAccountRequest struct {
}

DisableServiceAccountRequest: The service account disable request.

type Empty Uses

type Empty struct {
    // ServerResponse contains the HTTP response code and headers from the
    // server.
    googleapi.ServerResponse `json:"-"`
}

Empty: A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance:

service Foo {
  rpc Bar(google.protobuf.Empty) returns

(google.protobuf.Empty);

}

The JSON representation for `Empty` is empty JSON object `{}`.

type EnableServiceAccountRequest Uses

type EnableServiceAccountRequest struct {
}

EnableServiceAccountRequest: The service account enable request.

type Expr Uses

type Expr struct {
    // Description: An optional description of the expression. This is a
    // longer text which
    // describes the expression, e.g. when hovered over it in a UI.
    Description string `json:"description,omitempty"`

    // Expression: 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.
    Expression string `json:"expression,omitempty"`

    // Location: An optional string indicating the location of the
    // expression for error
    // reporting, e.g. a file name and a position in the file.
    Location string `json:"location,omitempty"`

    // Title: 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.
    Title string `json:"title,omitempty"`

    // ForceSendFields is a list of field names (e.g. "Description") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Description") to include
    // in API requests with the JSON null value. By default, fields with
    // empty values are omitted from API requests. However, any field with
    // an empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

Expr: Represents an expression text. Example:

title: "User account presence"
description: "Determines whether the request has a user account"
expression: "size(request.user) > 0"

func (*Expr) MarshalJSON Uses

func (s *Expr) MarshalJSON() ([]byte, error)

type IamPoliciesLintPolicyCall Uses

type IamPoliciesLintPolicyCall struct {
    // contains filtered or unexported fields
}

func (*IamPoliciesLintPolicyCall) Context Uses

func (c *IamPoliciesLintPolicyCall) Context(ctx context.Context) *IamPoliciesLintPolicyCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*IamPoliciesLintPolicyCall) Do Uses

func (c *IamPoliciesLintPolicyCall) Do(opts ...googleapi.CallOption) (*LintPolicyResponse, error)

Do executes the "iam.iamPolicies.lintPolicy" call. Exactly one of *LintPolicyResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *LintPolicyResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*IamPoliciesLintPolicyCall) Fields Uses

func (c *IamPoliciesLintPolicyCall) Fields(s ...googleapi.Field) *IamPoliciesLintPolicyCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*IamPoliciesLintPolicyCall) Header Uses

func (c *IamPoliciesLintPolicyCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type IamPoliciesQueryAuditableServicesCall Uses

type IamPoliciesQueryAuditableServicesCall struct {
    // contains filtered or unexported fields
}

func (*IamPoliciesQueryAuditableServicesCall) Context Uses

func (c *IamPoliciesQueryAuditableServicesCall) Context(ctx context.Context) *IamPoliciesQueryAuditableServicesCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*IamPoliciesQueryAuditableServicesCall) Do Uses

func (c *IamPoliciesQueryAuditableServicesCall) Do(opts ...googleapi.CallOption) (*QueryAuditableServicesResponse, error)

Do executes the "iam.iamPolicies.queryAuditableServices" call. Exactly one of *QueryAuditableServicesResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *QueryAuditableServicesResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*IamPoliciesQueryAuditableServicesCall) Fields Uses

func (c *IamPoliciesQueryAuditableServicesCall) Fields(s ...googleapi.Field) *IamPoliciesQueryAuditableServicesCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*IamPoliciesQueryAuditableServicesCall) Header Uses

func (c *IamPoliciesQueryAuditableServicesCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type IamPoliciesService Uses

type IamPoliciesService struct {
    // contains filtered or unexported fields
}

func NewIamPoliciesService Uses

func NewIamPoliciesService(s *Service) *IamPoliciesService

func (*IamPoliciesService) LintPolicy Uses

func (r *IamPoliciesService) LintPolicy(lintpolicyrequest *LintPolicyRequest) *IamPoliciesLintPolicyCall

LintPolicy: Lints a Cloud IAM policy object or its sub fields. Currently supports google.iam.v1.Policy, google.iam.v1.Binding and google.iam.v1.Binding.condition.

Each lint operation consists of multiple lint validation units. Validation units have the following properties:

- Each unit inspects the input object in regard to a particular

linting aspect and issues a google.iam.admin.v1.LintResult
disclosing the result.

- Domain of discourse of each unit can be either

google.iam.v1.Policy, google.iam.v1.Binding, or
google.iam.v1.Binding.condition depending on the purpose of the
validation.

- A unit may require additional data (like the list of all possible

enumerable values of a particular attribute used in the policy

instance)

which shall be provided by the caller. Refer to the comments of
google.iam.admin.v1.LintPolicyRequest.context for more

details.

The set of applicable validation units is determined by the Cloud IAM server and is not configurable.

Regardless of any lint issues or their severities, successful calls to `lintPolicy` return an HTTP 200 OK status code.

func (*IamPoliciesService) QueryAuditableServices Uses

func (r *IamPoliciesService) QueryAuditableServices(queryauditableservicesrequest *QueryAuditableServicesRequest) *IamPoliciesQueryAuditableServicesCall

QueryAuditableServices: Returns a list of services that support service level audit logging configuration for the given resource.

type LintPolicyRequest Uses

type LintPolicyRequest struct {
    // Binding: Binding object to be linted. The functionality of linting a
    // binding is
    // not yet implemented and if this field is set, it returns
    // NOT_IMPLEMENTED
    // error.
    Binding *Binding `json:"binding,omitempty"`

    // Condition: google.iam.v1.Binding.condition object to be linted.
    Condition *Expr `json:"condition,omitempty"`

    // Context: `context` contains additional *permission-controlled* data
    // that any
    // lint unit may depend on, in form of `{key: value}` pairs. Currently,
    // this
    // field is non-operational and it will not be used during the lint
    // operation.
    Context googleapi.RawMessage `json:"context,omitempty"`

    // FullResourceName: The full resource name of the policy this lint
    // request is about.
    //
    // The name follows the Google Cloud Platform (GCP) resource format.
    // For example, a GCP project with ID `my-project` will be
    // named
    // `//cloudresourcemanager.googleapis.com/projects/my-project`.
    //
    // Th
    // e resource name is not used to read the policy instance from the
    // Cloud
    // IAM database. The candidate policy for lint has to be provided in the
    // same
    // request object.
    FullResourceName string `json:"fullResourceName,omitempty"`

    // Policy: Policy object to be linted. The functionality of linting a
    // policy is not
    // yet implemented and if this field is set, it returns
    // NOT_IMPLEMENTED
    // error.
    Policy *Policy `json:"policy,omitempty"`

    // ForceSendFields is a list of field names (e.g. "Binding") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Binding") to include in
    // API requests with the JSON null value. By default, fields with empty
    // values are omitted from API requests. However, any field with an
    // empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

LintPolicyRequest: The request to lint a Cloud IAM policy object. LintPolicy is currently functional only for `lint_object` of type `condition`.

func (*LintPolicyRequest) MarshalJSON Uses

func (s *LintPolicyRequest) MarshalJSON() ([]byte, error)

type LintPolicyResponse Uses

type LintPolicyResponse struct {
    // LintResults: List of lint results sorted by a composite <severity,
    // binding_ordinal> key,
    // descending order of severity and ascending order of
    // binding_ordinal.
    // There is no certain order among the same keys.
    //
    // For cross-binding results (only if the input object to lint
    // is
    // instance of google.iam.v1.Policy), there will be
    // a
    // google.iam.admin.v1.LintResult for each of the involved bindings,
    // and the associated debug_message may enumerate the other
    // involved
    // binding ordinal number(s).
    LintResults []*LintResult `json:"lintResults,omitempty"`

    // ServerResponse contains the HTTP response code and headers from the
    // server.
    googleapi.ServerResponse `json:"-"`

    // ForceSendFields is a list of field names (e.g. "LintResults") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "LintResults") to include
    // in API requests with the JSON null value. By default, fields with
    // empty values are omitted from API requests. However, any field with
    // an empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

LintPolicyResponse: The response of a lint operation. An empty response indicates the operation was able to fully execute and no lint issue was found.

func (*LintPolicyResponse) MarshalJSON Uses

func (s *LintPolicyResponse) MarshalJSON() ([]byte, error)

type LintResult Uses

type LintResult struct {
    // BindingOrdinal: 0-based index ordinality of the binding in the input
    // object associated
    // with this result.
    // This field is populated only if the input object to lint is of
    // type
    // google.iam.v1.Policy, which can comprise more than one binding.
    // It is set to -1 if the result is not associated with any
    // particular
    // binding and only targets the policy as a whole, such as results
    // about
    // policy size violations.
    BindingOrdinal int64 `json:"bindingOrdinal,omitempty"`

    // DebugMessage: Human readable debug message associated with the issue.
    DebugMessage string `json:"debugMessage,omitempty"`

    // FieldName: The name of the field for which this lint result is
    // about.
    //
    // For nested messages, `field_name` consists of names of the embedded
    // fields
    // separated by period character. The top-level qualifier is the input
    // object
    // to lint in the request. For instance, if the lint request is on
    // a
    // google.iam.v1.Policy and this lint result is about a
    // condition
    // expression of one of the input policy bindings, the field would
    // be
    // populated as `policy.bindings.condition.expression`.
    //
    // This field does not identify the ordinality of the repetitive fields
    // (for
    // instance bindings in a policy).
    FieldName string `json:"fieldName,omitempty"`

    // Level: The validation unit level.
    //
    // Possible values:
    //   "LEVEL_UNSPECIFIED" - Level is unspecified.
    //   "POLICY" - A validation unit which operates on a policy. It is
    // executed only if the
    // input object to lint is of type google.iam.v1.Policy.
    //   "BINDING" - A validation unit which operates on an individual
    // binding. It is executed
    // in both cases where the input object to lint is of
    // type
    // google.iam.v1.Policy or google.iam.v1.Binding.
    //   "CONDITION" - A validation unit which operates on an individual
    // condition within a
    // binding. It is executed in all three cases where the input object
    // to
    // lint is of type google.iam.v1.Policy,
    // google.iam.v1.Binding or
    // google.iam.v1.Binding.condition.
    Level string `json:"level,omitempty"`

    // LocationOffset: 0-based character position of problematic construct
    // within the object
    // identified by `field_name`. Currently, this is populated only for
    // condition
    // expression.
    LocationOffset int64 `json:"locationOffset,omitempty"`

    // Severity: The validation unit severity.
    //
    // Possible values:
    //   "SEVERITY_UNSPECIFIED" - Severity is unspecified.
    //   "ERROR" - A validation unit returns an error only for critical
    // issues. If an
    // attempt is made to set the problematic policy without rectifying
    // the
    // critical issue, it causes the `setPolicy` operation to fail.
    //   "WARNING" - Any issue which is severe enough but does not cause an
    // error.
    // For example, suspicious constructs in the input object will
    // not
    // necessarily fail `setPolicy`, but there is a high likelihood that
    // they
    // won't behave as expected during policy evaluation in
    // `checkPolicy`.
    // This includes the following common scenarios:
    //
    // - Unsatisfiable condition: Expired timestamp in date/time
    // condition.
    // - Ineffective condition: Condition on a <member, role> pair which is
    //   granted unconditionally in another binding of the same policy.
    //   "NOTICE" - Reserved for the issues that are not severe as
    // `ERROR`/`WARNING`, but
    // need special handling. For instance, messages about skipped
    // validation
    // units are issued as `NOTICE`.
    //   "INFO" - Any informative statement which is not severe enough to
    // raise
    // `ERROR`/`WARNING`/`NOTICE`, like auto-correction recommendations on
    // the
    // input content. Note that current version of the linter does not
    // utilize
    // `INFO`.
    //   "DEPRECATED" - Deprecated severity level.
    Severity string `json:"severity,omitempty"`

    // ValidationUnitName: The validation unit name, for
    // instance
    // "lintValidationUnits/ConditionComplexityCheck".
    ValidationUnitName string `json:"validationUnitName,omitempty"`

    // ForceSendFields is a list of field names (e.g. "BindingOrdinal") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "BindingOrdinal") to
    // include in API requests with the JSON null value. By default, fields
    // with empty values are omitted from API requests. However, any field
    // with an empty value appearing in NullFields will be sent to the
    // server as null. It is an error if a field in this list has a
    // non-empty value. This may be used to include null fields in Patch
    // requests.
    NullFields []string `json:"-"`
}

LintResult: Structured response of a single validation unit.

func (*LintResult) MarshalJSON Uses

func (s *LintResult) MarshalJSON() ([]byte, error)

type ListRolesResponse Uses

type ListRolesResponse struct {
    // NextPageToken: To retrieve the next page of results,
    // set
    // `ListRolesRequest.page_token` to this value.
    NextPageToken string `json:"nextPageToken,omitempty"`

    // Roles: The Roles defined on this resource.
    Roles []*Role `json:"roles,omitempty"`

    // ServerResponse contains the HTTP response code and headers from the
    // server.
    googleapi.ServerResponse `json:"-"`

    // ForceSendFields is a list of field names (e.g. "NextPageToken") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "NextPageToken") to include
    // in API requests with the JSON null value. By default, fields with
    // empty values are omitted from API requests. However, any field with
    // an empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

ListRolesResponse: The response containing the roles defined under a resource.

func (*ListRolesResponse) MarshalJSON Uses

func (s *ListRolesResponse) MarshalJSON() ([]byte, error)

type ListServiceAccountKeysResponse Uses

type ListServiceAccountKeysResponse struct {
    // Keys: The public keys for the service account.
    Keys []*ServiceAccountKey `json:"keys,omitempty"`

    // ServerResponse contains the HTTP response code and headers from the
    // server.
    googleapi.ServerResponse `json:"-"`

    // ForceSendFields is a list of field names (e.g. "Keys") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Keys") to include in API
    // requests with the JSON null value. By default, fields with empty
    // values are omitted from API requests. However, any field with an
    // empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

ListServiceAccountKeysResponse: The service account keys list response.

func (*ListServiceAccountKeysResponse) MarshalJSON Uses

func (s *ListServiceAccountKeysResponse) MarshalJSON() ([]byte, error)

type ListServiceAccountsResponse Uses

type ListServiceAccountsResponse struct {
    // Accounts: The list of matching service accounts.
    Accounts []*ServiceAccount `json:"accounts,omitempty"`

    // NextPageToken: To retrieve the next page of results,
    // set
    // ListServiceAccountsRequest.page_token
    // to this value.
    NextPageToken string `json:"nextPageToken,omitempty"`

    // ServerResponse contains the HTTP response code and headers from the
    // server.
    googleapi.ServerResponse `json:"-"`

    // ForceSendFields is a list of field names (e.g. "Accounts") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Accounts") to include in
    // API requests with the JSON null value. By default, fields with empty
    // values are omitted from API requests. However, any field with an
    // empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

ListServiceAccountsResponse: The service account list response.

func (*ListServiceAccountsResponse) MarshalJSON Uses

func (s *ListServiceAccountsResponse) MarshalJSON() ([]byte, error)

type OrganizationsRolesCreateCall Uses

type OrganizationsRolesCreateCall struct {
    // contains filtered or unexported fields
}

func (*OrganizationsRolesCreateCall) Context Uses

func (c *OrganizationsRolesCreateCall) Context(ctx context.Context) *OrganizationsRolesCreateCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*OrganizationsRolesCreateCall) Do Uses

func (c *OrganizationsRolesCreateCall) Do(opts ...googleapi.CallOption) (*Role, error)

Do executes the "iam.organizations.roles.create" call. Exactly one of *Role or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Role.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*OrganizationsRolesCreateCall) Fields Uses

func (c *OrganizationsRolesCreateCall) Fields(s ...googleapi.Field) *OrganizationsRolesCreateCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*OrganizationsRolesCreateCall) Header Uses

func (c *OrganizationsRolesCreateCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type OrganizationsRolesDeleteCall Uses

type OrganizationsRolesDeleteCall struct {
    // contains filtered or unexported fields
}

func (*OrganizationsRolesDeleteCall) Context Uses

func (c *OrganizationsRolesDeleteCall) Context(ctx context.Context) *OrganizationsRolesDeleteCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*OrganizationsRolesDeleteCall) Do Uses

func (c *OrganizationsRolesDeleteCall) Do(opts ...googleapi.CallOption) (*Role, error)

Do executes the "iam.organizations.roles.delete" call. Exactly one of *Role or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Role.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*OrganizationsRolesDeleteCall) Etag Uses

func (c *OrganizationsRolesDeleteCall) Etag(etag string) *OrganizationsRolesDeleteCall

Etag sets the optional parameter "etag": Used to perform a consistent read-modify-write.

func (*OrganizationsRolesDeleteCall) Fields Uses

func (c *OrganizationsRolesDeleteCall) Fields(s ...googleapi.Field) *OrganizationsRolesDeleteCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*OrganizationsRolesDeleteCall) Header Uses

func (c *OrganizationsRolesDeleteCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type OrganizationsRolesGetCall Uses

type OrganizationsRolesGetCall struct {
    // contains filtered or unexported fields
}

func (*OrganizationsRolesGetCall) Context Uses

func (c *OrganizationsRolesGetCall) Context(ctx context.Context) *OrganizationsRolesGetCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*OrganizationsRolesGetCall) Do Uses

func (c *OrganizationsRolesGetCall) Do(opts ...googleapi.CallOption) (*Role, error)

Do executes the "iam.organizations.roles.get" call. Exactly one of *Role or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Role.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*OrganizationsRolesGetCall) Fields Uses

func (c *OrganizationsRolesGetCall) Fields(s ...googleapi.Field) *OrganizationsRolesGetCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*OrganizationsRolesGetCall) Header Uses

func (c *OrganizationsRolesGetCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*OrganizationsRolesGetCall) IfNoneMatch Uses

func (c *OrganizationsRolesGetCall) IfNoneMatch(entityTag string) *OrganizationsRolesGetCall

IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

type OrganizationsRolesListCall Uses

type OrganizationsRolesListCall struct {
    // contains filtered or unexported fields
}

func (*OrganizationsRolesListCall) Context Uses

func (c *OrganizationsRolesListCall) Context(ctx context.Context) *OrganizationsRolesListCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*OrganizationsRolesListCall) Do Uses

func (c *OrganizationsRolesListCall) Do(opts ...googleapi.CallOption) (*ListRolesResponse, error)

Do executes the "iam.organizations.roles.list" call. Exactly one of *ListRolesResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ListRolesResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*OrganizationsRolesListCall) Fields Uses

func (c *OrganizationsRolesListCall) Fields(s ...googleapi.Field) *OrganizationsRolesListCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*OrganizationsRolesListCall) Header Uses

func (c *OrganizationsRolesListCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*OrganizationsRolesListCall) IfNoneMatch Uses

func (c *OrganizationsRolesListCall) IfNoneMatch(entityTag string) *OrganizationsRolesListCall

IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

func (*OrganizationsRolesListCall) PageSize Uses

func (c *OrganizationsRolesListCall) PageSize(pageSize int64) *OrganizationsRolesListCall

PageSize sets the optional parameter "pageSize": Optional limit on the number of roles to include in the response.

func (*OrganizationsRolesListCall) PageToken Uses

func (c *OrganizationsRolesListCall) PageToken(pageToken string) *OrganizationsRolesListCall

PageToken sets the optional parameter "pageToken": Optional pagination token returned in an earlier ListRolesResponse.

func (*OrganizationsRolesListCall) Pages Uses

func (c *OrganizationsRolesListCall) Pages(ctx context.Context, f func(*ListRolesResponse) error) error

Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.

func (*OrganizationsRolesListCall) ShowDeleted Uses

func (c *OrganizationsRolesListCall) ShowDeleted(showDeleted bool) *OrganizationsRolesListCall

ShowDeleted sets the optional parameter "showDeleted": Include Roles that have been deleted.

func (*OrganizationsRolesListCall) View Uses

func (c *OrganizationsRolesListCall) View(view string) *OrganizationsRolesListCall

View sets the optional parameter "view": Optional view for the returned Role objects. When `FULL` is specified, the `includedPermissions` field is returned, which includes a list of all permissions in the role. The default value is `BASIC`, which does not return the `includedPermissions` field.

Possible values:

"BASIC"
"FULL"

type OrganizationsRolesPatchCall Uses

type OrganizationsRolesPatchCall struct {
    // contains filtered or unexported fields
}

func (*OrganizationsRolesPatchCall) Context Uses

func (c *OrganizationsRolesPatchCall) Context(ctx context.Context) *OrganizationsRolesPatchCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*OrganizationsRolesPatchCall) Do Uses

func (c *OrganizationsRolesPatchCall) Do(opts ...googleapi.CallOption) (*Role, error)

Do executes the "iam.organizations.roles.patch" call. Exactly one of *Role or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Role.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*OrganizationsRolesPatchCall) Fields Uses

func (c *OrganizationsRolesPatchCall) Fields(s ...googleapi.Field) *OrganizationsRolesPatchCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*OrganizationsRolesPatchCall) Header Uses

func (c *OrganizationsRolesPatchCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*OrganizationsRolesPatchCall) UpdateMask Uses

func (c *OrganizationsRolesPatchCall) UpdateMask(updateMask string) *OrganizationsRolesPatchCall

UpdateMask sets the optional parameter "updateMask": A mask describing which fields in the Role have changed.

type OrganizationsRolesService Uses

type OrganizationsRolesService struct {
    // contains filtered or unexported fields
}

func NewOrganizationsRolesService Uses

func NewOrganizationsRolesService(s *Service) *OrganizationsRolesService

func (*OrganizationsRolesService) Create Uses

func (r *OrganizationsRolesService) Create(parent string, createrolerequest *CreateRoleRequest) *OrganizationsRolesCreateCall

Create: Creates a new Role.

func (*OrganizationsRolesService) Delete Uses

func (r *OrganizationsRolesService) Delete(name string) *OrganizationsRolesDeleteCall

Delete: Soft deletes a role. The role is suspended and cannot be used to create new IAM Policy Bindings. The Role will not be included in `ListRoles()` unless `show_deleted` is set in the `ListRolesRequest`. The Role contains the deleted boolean set. Existing Bindings remains, but are inactive. The Role can be undeleted within 7 days. After 7 days the Role is deleted and all Bindings associated with the role are removed.

func (*OrganizationsRolesService) Get Uses

func (r *OrganizationsRolesService) Get(name string) *OrganizationsRolesGetCall

Get: Gets a Role definition.

func (*OrganizationsRolesService) List Uses

func (r *OrganizationsRolesService) List(parent string) *OrganizationsRolesListCall

List: Lists the Roles defined on a resource.

func (*OrganizationsRolesService) Patch Uses

func (r *OrganizationsRolesService) Patch(name string, role *Role) *OrganizationsRolesPatchCall

Patch: Updates a Role definition.

func (*OrganizationsRolesService) Undelete Uses

func (r *OrganizationsRolesService) Undelete(name string, undeleterolerequest *UndeleteRoleRequest) *OrganizationsRolesUndeleteCall

Undelete: Undelete a Role, bringing it back in its previous state.

type OrganizationsRolesUndeleteCall Uses

type OrganizationsRolesUndeleteCall struct {
    // contains filtered or unexported fields
}

func (*OrganizationsRolesUndeleteCall) Context Uses

func (c *OrganizationsRolesUndeleteCall) Context(ctx context.Context) *OrganizationsRolesUndeleteCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*OrganizationsRolesUndeleteCall) Do Uses

func (c *OrganizationsRolesUndeleteCall) Do(opts ...googleapi.CallOption) (*Role, error)

Do executes the "iam.organizations.roles.undelete" call. Exactly one of *Role or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Role.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*OrganizationsRolesUndeleteCall) Fields Uses

func (c *OrganizationsRolesUndeleteCall) Fields(s ...googleapi.Field) *OrganizationsRolesUndeleteCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*OrganizationsRolesUndeleteCall) Header Uses

func (c *OrganizationsRolesUndeleteCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type OrganizationsService Uses

type OrganizationsService struct {
    Roles *OrganizationsRolesService
    // contains filtered or unexported fields
}

func NewOrganizationsService Uses

func NewOrganizationsService(s *Service) *OrganizationsService

type PatchServiceAccountRequest Uses

type PatchServiceAccountRequest struct {
    ServiceAccount *ServiceAccount `json:"serviceAccount,omitempty"`

    UpdateMask string `json:"updateMask,omitempty"`

    // ForceSendFields is a list of field names (e.g. "ServiceAccount") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "ServiceAccount") to
    // include in API requests with the JSON null value. By default, fields
    // with empty values are omitted from API requests. However, any field
    // with an empty value appearing in NullFields will be sent to the
    // server as null. It is an error if a field in this list has a
    // non-empty value. This may be used to include null fields in Patch
    // requests.
    NullFields []string `json:"-"`
}

PatchServiceAccountRequest: The patch service account request.

func (*PatchServiceAccountRequest) MarshalJSON Uses

func (s *PatchServiceAccountRequest) MarshalJSON() ([]byte, error)

type Permission Uses

type Permission struct {
    // ApiDisabled: The service API associated with the permission is not
    // enabled.
    ApiDisabled bool `json:"apiDisabled,omitempty"`

    // CustomRolesSupportLevel: The current custom role support level.
    //
    // Possible values:
    //   "SUPPORTED" - Permission is fully supported for custom role use.
    //   "TESTING" - Permission is being tested to check custom role
    // compatibility.
    //   "NOT_SUPPORTED" - Permission is not supported for custom role use.
    CustomRolesSupportLevel string `json:"customRolesSupportLevel,omitempty"`

    // Description: A brief description of what this Permission is used
    // for.
    // This permission can ONLY be used in predefined roles.
    Description string `json:"description,omitempty"`

    // Name: The name of this Permission.
    Name string `json:"name,omitempty"`

    OnlyInPredefinedRoles bool `json:"onlyInPredefinedRoles,omitempty"`

    // PrimaryPermission: The preferred name for this permission. If
    // present, then this permission is
    // an alias of, and equivalent to, the listed primary_permission.
    PrimaryPermission string `json:"primaryPermission,omitempty"`

    // Stage: The current launch stage of the permission.
    //
    // Possible values:
    //   "ALPHA" - The permission is currently in an alpha phase.
    //   "BETA" - The permission is currently in a beta phase.
    //   "GA" - The permission is generally available.
    //   "DEPRECATED" - The permission is being deprecated.
    Stage string `json:"stage,omitempty"`

    // Title: The title of this Permission.
    Title string `json:"title,omitempty"`

    // ForceSendFields is a list of field names (e.g. "ApiDisabled") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "ApiDisabled") to include
    // in API requests with the JSON null value. By default, fields with
    // empty values are omitted from API requests. However, any field with
    // an empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

Permission: A permission which can be included by a role.

func (*Permission) MarshalJSON Uses

func (s *Permission) MarshalJSON() ([]byte, error)

type PermissionDelta Uses

type PermissionDelta struct {
    // AddedPermissions: Added permissions.
    AddedPermissions []string `json:"addedPermissions,omitempty"`

    // RemovedPermissions: Removed permissions.
    RemovedPermissions []string `json:"removedPermissions,omitempty"`

    // ForceSendFields is a list of field names (e.g. "AddedPermissions") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "AddedPermissions") to
    // include in API requests with the JSON null value. By default, fields
    // with empty values are omitted from API requests. However, any field
    // with an empty value appearing in NullFields will be sent to the
    // server as null. It is an error if a field in this list has a
    // non-empty value. This may be used to include null fields in Patch
    // requests.
    NullFields []string `json:"-"`
}

PermissionDelta: A PermissionDelta message to record the added_permissions and removed_permissions inside a role.

func (*PermissionDelta) MarshalJSON Uses

func (s *PermissionDelta) MarshalJSON() ([]byte, error)

type PermissionsQueryTestablePermissionsCall Uses

type PermissionsQueryTestablePermissionsCall struct {
    // contains filtered or unexported fields
}

func (*PermissionsQueryTestablePermissionsCall) Context Uses

func (c *PermissionsQueryTestablePermissionsCall) Context(ctx context.Context) *PermissionsQueryTestablePermissionsCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*PermissionsQueryTestablePermissionsCall) Do Uses

func (c *PermissionsQueryTestablePermissionsCall) Do(opts ...googleapi.CallOption) (*QueryTestablePermissionsResponse, error)

Do executes the "iam.permissions.queryTestablePermissions" call. Exactly one of *QueryTestablePermissionsResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *QueryTestablePermissionsResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*PermissionsQueryTestablePermissionsCall) Fields Uses

func (c *PermissionsQueryTestablePermissionsCall) Fields(s ...googleapi.Field) *PermissionsQueryTestablePermissionsCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*PermissionsQueryTestablePermissionsCall) Header Uses

func (c *PermissionsQueryTestablePermissionsCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*PermissionsQueryTestablePermissionsCall) Pages Uses

func (c *PermissionsQueryTestablePermissionsCall) Pages(ctx context.Context, f func(*QueryTestablePermissionsResponse) error) error

Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.

type PermissionsService Uses

type PermissionsService struct {
    // contains filtered or unexported fields
}

func NewPermissionsService Uses

func NewPermissionsService(s *Service) *PermissionsService

func (*PermissionsService) QueryTestablePermissions Uses

func (r *PermissionsService) QueryTestablePermissions(querytestablepermissionsrequest *QueryTestablePermissionsRequest) *PermissionsQueryTestablePermissionsCall

QueryTestablePermissions: Lists the permissions testable on a resource. A permission is testable if it can be tested for an identity on a resource.

type Policy Uses

type Policy struct {
    // AuditConfigs: Specifies cloud audit logging configuration for this
    // policy.
    AuditConfigs []*AuditConfig `json:"auditConfigs,omitempty"`

    // Bindings: Associates a list of `members` to a `role`. Optionally may
    // specify a
    // `condition` that determines when binding is in effect.
    // `bindings` with no members will result in an error.
    Bindings []*Binding `json:"bindings,omitempty"`

    // Etag: `etag` is used for optimistic concurrency control as a way to
    // help
    // prevent simultaneous updates of a policy from overwriting each
    // other.
    // It is strongly suggested that systems make use of the `etag` in
    // the
    // read-modify-write cycle to perform policy updates in order to avoid
    // race
    // conditions: An `etag` is returned in the response to `getIamPolicy`,
    // and
    // 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. Due to blind-set semantics of an etag-less
    // policy,
    // 'setIamPolicy' will not fail even if the incoming policy version does
    // not
    // meet the requirements for modifying the stored policy.
    Etag string `json:"etag,omitempty"`

    // Version: Specifies the format of the policy.
    //
    // Valid values are 0, 1, and 3. Requests specifying an invalid value
    // will be
    // rejected.
    //
    // Operations affecting conditional bindings must specify version 3.
    // This can
    // be either setting a conditional policy, modifying a conditional
    // binding,
    // or removing a binding (conditional or unconditional) from the
    // stored
    // conditional policy.
    // Operations on non-conditional policies may specify any valid value
    // or
    // leave the field unset.
    //
    // If no etag is provided in the call to `setIamPolicy`, version
    // compliance
    // checks against the stored policy is skipped.
    Version int64 `json:"version,omitempty"`

    // ServerResponse contains the HTTP response code and headers from the
    // server.
    googleapi.ServerResponse `json:"-"`

    // ForceSendFields is a list of field names (e.g. "AuditConfigs") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "AuditConfigs") to include
    // in API requests with the JSON null value. By default, fields with
    // empty values are omitted from API requests. However, any field with
    // an empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

Policy: Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources.

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 (defined by IAM or configured by users). A `binding` can optionally specify a `condition`, which is a logic expression that further constrains the role binding based on attributes about the request and/or target resource.

**JSON Example**

{
  "bindings": [
    {
      "role": "roles/resourcemanager.organizationAdmin",
      "members": [
        "user:mike@example.com",
        "group:admins@example.com",
        "domain:google.com",

"serviceAccount:my-project-id@appspot.gserviceaccount.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')",
      }
    }
  ]
}

**YAML Example**

bindings:
- members:
  - user:mike@example.com
  - group:admins@example.com
  - domain:google.com
  - serviceAccount:my-project-id@appspot.gserviceaccount.com
  role: roles/resourcemanager.organizationAdmin
- members:
  - 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')

For a description of IAM and its features, see the [IAM developer's guide](https://cloud.google.com/iam/docs).

func (*Policy) MarshalJSON Uses

func (s *Policy) MarshalJSON() ([]byte, error)

type PolicyDelta Uses

type PolicyDelta struct {
    // BindingDeltas: The delta for Bindings between two policies.
    BindingDeltas []*BindingDelta `json:"bindingDeltas,omitempty"`

    // ForceSendFields is a list of field names (e.g. "BindingDeltas") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "BindingDeltas") to include
    // in API requests with the JSON null value. By default, fields with
    // empty values are omitted from API requests. However, any field with
    // an empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

PolicyDelta: The difference delta between two policies.

func (*PolicyDelta) MarshalJSON Uses

func (s *PolicyDelta) MarshalJSON() ([]byte, error)

type ProjectsRolesCreateCall Uses

type ProjectsRolesCreateCall struct {
    // contains filtered or unexported fields
}

func (*ProjectsRolesCreateCall) Context Uses

func (c *ProjectsRolesCreateCall) Context(ctx context.Context) *ProjectsRolesCreateCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ProjectsRolesCreateCall) Do Uses

func (c *ProjectsRolesCreateCall) Do(opts ...googleapi.CallOption) (*Role, error)

Do executes the "iam.projects.roles.create" call. Exactly one of *Role or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Role.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ProjectsRolesCreateCall) Fields Uses

func (c *ProjectsRolesCreateCall) Fields(s ...googleapi.Field) *ProjectsRolesCreateCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ProjectsRolesCreateCall) Header Uses

func (c *ProjectsRolesCreateCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type ProjectsRolesDeleteCall Uses

type ProjectsRolesDeleteCall struct {
    // contains filtered or unexported fields
}

func (*ProjectsRolesDeleteCall) Context Uses

func (c *ProjectsRolesDeleteCall) Context(ctx context.Context) *ProjectsRolesDeleteCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ProjectsRolesDeleteCall) Do Uses

func (c *ProjectsRolesDeleteCall) Do(opts ...googleapi.CallOption) (*Role, error)

Do executes the "iam.projects.roles.delete" call. Exactly one of *Role or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Role.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ProjectsRolesDeleteCall) Etag Uses

func (c *ProjectsRolesDeleteCall) Etag(etag string) *ProjectsRolesDeleteCall

Etag sets the optional parameter "etag": Used to perform a consistent read-modify-write.

func (*ProjectsRolesDeleteCall) Fields Uses

func (c *ProjectsRolesDeleteCall) Fields(s ...googleapi.Field) *ProjectsRolesDeleteCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ProjectsRolesDeleteCall) Header Uses

func (c *ProjectsRolesDeleteCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type ProjectsRolesGetCall Uses

type ProjectsRolesGetCall struct {
    // contains filtered or unexported fields
}

func (*ProjectsRolesGetCall) Context Uses

func (c *ProjectsRolesGetCall) Context(ctx context.Context) *ProjectsRolesGetCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ProjectsRolesGetCall) Do Uses

func (c *ProjectsRolesGetCall) Do(opts ...googleapi.CallOption) (*Role, error)

Do executes the "iam.projects.roles.get" call. Exactly one of *Role or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Role.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ProjectsRolesGetCall) Fields Uses

func (c *ProjectsRolesGetCall) Fields(s ...googleapi.Field) *ProjectsRolesGetCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ProjectsRolesGetCall) Header Uses

func (c *ProjectsRolesGetCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*ProjectsRolesGetCall) IfNoneMatch Uses

func (c *ProjectsRolesGetCall) IfNoneMatch(entityTag string) *ProjectsRolesGetCall

IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

type ProjectsRolesListCall Uses

type ProjectsRolesListCall struct {
    // contains filtered or unexported fields
}

func (*ProjectsRolesListCall) Context Uses

func (c *ProjectsRolesListCall) Context(ctx context.Context) *ProjectsRolesListCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ProjectsRolesListCall) Do Uses

func (c *ProjectsRolesListCall) Do(opts ...googleapi.CallOption) (*ListRolesResponse, error)

Do executes the "iam.projects.roles.list" call. Exactly one of *ListRolesResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ListRolesResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ProjectsRolesListCall) Fields Uses

func (c *ProjectsRolesListCall) Fields(s ...googleapi.Field) *ProjectsRolesListCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ProjectsRolesListCall) Header Uses

func (c *ProjectsRolesListCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*ProjectsRolesListCall) IfNoneMatch Uses

func (c *ProjectsRolesListCall) IfNoneMatch(entityTag string) *ProjectsRolesListCall

IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

func (*ProjectsRolesListCall) PageSize Uses

func (c *ProjectsRolesListCall) PageSize(pageSize int64) *ProjectsRolesListCall

PageSize sets the optional parameter "pageSize": Optional limit on the number of roles to include in the response.

func (*ProjectsRolesListCall) PageToken Uses

func (c *ProjectsRolesListCall) PageToken(pageToken string) *ProjectsRolesListCall

PageToken sets the optional parameter "pageToken": Optional pagination token returned in an earlier ListRolesResponse.

func (*ProjectsRolesListCall) Pages Uses

func (c *ProjectsRolesListCall) Pages(ctx context.Context, f func(*ListRolesResponse) error) error

Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.

func (*ProjectsRolesListCall) ShowDeleted Uses

func (c *ProjectsRolesListCall) ShowDeleted(showDeleted bool) *ProjectsRolesListCall

ShowDeleted sets the optional parameter "showDeleted": Include Roles that have been deleted.

func (*ProjectsRolesListCall) View Uses

func (c *ProjectsRolesListCall) View(view string) *ProjectsRolesListCall

View sets the optional parameter "view": Optional view for the returned Role objects. When `FULL` is specified, the `includedPermissions` field is returned, which includes a list of all permissions in the role. The default value is `BASIC`, which does not return the `includedPermissions` field.

Possible values:

"BASIC"
"FULL"

type ProjectsRolesPatchCall Uses

type ProjectsRolesPatchCall struct {
    // contains filtered or unexported fields
}

func (*ProjectsRolesPatchCall) Context Uses

func (c *ProjectsRolesPatchCall) Context(ctx context.Context) *ProjectsRolesPatchCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ProjectsRolesPatchCall) Do Uses

func (c *ProjectsRolesPatchCall) Do(opts ...googleapi.CallOption) (*Role, error)

Do executes the "iam.projects.roles.patch" call. Exactly one of *Role or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Role.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ProjectsRolesPatchCall) Fields Uses

func (c *ProjectsRolesPatchCall) Fields(s ...googleapi.Field) *ProjectsRolesPatchCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ProjectsRolesPatchCall) Header Uses

func (c *ProjectsRolesPatchCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*ProjectsRolesPatchCall) UpdateMask Uses

func (c *ProjectsRolesPatchCall) UpdateMask(updateMask string) *ProjectsRolesPatchCall

UpdateMask sets the optional parameter "updateMask": A mask describing which fields in the Role have changed.

type ProjectsRolesService Uses

type ProjectsRolesService struct {
    // contains filtered or unexported fields
}

func NewProjectsRolesService Uses

func NewProjectsRolesService(s *Service) *ProjectsRolesService

func (*ProjectsRolesService) Create Uses

func (r *ProjectsRolesService) Create(parent string, createrolerequest *CreateRoleRequest) *ProjectsRolesCreateCall

Create: Creates a new Role.

func (*ProjectsRolesService) Delete Uses

func (r *ProjectsRolesService) Delete(name string) *ProjectsRolesDeleteCall

Delete: Soft deletes a role. The role is suspended and cannot be used to create new IAM Policy Bindings. The Role will not be included in `ListRoles()` unless `show_deleted` is set in the `ListRolesRequest`. The Role contains the deleted boolean set. Existing Bindings remains, but are inactive. The Role can be undeleted within 7 days. After 7 days the Role is deleted and all Bindings associated with the role are removed.

func (*ProjectsRolesService) Get Uses

func (r *ProjectsRolesService) Get(name string) *ProjectsRolesGetCall

Get: Gets a Role definition.

func (*ProjectsRolesService) List Uses

func (r *ProjectsRolesService) List(parent string) *ProjectsRolesListCall

List: Lists the Roles defined on a resource.

func (*ProjectsRolesService) Patch Uses

func (r *ProjectsRolesService) Patch(name string, role *Role) *ProjectsRolesPatchCall

Patch: Updates a Role definition.

func (*ProjectsRolesService) Undelete Uses

func (r *ProjectsRolesService) Undelete(name string, undeleterolerequest *UndeleteRoleRequest) *ProjectsRolesUndeleteCall

Undelete: Undelete a Role, bringing it back in its previous state.

type ProjectsRolesUndeleteCall Uses

type ProjectsRolesUndeleteCall struct {
    // contains filtered or unexported fields
}

func (*ProjectsRolesUndeleteCall) Context Uses

func (c *ProjectsRolesUndeleteCall) Context(ctx context.Context) *ProjectsRolesUndeleteCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ProjectsRolesUndeleteCall) Do Uses

func (c *ProjectsRolesUndeleteCall) Do(opts ...googleapi.CallOption) (*Role, error)

Do executes the "iam.projects.roles.undelete" call. Exactly one of *Role or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Role.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ProjectsRolesUndeleteCall) Fields Uses

func (c *ProjectsRolesUndeleteCall) Fields(s ...googleapi.Field) *ProjectsRolesUndeleteCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ProjectsRolesUndeleteCall) Header Uses

func (c *ProjectsRolesUndeleteCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type ProjectsService Uses

type ProjectsService struct {
    Roles *ProjectsRolesService

    ServiceAccounts *ProjectsServiceAccountsService
    // contains filtered or unexported fields
}

func NewProjectsService Uses

func NewProjectsService(s *Service) *ProjectsService

type ProjectsServiceAccountsCreateCall Uses

type ProjectsServiceAccountsCreateCall struct {
    // contains filtered or unexported fields
}

func (*ProjectsServiceAccountsCreateCall) Context Uses

func (c *ProjectsServiceAccountsCreateCall) Context(ctx context.Context) *ProjectsServiceAccountsCreateCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ProjectsServiceAccountsCreateCall) Do Uses

func (c *ProjectsServiceAccountsCreateCall) Do(opts ...googleapi.CallOption) (*ServiceAccount, error)

Do executes the "iam.projects.serviceAccounts.create" call. Exactly one of *ServiceAccount or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ServiceAccount.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ProjectsServiceAccountsCreateCall) Fields Uses

func (c *ProjectsServiceAccountsCreateCall) Fields(s ...googleapi.Field) *ProjectsServiceAccountsCreateCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ProjectsServiceAccountsCreateCall) Header Uses

func (c *ProjectsServiceAccountsCreateCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type ProjectsServiceAccountsDeleteCall Uses

type ProjectsServiceAccountsDeleteCall struct {
    // contains filtered or unexported fields
}

func (*ProjectsServiceAccountsDeleteCall) Context Uses

func (c *ProjectsServiceAccountsDeleteCall) Context(ctx context.Context) *ProjectsServiceAccountsDeleteCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ProjectsServiceAccountsDeleteCall) Do Uses

func (c *ProjectsServiceAccountsDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, error)

Do executes the "iam.projects.serviceAccounts.delete" call. Exactly one of *Empty or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Empty.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ProjectsServiceAccountsDeleteCall) Fields Uses

func (c *ProjectsServiceAccountsDeleteCall) Fields(s ...googleapi.Field) *ProjectsServiceAccountsDeleteCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ProjectsServiceAccountsDeleteCall) Header Uses

func (c *ProjectsServiceAccountsDeleteCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type ProjectsServiceAccountsDisableCall Uses

type ProjectsServiceAccountsDisableCall struct {
    // contains filtered or unexported fields
}

func (*ProjectsServiceAccountsDisableCall) Context Uses

func (c *ProjectsServiceAccountsDisableCall) Context(ctx context.Context) *ProjectsServiceAccountsDisableCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ProjectsServiceAccountsDisableCall) Do Uses

func (c *ProjectsServiceAccountsDisableCall) Do(opts ...googleapi.CallOption) (*Empty, error)

Do executes the "iam.projects.serviceAccounts.disable" call. Exactly one of *Empty or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Empty.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ProjectsServiceAccountsDisableCall) Fields Uses

func (c *ProjectsServiceAccountsDisableCall) Fields(s ...googleapi.Field) *ProjectsServiceAccountsDisableCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ProjectsServiceAccountsDisableCall) Header Uses

func (c *ProjectsServiceAccountsDisableCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type ProjectsServiceAccountsEnableCall Uses

type ProjectsServiceAccountsEnableCall struct {
    // contains filtered or unexported fields
}

func (*ProjectsServiceAccountsEnableCall) Context Uses

func (c *ProjectsServiceAccountsEnableCall) Context(ctx context.Context) *ProjectsServiceAccountsEnableCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ProjectsServiceAccountsEnableCall) Do Uses

func (c *ProjectsServiceAccountsEnableCall) Do(opts ...googleapi.CallOption) (*Empty, error)

Do executes the "iam.projects.serviceAccounts.enable" call. Exactly one of *Empty or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Empty.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ProjectsServiceAccountsEnableCall) Fields Uses

func (c *ProjectsServiceAccountsEnableCall) Fields(s ...googleapi.Field) *ProjectsServiceAccountsEnableCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ProjectsServiceAccountsEnableCall) Header Uses

func (c *ProjectsServiceAccountsEnableCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type ProjectsServiceAccountsGetCall Uses

type ProjectsServiceAccountsGetCall struct {
    // contains filtered or unexported fields
}

func (*ProjectsServiceAccountsGetCall) Context Uses

func (c *ProjectsServiceAccountsGetCall) Context(ctx context.Context) *ProjectsServiceAccountsGetCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ProjectsServiceAccountsGetCall) Do Uses

func (c *ProjectsServiceAccountsGetCall) Do(opts ...googleapi.CallOption) (*ServiceAccount, error)

Do executes the "iam.projects.serviceAccounts.get" call. Exactly one of *ServiceAccount or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ServiceAccount.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ProjectsServiceAccountsGetCall) Fields Uses

func (c *ProjectsServiceAccountsGetCall) Fields(s ...googleapi.Field) *ProjectsServiceAccountsGetCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ProjectsServiceAccountsGetCall) Header Uses

func (c *ProjectsServiceAccountsGetCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*ProjectsServiceAccountsGetCall) IfNoneMatch Uses

func (c *ProjectsServiceAccountsGetCall) IfNoneMatch(entityTag string) *ProjectsServiceAccountsGetCall

IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

type ProjectsServiceAccountsGetIamPolicyCall Uses

type ProjectsServiceAccountsGetIamPolicyCall struct {
    // contains filtered or unexported fields
}

func (*ProjectsServiceAccountsGetIamPolicyCall) Context Uses

func (c *ProjectsServiceAccountsGetIamPolicyCall) Context(ctx context.Context) *ProjectsServiceAccountsGetIamPolicyCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ProjectsServiceAccountsGetIamPolicyCall) Do Uses

func (c *ProjectsServiceAccountsGetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error)

Do executes the "iam.projects.serviceAccounts.getIamPolicy" call. Exactly one of *Policy or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Policy.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ProjectsServiceAccountsGetIamPolicyCall) Fields Uses

func (c *ProjectsServiceAccountsGetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsServiceAccountsGetIamPolicyCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ProjectsServiceAccountsGetIamPolicyCall) Header Uses

func (c *ProjectsServiceAccountsGetIamPolicyCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*ProjectsServiceAccountsGetIamPolicyCall) OptionsRequestedPolicyVersion Uses

func (c *ProjectsServiceAccountsGetIamPolicyCall) OptionsRequestedPolicyVersion(optionsRequestedPolicyVersion int64) *ProjectsServiceAccountsGetIamPolicyCall

OptionsRequestedPolicyVersion sets the optional parameter "options.requestedPolicyVersion": The policy format version to 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.

type ProjectsServiceAccountsKeysCreateCall Uses

type ProjectsServiceAccountsKeysCreateCall struct {
    // contains filtered or unexported fields
}

func (*ProjectsServiceAccountsKeysCreateCall) Context Uses

func (c *ProjectsServiceAccountsKeysCreateCall) Context(ctx context.Context) *ProjectsServiceAccountsKeysCreateCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ProjectsServiceAccountsKeysCreateCall) Do Uses

func (c *ProjectsServiceAccountsKeysCreateCall) Do(opts ...googleapi.CallOption) (*ServiceAccountKey, error)

Do executes the "iam.projects.serviceAccounts.keys.create" call. Exactly one of *ServiceAccountKey or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ServiceAccountKey.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ProjectsServiceAccountsKeysCreateCall) Fields Uses

func (c *ProjectsServiceAccountsKeysCreateCall) Fields(s ...googleapi.Field) *ProjectsServiceAccountsKeysCreateCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ProjectsServiceAccountsKeysCreateCall) Header Uses

func (c *ProjectsServiceAccountsKeysCreateCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type ProjectsServiceAccountsKeysDeleteCall Uses

type ProjectsServiceAccountsKeysDeleteCall struct {
    // contains filtered or unexported fields
}

func (*ProjectsServiceAccountsKeysDeleteCall) Context Uses

func (c *ProjectsServiceAccountsKeysDeleteCall) Context(ctx context.Context) *ProjectsServiceAccountsKeysDeleteCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ProjectsServiceAccountsKeysDeleteCall) Do Uses

func (c *ProjectsServiceAccountsKeysDeleteCall) Do(opts ...googleapi.CallOption) (*Empty, error)

Do executes the "iam.projects.serviceAccounts.keys.delete" call. Exactly one of *Empty or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Empty.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ProjectsServiceAccountsKeysDeleteCall) Fields Uses

func (c *ProjectsServiceAccountsKeysDeleteCall) Fields(s ...googleapi.Field) *ProjectsServiceAccountsKeysDeleteCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ProjectsServiceAccountsKeysDeleteCall) Header Uses

func (c *ProjectsServiceAccountsKeysDeleteCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type ProjectsServiceAccountsKeysGetCall Uses

type ProjectsServiceAccountsKeysGetCall struct {
    // contains filtered or unexported fields
}

func (*ProjectsServiceAccountsKeysGetCall) Context Uses

func (c *ProjectsServiceAccountsKeysGetCall) Context(ctx context.Context) *ProjectsServiceAccountsKeysGetCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ProjectsServiceAccountsKeysGetCall) Do Uses

func (c *ProjectsServiceAccountsKeysGetCall) Do(opts ...googleapi.CallOption) (*ServiceAccountKey, error)

Do executes the "iam.projects.serviceAccounts.keys.get" call. Exactly one of *ServiceAccountKey or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ServiceAccountKey.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ProjectsServiceAccountsKeysGetCall) Fields Uses

func (c *ProjectsServiceAccountsKeysGetCall) Fields(s ...googleapi.Field) *ProjectsServiceAccountsKeysGetCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ProjectsServiceAccountsKeysGetCall) Header Uses

func (c *ProjectsServiceAccountsKeysGetCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*ProjectsServiceAccountsKeysGetCall) IfNoneMatch Uses

func (c *ProjectsServiceAccountsKeysGetCall) IfNoneMatch(entityTag string) *ProjectsServiceAccountsKeysGetCall

IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

func (*ProjectsServiceAccountsKeysGetCall) PublicKeyType Uses

func (c *ProjectsServiceAccountsKeysGetCall) PublicKeyType(publicKeyType string) *ProjectsServiceAccountsKeysGetCall

PublicKeyType sets the optional parameter "publicKeyType": The output format of the public key requested. X509_PEM is the default output format.

Possible values:

"TYPE_NONE"
"TYPE_X509_PEM_FILE"
"TYPE_RAW_PUBLIC_KEY"

type ProjectsServiceAccountsKeysListCall Uses

type ProjectsServiceAccountsKeysListCall struct {
    // contains filtered or unexported fields
}

func (*ProjectsServiceAccountsKeysListCall) Context Uses

func (c *ProjectsServiceAccountsKeysListCall) Context(ctx context.Context) *ProjectsServiceAccountsKeysListCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ProjectsServiceAccountsKeysListCall) Do Uses

func (c *ProjectsServiceAccountsKeysListCall) Do(opts ...googleapi.CallOption) (*ListServiceAccountKeysResponse, error)

Do executes the "iam.projects.serviceAccounts.keys.list" call. Exactly one of *ListServiceAccountKeysResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ListServiceAccountKeysResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ProjectsServiceAccountsKeysListCall) Fields Uses

func (c *ProjectsServiceAccountsKeysListCall) Fields(s ...googleapi.Field) *ProjectsServiceAccountsKeysListCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ProjectsServiceAccountsKeysListCall) Header Uses

func (c *ProjectsServiceAccountsKeysListCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*ProjectsServiceAccountsKeysListCall) IfNoneMatch Uses

func (c *ProjectsServiceAccountsKeysListCall) IfNoneMatch(entityTag string) *ProjectsServiceAccountsKeysListCall

IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

func (*ProjectsServiceAccountsKeysListCall) KeyTypes Uses

func (c *ProjectsServiceAccountsKeysListCall) KeyTypes(keyTypes ...string) *ProjectsServiceAccountsKeysListCall

KeyTypes sets the optional parameter "keyTypes": Filters the types of keys the user wants to include in the list response. Duplicate key types are not allowed. If no key type is provided, all keys are returned.

Possible values:

"KEY_TYPE_UNSPECIFIED"
"USER_MANAGED"
"SYSTEM_MANAGED"

type ProjectsServiceAccountsKeysService Uses

type ProjectsServiceAccountsKeysService struct {
    // contains filtered or unexported fields
}

func NewProjectsServiceAccountsKeysService Uses

func NewProjectsServiceAccountsKeysService(s *Service) *ProjectsServiceAccountsKeysService

func (*ProjectsServiceAccountsKeysService) Create Uses

func (r *ProjectsServiceAccountsKeysService) Create(name string, createserviceaccountkeyrequest *CreateServiceAccountKeyRequest) *ProjectsServiceAccountsKeysCreateCall

Create: Creates a ServiceAccountKey and returns it.

func (*ProjectsServiceAccountsKeysService) Delete Uses

func (r *ProjectsServiceAccountsKeysService) Delete(name string) *ProjectsServiceAccountsKeysDeleteCall

Delete: Deletes a ServiceAccountKey.

func (*ProjectsServiceAccountsKeysService) Get Uses

func (r *ProjectsServiceAccountsKeysService) Get(name string) *ProjectsServiceAccountsKeysGetCall

Get: Gets the ServiceAccountKey by key id.

func (*ProjectsServiceAccountsKeysService) List Uses

func (r *ProjectsServiceAccountsKeysService) List(name string) *ProjectsServiceAccountsKeysListCall

List: Lists ServiceAccountKeys.

func (*ProjectsServiceAccountsKeysService) Upload Uses

func (r *ProjectsServiceAccountsKeysService) Upload(name string, uploadserviceaccountkeyrequest *UploadServiceAccountKeyRequest) *ProjectsServiceAccountsKeysUploadCall

Upload: Upload public key for a given service account. This rpc will create a ServiceAccountKey that has the provided public key and returns it.

type ProjectsServiceAccountsKeysUploadCall Uses

type ProjectsServiceAccountsKeysUploadCall struct {
    // contains filtered or unexported fields
}

func (*ProjectsServiceAccountsKeysUploadCall) Context Uses

func (c *ProjectsServiceAccountsKeysUploadCall) Context(ctx context.Context) *ProjectsServiceAccountsKeysUploadCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ProjectsServiceAccountsKeysUploadCall) Do Uses

func (c *ProjectsServiceAccountsKeysUploadCall) Do(opts ...googleapi.CallOption) (*ServiceAccountKey, error)

Do executes the "iam.projects.serviceAccounts.keys.upload" call. Exactly one of *ServiceAccountKey or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ServiceAccountKey.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ProjectsServiceAccountsKeysUploadCall) Fields Uses

func (c *ProjectsServiceAccountsKeysUploadCall) Fields(s ...googleapi.Field) *ProjectsServiceAccountsKeysUploadCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ProjectsServiceAccountsKeysUploadCall) Header Uses

func (c *ProjectsServiceAccountsKeysUploadCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type ProjectsServiceAccountsListCall Uses

type ProjectsServiceAccountsListCall struct {
    // contains filtered or unexported fields
}

func (*ProjectsServiceAccountsListCall) Context Uses

func (c *ProjectsServiceAccountsListCall) Context(ctx context.Context) *ProjectsServiceAccountsListCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ProjectsServiceAccountsListCall) Do Uses

func (c *ProjectsServiceAccountsListCall) Do(opts ...googleapi.CallOption) (*ListServiceAccountsResponse, error)

Do executes the "iam.projects.serviceAccounts.list" call. Exactly one of *ListServiceAccountsResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ListServiceAccountsResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ProjectsServiceAccountsListCall) Fields Uses

func (c *ProjectsServiceAccountsListCall) Fields(s ...googleapi.Field) *ProjectsServiceAccountsListCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ProjectsServiceAccountsListCall) Header Uses

func (c *ProjectsServiceAccountsListCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*ProjectsServiceAccountsListCall) IfNoneMatch Uses

func (c *ProjectsServiceAccountsListCall) IfNoneMatch(entityTag string) *ProjectsServiceAccountsListCall

IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

func (*ProjectsServiceAccountsListCall) PageSize Uses

func (c *ProjectsServiceAccountsListCall) PageSize(pageSize int64) *ProjectsServiceAccountsListCall

PageSize sets the optional parameter "pageSize": Optional limit on the number of service accounts to include in the response. Further accounts can subsequently be obtained by including the ListServiceAccountsResponse.next_page_token in a subsequent request.

func (*ProjectsServiceAccountsListCall) PageToken Uses

func (c *ProjectsServiceAccountsListCall) PageToken(pageToken string) *ProjectsServiceAccountsListCall

PageToken sets the optional parameter "pageToken": Optional pagination token returned in an earlier ListServiceAccountsResponse.next_page_token.

func (*ProjectsServiceAccountsListCall) Pages Uses

func (c *ProjectsServiceAccountsListCall) Pages(ctx context.Context, f func(*ListServiceAccountsResponse) error) error

Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.

type ProjectsServiceAccountsPatchCall Uses

type ProjectsServiceAccountsPatchCall struct {
    // contains filtered or unexported fields
}

func (*ProjectsServiceAccountsPatchCall) Context Uses

func (c *ProjectsServiceAccountsPatchCall) Context(ctx context.Context) *ProjectsServiceAccountsPatchCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ProjectsServiceAccountsPatchCall) Do Uses

func (c *ProjectsServiceAccountsPatchCall) Do(opts ...googleapi.CallOption) (*ServiceAccount, error)

Do executes the "iam.projects.serviceAccounts.patch" call. Exactly one of *ServiceAccount or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ServiceAccount.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ProjectsServiceAccountsPatchCall) Fields Uses

func (c *ProjectsServiceAccountsPatchCall) Fields(s ...googleapi.Field) *ProjectsServiceAccountsPatchCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ProjectsServiceAccountsPatchCall) Header Uses

func (c *ProjectsServiceAccountsPatchCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type ProjectsServiceAccountsService Uses

type ProjectsServiceAccountsService struct {
    Keys *ProjectsServiceAccountsKeysService
    // contains filtered or unexported fields
}

func NewProjectsServiceAccountsService Uses

func NewProjectsServiceAccountsService(s *Service) *ProjectsServiceAccountsService

func (*ProjectsServiceAccountsService) Create Uses

func (r *ProjectsServiceAccountsService) Create(name string, createserviceaccountrequest *CreateServiceAccountRequest) *ProjectsServiceAccountsCreateCall

Create: Creates a ServiceAccount and returns it.

func (*ProjectsServiceAccountsService) Delete Uses

func (r *ProjectsServiceAccountsService) Delete(name string) *ProjectsServiceAccountsDeleteCall

Delete: Deletes a ServiceAccount.

func (*ProjectsServiceAccountsService) Disable Uses

func (r *ProjectsServiceAccountsService) Disable(name string, disableserviceaccountrequest *DisableServiceAccountRequest) *ProjectsServiceAccountsDisableCall

Disable: DisableServiceAccount is currently in the alpha launch stage.

Disables a ServiceAccount, which immediately prevents the service account from authenticating and gaining access to APIs.

Disabled service accounts can be safely restored by using EnableServiceAccount at any point. Deleted service accounts cannot be restored using this method.

Disabling a service account that is bound to VMs, Apps, Functions, or other jobs will cause those jobs to lose access to resources if they are using the disabled service account.

To improve reliability of your services and avoid unexpected outages, it is recommended to first disable a service account rather than delete it. After disabling the service account, wait at least 24 hours to verify there are no unintended consequences, and then delete the service account.

func (*ProjectsServiceAccountsService) Enable Uses

func (r *ProjectsServiceAccountsService) Enable(name string, enableserviceaccountrequest *EnableServiceAccountRequest) *ProjectsServiceAccountsEnableCall

Enable: EnableServiceAccount is currently in the alpha launch stage.

Restores a disabled ServiceAccount
that has been manually disabled by using DisableServiceAccount.

Service

accounts that have been disabled by other means or for other

reasons,

such as abuse, cannot be restored using this method.

EnableServiceAccount will have no effect on a service account that

is

not disabled.  Enabling an already enabled service account will have

no

effect.

func (*ProjectsServiceAccountsService) Get Uses

func (r *ProjectsServiceAccountsService) Get(name string) *ProjectsServiceAccountsGetCall

Get: Gets a ServiceAccount.

func (*ProjectsServiceAccountsService) GetIamPolicy Uses

func (r *ProjectsServiceAccountsService) GetIamPolicy(resource string) *ProjectsServiceAccountsGetIamPolicyCall

GetIamPolicy: Returns the Cloud IAM access control policy for a ServiceAccount.

Note: Service accounts are both [resources and identities](/iam/docs/service-accounts#service_account_permissions ). This method treats the service account as a resource. It returns the Cloud IAM policy that reflects what members have access to the service account.

This method does not return what resources the service account has access to. To see if a service account has access to a resource, call the `getIamPolicy` method on the target resource. For example, to view grants for a project, call the [projects.getIamPolicy](/resource-manager/reference/rest/v1/projec ts/getIamPolicy) method.

func (*ProjectsServiceAccountsService) List Uses

func (r *ProjectsServiceAccountsService) List(name string) *ProjectsServiceAccountsListCall

List: Lists ServiceAccounts for a project.

func (*ProjectsServiceAccountsService) Patch Uses

func (r *ProjectsServiceAccountsService) Patch(name string, patchserviceaccountrequest *PatchServiceAccountRequest) *ProjectsServiceAccountsPatchCall

Patch: Patches a ServiceAccount.

Currently, only the following fields are updatable: `display_name` and `description`.

Only fields specified in the request are guaranteed to be returned in the response. Other fields in the response may be empty.

Note: The field mask is required.

func (*ProjectsServiceAccountsService) SetIamPolicy Uses

func (r *ProjectsServiceAccountsService) SetIamPolicy(resource string, setiampolicyrequest *SetIamPolicyRequest) *ProjectsServiceAccountsSetIamPolicyCall

SetIamPolicy: Sets the Cloud IAM access control policy for a ServiceAccount.

Note: Service accounts are both [resources and identities](/iam/docs/service-accounts#service_account_permissions ). This method treats the service account as a resource. Use it to grant members access to the service account, such as when they need to impersonate it.

This method does not grant the service account access to other resources, such as projects. To grant a service account access to resources, include the service account in the Cloud IAM policy for the desired resource, then call the appropriate `setIamPolicy` method on the target resource. For example, to grant a service account access to a project, call the [projects.setIamPolicy](/resource-manager/reference/rest/v1/projec ts/setIamPolicy) method.

func (*ProjectsServiceAccountsService) SignBlob Uses

func (r *ProjectsServiceAccountsService) SignBlob(name string, signblobrequest *SignBlobRequest) *ProjectsServiceAccountsSignBlobCall

SignBlob: **Note**: This method is in the process of being deprecated. Call the [`signBlob()`](/iam/credentials/reference/rest/v1/projects.service Accounts/signBlob) method of the Cloud IAM Service Account Credentials API instead.

Signs a blob using a service account's system-managed private key.

func (*ProjectsServiceAccountsService) SignJwt Uses

func (r *ProjectsServiceAccountsService) SignJwt(name string, signjwtrequest *SignJwtRequest) *ProjectsServiceAccountsSignJwtCall

SignJwt: **Note**: This method is in the process of being deprecated. Call the [`signJwt()`](/iam/credentials/reference/rest/v1/projects.serviceA ccounts/signJwt) method of the Cloud IAM Service Account Credentials API instead.

Signs a JWT using a service account's system-managed private key.

If no expiry time (`exp`) is provided in the `SignJwtRequest`, IAM sets an an expiry time of one hour by default. If you request an expiry time of more than one hour, the request will fail.

func (*ProjectsServiceAccountsService) TestIamPermissions Uses

func (r *ProjectsServiceAccountsService) TestIamPermissions(resource string, testiampermissionsrequest *TestIamPermissionsRequest) *ProjectsServiceAccountsTestIamPermissionsCall

TestIamPermissions: Tests the specified permissions against the IAM access control policy for a ServiceAccount.

func (*ProjectsServiceAccountsService) Undelete Uses

func (r *ProjectsServiceAccountsService) Undelete(name string, undeleteserviceaccountrequest *UndeleteServiceAccountRequest) *ProjectsServiceAccountsUndeleteCall

Undelete: Restores a deleted ServiceAccount. This is to be used as an action of last resort. A service account may not always be restorable.

func (*ProjectsServiceAccountsService) Update Uses

func (r *ProjectsServiceAccountsService) Update(name string, serviceaccount *ServiceAccount) *ProjectsServiceAccountsUpdateCall

Update: Note: This method is in the process of being deprecated. Use PatchServiceAccount instead.

Updates a ServiceAccount.

Currently, only the following fields are updatable: `display_name` and `description`.

type ProjectsServiceAccountsSetIamPolicyCall Uses

type ProjectsServiceAccountsSetIamPolicyCall struct {
    // contains filtered or unexported fields
}

func (*ProjectsServiceAccountsSetIamPolicyCall) Context Uses

func (c *ProjectsServiceAccountsSetIamPolicyCall) Context(ctx context.Context) *ProjectsServiceAccountsSetIamPolicyCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ProjectsServiceAccountsSetIamPolicyCall) Do Uses

func (c *ProjectsServiceAccountsSetIamPolicyCall) Do(opts ...googleapi.CallOption) (*Policy, error)

Do executes the "iam.projects.serviceAccounts.setIamPolicy" call. Exactly one of *Policy or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Policy.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ProjectsServiceAccountsSetIamPolicyCall) Fields Uses

func (c *ProjectsServiceAccountsSetIamPolicyCall) Fields(s ...googleapi.Field) *ProjectsServiceAccountsSetIamPolicyCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ProjectsServiceAccountsSetIamPolicyCall) Header Uses

func (c *ProjectsServiceAccountsSetIamPolicyCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type ProjectsServiceAccountsSignBlobCall Uses

type ProjectsServiceAccountsSignBlobCall struct {
    // contains filtered or unexported fields
}

func (*ProjectsServiceAccountsSignBlobCall) Context Uses

func (c *ProjectsServiceAccountsSignBlobCall) Context(ctx context.Context) *ProjectsServiceAccountsSignBlobCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ProjectsServiceAccountsSignBlobCall) Do Uses

func (c *ProjectsServiceAccountsSignBlobCall) Do(opts ...googleapi.CallOption) (*SignBlobResponse, error)

Do executes the "iam.projects.serviceAccounts.signBlob" call. Exactly one of *SignBlobResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *SignBlobResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ProjectsServiceAccountsSignBlobCall) Fields Uses

func (c *ProjectsServiceAccountsSignBlobCall) Fields(s ...googleapi.Field) *ProjectsServiceAccountsSignBlobCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ProjectsServiceAccountsSignBlobCall) Header Uses

func (c *ProjectsServiceAccountsSignBlobCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type ProjectsServiceAccountsSignJwtCall Uses

type ProjectsServiceAccountsSignJwtCall struct {
    // contains filtered or unexported fields
}

func (*ProjectsServiceAccountsSignJwtCall) Context Uses

func (c *ProjectsServiceAccountsSignJwtCall) Context(ctx context.Context) *ProjectsServiceAccountsSignJwtCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ProjectsServiceAccountsSignJwtCall) Do Uses

func (c *ProjectsServiceAccountsSignJwtCall) Do(opts ...googleapi.CallOption) (*SignJwtResponse, error)

Do executes the "iam.projects.serviceAccounts.signJwt" call. Exactly one of *SignJwtResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *SignJwtResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ProjectsServiceAccountsSignJwtCall) Fields Uses

func (c *ProjectsServiceAccountsSignJwtCall) Fields(s ...googleapi.Field) *ProjectsServiceAccountsSignJwtCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ProjectsServiceAccountsSignJwtCall) Header Uses

func (c *ProjectsServiceAccountsSignJwtCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type ProjectsServiceAccountsTestIamPermissionsCall Uses

type ProjectsServiceAccountsTestIamPermissionsCall struct {
    // contains filtered or unexported fields
}

func (*ProjectsServiceAccountsTestIamPermissionsCall) Context Uses

func (c *ProjectsServiceAccountsTestIamPermissionsCall) Context(ctx context.Context) *ProjectsServiceAccountsTestIamPermissionsCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ProjectsServiceAccountsTestIamPermissionsCall) Do Uses

func (c *ProjectsServiceAccountsTestIamPermissionsCall) Do(opts ...googleapi.CallOption) (*TestIamPermissionsResponse, error)

Do executes the "iam.projects.serviceAccounts.testIamPermissions" call. Exactly one of *TestIamPermissionsResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *TestIamPermissionsResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ProjectsServiceAccountsTestIamPermissionsCall) Fields Uses

func (c *ProjectsServiceAccountsTestIamPermissionsCall) Fields(s ...googleapi.Field) *ProjectsServiceAccountsTestIamPermissionsCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ProjectsServiceAccountsTestIamPermissionsCall) Header Uses

func (c *ProjectsServiceAccountsTestIamPermissionsCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type ProjectsServiceAccountsUndeleteCall Uses

type ProjectsServiceAccountsUndeleteCall struct {
    // contains filtered or unexported fields
}

func (*ProjectsServiceAccountsUndeleteCall) Context Uses

func (c *ProjectsServiceAccountsUndeleteCall) Context(ctx context.Context) *ProjectsServiceAccountsUndeleteCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ProjectsServiceAccountsUndeleteCall) Do Uses

func (c *ProjectsServiceAccountsUndeleteCall) Do(opts ...googleapi.CallOption) (*UndeleteServiceAccountResponse, error)

Do executes the "iam.projects.serviceAccounts.undelete" call. Exactly one of *UndeleteServiceAccountResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *UndeleteServiceAccountResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ProjectsServiceAccountsUndeleteCall) Fields Uses

func (c *ProjectsServiceAccountsUndeleteCall) Fields(s ...googleapi.Field) *ProjectsServiceAccountsUndeleteCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ProjectsServiceAccountsUndeleteCall) Header Uses

func (c *ProjectsServiceAccountsUndeleteCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type ProjectsServiceAccountsUpdateCall Uses

type ProjectsServiceAccountsUpdateCall struct {
    // contains filtered or unexported fields
}

func (*ProjectsServiceAccountsUpdateCall) Context Uses

func (c *ProjectsServiceAccountsUpdateCall) Context(ctx context.Context) *ProjectsServiceAccountsUpdateCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ProjectsServiceAccountsUpdateCall) Do Uses

func (c *ProjectsServiceAccountsUpdateCall) Do(opts ...googleapi.CallOption) (*ServiceAccount, error)

Do executes the "iam.projects.serviceAccounts.update" call. Exactly one of *ServiceAccount or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ServiceAccount.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*ProjectsServiceAccountsUpdateCall) Fields Uses

func (c *ProjectsServiceAccountsUpdateCall) Fields(s ...googleapi.Field) *ProjectsServiceAccountsUpdateCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ProjectsServiceAccountsUpdateCall) Header Uses

func (c *ProjectsServiceAccountsUpdateCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

type QueryAuditableServicesRequest Uses

type QueryAuditableServicesRequest struct {
    // FullResourceName: Required. The full resource name to query from the
    // list of auditable
    // services.
    //
    // The name follows the Google Cloud Platform resource format.
    // For example, a Cloud Platform project with id `my-project` will be
    // named
    // `//cloudresourcemanager.googleapis.com/projects/my-project`.
    FullResourceName string `json:"fullResourceName,omitempty"`

    // ForceSendFields is a list of field names (e.g. "FullResourceName") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "FullResourceName") to
    // include in API requests with the JSON null value. By default, fields
    // with empty values are omitted from API requests. However, any field
    // with an empty value appearing in NullFields will be sent to the
    // server as null. It is an error if a field in this list has a
    // non-empty value. This may be used to include null fields in Patch
    // requests.
    NullFields []string `json:"-"`
}

QueryAuditableServicesRequest: A request to get the list of auditable services for a resource.

func (*QueryAuditableServicesRequest) MarshalJSON Uses

func (s *QueryAuditableServicesRequest) MarshalJSON() ([]byte, error)

type QueryAuditableServicesResponse Uses

type QueryAuditableServicesResponse struct {
    // Services: The auditable services for a resource.
    Services []*AuditableService `json:"services,omitempty"`

    // ServerResponse contains the HTTP response code and headers from the
    // server.
    googleapi.ServerResponse `json:"-"`

    // ForceSendFields is a list of field names (e.g. "Services") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Services") to include in
    // API requests with the JSON null value. By default, fields with empty
    // values are omitted from API requests. However, any field with an
    // empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

QueryAuditableServicesResponse: A response containing a list of auditable services for a resource.

func (*QueryAuditableServicesResponse) MarshalJSON Uses

func (s *QueryAuditableServicesResponse) MarshalJSON() ([]byte, error)

type QueryGrantableRolesRequest Uses

type QueryGrantableRolesRequest struct {
    // FullResourceName: Required. The full resource name to query from the
    // list of grantable roles.
    //
    // The name follows the Google Cloud Platform resource format.
    // For example, a Cloud Platform project with id `my-project` will be
    // named
    // `//cloudresourcemanager.googleapis.com/projects/my-project`.
    FullResourceName string `json:"fullResourceName,omitempty"`

    // PageSize: Optional limit on the number of roles to include in the
    // response.
    PageSize int64 `json:"pageSize,omitempty"`

    // PageToken: Optional pagination token returned in an
    // earlier
    // QueryGrantableRolesResponse.
    PageToken string `json:"pageToken,omitempty"`

    // Possible values:
    //   "BASIC" - Omits the `included_permissions` field.
    // This is the default value.
    //   "FULL" - Returns all fields.
    View string `json:"view,omitempty"`

    // ForceSendFields is a list of field names (e.g. "FullResourceName") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "FullResourceName") to
    // include in API requests with the JSON null value. By default, fields
    // with empty values are omitted from API requests. However, any field
    // with an empty value appearing in NullFields will be sent to the
    // server as null. It is an error if a field in this list has a
    // non-empty value. This may be used to include null fields in Patch
    // requests.
    NullFields []string `json:"-"`
}

QueryGrantableRolesRequest: The grantable role query request.

func (*QueryGrantableRolesRequest) MarshalJSON Uses

func (s *QueryGrantableRolesRequest) MarshalJSON() ([]byte, error)

type QueryGrantableRolesResponse Uses

type QueryGrantableRolesResponse struct {
    // NextPageToken: To retrieve the next page of results,
    // set
    // `QueryGrantableRolesRequest.page_token` to this value.
    NextPageToken string `json:"nextPageToken,omitempty"`

    // Roles: The list of matching roles.
    Roles []*Role `json:"roles,omitempty"`

    // ServerResponse contains the HTTP response code and headers from the
    // server.
    googleapi.ServerResponse `json:"-"`

    // ForceSendFields is a list of field names (e.g. "NextPageToken") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "NextPageToken") to include
    // in API requests with the JSON null value. By default, fields with
    // empty values are omitted from API requests. However, any field with
    // an empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

QueryGrantableRolesResponse: The grantable role query response.

func (*QueryGrantableRolesResponse) MarshalJSON Uses

func (s *QueryGrantableRolesResponse) MarshalJSON() ([]byte, error)

type QueryTestablePermissionsRequest Uses

type QueryTestablePermissionsRequest struct {
    // FullResourceName: Required. The full resource name to query from the
    // list of testable
    // permissions.
    //
    // The name follows the Google Cloud Platform resource format.
    // For example, a Cloud Platform project with id `my-project` will be
    // named
    // `//cloudresourcemanager.googleapis.com/projects/my-project`.
    FullResourceName string `json:"fullResourceName,omitempty"`

    // PageSize: Optional limit on the number of permissions to include in
    // the response.
    PageSize int64 `json:"pageSize,omitempty"`

    // PageToken: Optional pagination token returned in an
    // earlier
    // QueryTestablePermissionsRequest.
    PageToken string `json:"pageToken,omitempty"`

    // ForceSendFields is a list of field names (e.g. "FullResourceName") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "FullResourceName") to
    // include in API requests with the JSON null value. By default, fields
    // with empty values are omitted from API requests. However, any field
    // with an empty value appearing in NullFields will be sent to the
    // server as null. It is an error if a field in this list has a
    // non-empty value. This may be used to include null fields in Patch
    // requests.
    NullFields []string `json:"-"`
}

QueryTestablePermissionsRequest: A request to get permissions which can be tested on a resource.

func (*QueryTestablePermissionsRequest) MarshalJSON Uses

func (s *QueryTestablePermissionsRequest) MarshalJSON() ([]byte, error)

type QueryTestablePermissionsResponse Uses

type QueryTestablePermissionsResponse struct {
    // NextPageToken: To retrieve the next page of results,
    // set
    // `QueryTestableRolesRequest.page_token` to this value.
    NextPageToken string `json:"nextPageToken,omitempty"`

    // Permissions: The Permissions testable on the requested resource.
    Permissions []*Permission `json:"permissions,omitempty"`

    // ServerResponse contains the HTTP response code and headers from the
    // server.
    googleapi.ServerResponse `json:"-"`

    // ForceSendFields is a list of field names (e.g. "NextPageToken") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "NextPageToken") to include
    // in API requests with the JSON null value. By default, fields with
    // empty values are omitted from API requests. However, any field with
    // an empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

QueryTestablePermissionsResponse: The response containing permissions which can be tested on a resource.

func (*QueryTestablePermissionsResponse) MarshalJSON Uses

func (s *QueryTestablePermissionsResponse) MarshalJSON() ([]byte, error)

type Role Uses

type Role struct {
    // Deleted: The current deleted state of the role. This field is read
    // only.
    // It will be ignored in calls to CreateRole and UpdateRole.
    Deleted bool `json:"deleted,omitempty"`

    // Description: Optional. A human-readable description for the role.
    Description string `json:"description,omitempty"`

    // Etag: Used to perform a consistent read-modify-write.
    Etag string `json:"etag,omitempty"`

    // IncludedPermissions: The names of the permissions this role grants
    // when bound in an IAM policy.
    IncludedPermissions []string `json:"includedPermissions,omitempty"`

    // Name: The name of the role.
    //
    // When Role is used in CreateRole, the role name must not be set.
    //
    // When Role is used in output and other input such as UpdateRole, the
    // role
    // name is the complete path, e.g., roles/logging.viewer for predefined
    // roles
    // and organizations/{ORGANIZATION_ID}/roles/logging.viewer for custom
    // roles.
    Name string `json:"name,omitempty"`

    // Stage: The current launch stage of the role. If the `ALPHA` launch
    // stage has been
    // selected for a role, the `stage` field will not be included in
    // the
    // returned definition for the role.
    //
    // Possible values:
    //   "ALPHA" - The user has indicated this role is currently in an Alpha
    // phase. If this
    // launch stage is selected, the `stage` field will not be included
    // when
    // requesting the definition for a given role.
    //   "BETA" - The user has indicated this role is currently in a Beta
    // phase.
    //   "GA" - The user has indicated this role is generally available.
    //   "DEPRECATED" - The user has indicated this role is being
    // deprecated.
    //   "DISABLED" - This role is disabled and will not contribute
    // permissions to any members
    // it is granted to in policies.
    //   "EAP" - The user has indicated this role is currently in an EAP
    // phase.
    Stage string `json:"stage,omitempty"`

    // Title: Optional. A human-readable title for the role.  Typically
    // this
    // is limited to 100 UTF-8 bytes.
    Title string `json:"title,omitempty"`

    // ServerResponse contains the HTTP response code and headers from the
    // server.
    googleapi.ServerResponse `json:"-"`

    // ForceSendFields is a list of field names (e.g. "Deleted") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Deleted") to include in
    // API requests with the JSON null value. By default, fields with empty
    // values are omitted from API requests. However, any field with an
    // empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

Role: A role in the Identity and Access Management API.

func (*Role) MarshalJSON Uses

func (s *Role) MarshalJSON() ([]byte, error)

type RolesGetCall Uses

type RolesGetCall struct {
    // contains filtered or unexported fields
}

func (*RolesGetCall) Context Uses

func (c *RolesGetCall) Context(ctx context.Context) *RolesGetCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*RolesGetCall) Do Uses

func (c *RolesGetCall) Do(opts ...googleapi.CallOption) (*Role, error)

Do executes the "iam.roles.get" call. Exactly one of *Role or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Role.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*RolesGetCall) Fields Uses

func (c *RolesGetCall) Fields(s ...googleapi.Field) *RolesGetCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*RolesGetCall) Header Uses

func (c *RolesGetCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*RolesGetCall) IfNoneMatch Uses

func (c *RolesGetCall) IfNoneMatch(entityTag string) *RolesGetCall

IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

type RolesListCall Uses

type RolesListCall struct {
    // contains filtered or unexported fields
}

func (*RolesListCall) Context Uses

func (c *RolesListCall) Context(ctx context.Context) *RolesListCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*RolesListCall) Do Uses

func (c *RolesListCall) Do(opts ...googleapi.CallOption) (*ListRolesResponse, error)

Do executes the "iam.roles.list" call. Exactly one of *ListRolesResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ListRolesResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*RolesListCall) Fields Uses

func (c *RolesListCall) Fields(s ...googleapi.Field) *RolesListCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*RolesListCall) Header Uses

func (c *RolesListCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*RolesListCall) IfNoneMatch Uses

func (c *RolesListCall) IfNoneMatch(entityTag string) *RolesListCall

IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

func (*RolesListCall) PageSize Uses

func (c *RolesListCall) PageSize(pageSize int64) *RolesListCall

PageSize sets the optional parameter "pageSize": Optional limit on the number of roles to include in the response.

func (*RolesListCall) PageToken Uses

func (c *RolesListCall) PageToken(pageToken string) *RolesListCall

PageToken sets the optional parameter "pageToken": Optional pagination token returned in an earlier ListRolesResponse.

func (*RolesListCall) Pages Uses

func (c *RolesListCall) Pages(ctx context.Context, f func(*ListRolesResponse) error) error

Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.

func (*RolesListCall) Parent Uses

func (c *RolesListCall) Parent(parent string) *RolesListCall

Parent sets the optional parameter "parent": The `parent` parameter's value depends on the target resource for the request, namely [`roles`](/iam/reference/rest/v1/roles), [`projects`](/iam/refe rence/rest/v1/projects.roles), or [`organizations`](/iam/reference/rest/v1/organizations.roles). Each resource type's `parent` value format is described below:

* [`roles.list()`](/iam/reference/rest/v1/roles/list): An empty string.

This method doesn't require a resource; it simply returns all
[predefined roles](/iam/docs/understanding-roles#predefined_roles)

in

Cloud IAM. Example request URL:
`https://iam.googleapis.com/v1/roles`

* [`projects.roles.list()`](/iam/reference/rest/v1/projects.roles/list):

`projects/{PROJECT_ID}`. This method lists all project-level
[custom roles](/iam/docs/understanding-custom-roles).
Example request URL:
`https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles`

* [`organizations.roles.list()`](/iam/reference/rest/v1/organizations.ro les/list):

`organizations/{ORGANIZATION_ID}`. This method lists all
organization-level [custom

roles](/iam/docs/understanding-custom-roles).

Example request URL:

`https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles`

Note: Wildcard (*) values are invalid; you must specify a complete project ID or organization ID.

func (*RolesListCall) ShowDeleted Uses

func (c *RolesListCall) ShowDeleted(showDeleted bool) *RolesListCall

ShowDeleted sets the optional parameter "showDeleted": Include Roles that have been deleted.

func (*RolesListCall) View Uses

func (c *RolesListCall) View(view string) *RolesListCall

View sets the optional parameter "view": Optional view for the returned Role objects. When `FULL` is specified, the `includedPermissions` field is returned, which includes a list of all permissions in the role. The default value is `BASIC`, which does not return the `includedPermissions` field.

Possible values:

"BASIC"
"FULL"

type RolesQueryGrantableRolesCall Uses

type RolesQueryGrantableRolesCall struct {
    // contains filtered or unexported fields
}

func (*RolesQueryGrantableRolesCall) Context Uses

func (c *RolesQueryGrantableRolesCall) Context(ctx context.Context) *RolesQueryGrantableRolesCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*RolesQueryGrantableRolesCall) Do Uses

func (c *RolesQueryGrantableRolesCall) Do(opts ...googleapi.CallOption) (*QueryGrantableRolesResponse, error)

Do executes the "iam.roles.queryGrantableRoles" call. Exactly one of *QueryGrantableRolesResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *QueryGrantableRolesResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*RolesQueryGrantableRolesCall) Fields Uses

func (c *RolesQueryGrantableRolesCall) Fields(s ...googleapi.Field) *RolesQueryGrantableRolesCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*RolesQueryGrantableRolesCall) Header Uses

func (c *RolesQueryGrantableRolesCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*RolesQueryGrantableRolesCall) Pages Uses

func (c *RolesQueryGrantableRolesCall) Pages(ctx context.Context, f func(*QueryGrantableRolesResponse) error) error

Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.

type RolesService Uses

type RolesService struct {
    // contains filtered or unexported fields
}

func NewRolesService Uses

func NewRolesService(s *Service) *RolesService

func (*RolesService) Get Uses

func (r *RolesService) Get(name string) *RolesGetCall

Get: Gets a Role definition.

func (*RolesService) List Uses

func (r *RolesService) List() *RolesListCall

List: Lists the Roles defined on a resource.

func (*RolesService) QueryGrantableRoles Uses

func (r *RolesService) QueryGrantableRoles(querygrantablerolesrequest *QueryGrantableRolesRequest) *RolesQueryGrantableRolesCall

QueryGrantableRoles: Queries roles that can be granted on a particular resource. A role is grantable if it can be used as the role in a binding for a policy for that resource.

type Service Uses

type Service struct {
    BasePath  string // API endpoint base URL
    UserAgent string // optional additional User-Agent fragment

    IamPolicies *IamPoliciesService

    Organizations *OrganizationsService

    Permissions *PermissionsService

    Projects *ProjectsService

    Roles *RolesService
    // contains filtered or unexported fields
}

func New Uses

func New(client *http.Client) (*Service, error)

New creates a new Service. It uses the provided http.Client for requests.

Deprecated: please use NewService instead. To provide a custom HTTP client, use option.WithHTTPClient. If you are using google.golang.org/api/googleapis/transport.APIKey, use option.WithAPIKey with NewService instead.

func NewService Uses

func NewService(ctx context.Context, opts ...option.ClientOption) (*Service, error)

NewService creates a new Service.

type ServiceAccount Uses

type ServiceAccount struct {
    // Description: Optional. A user-specified opaque description of the
    // service account.
    // Must be less than or equal to 256 UTF-8 bytes.
    Description string `json:"description,omitempty"`

    // Disabled: @OutputOnly A bool indicate if the service account is
    // disabled.
    // The field is currently in alpha phase.
    Disabled bool `json:"disabled,omitempty"`

    // DisplayName: Optional. A user-specified name for the service
    // account.
    // Must be less than or equal to 100 UTF-8 bytes.
    DisplayName string `json:"displayName,omitempty"`

    // Email: @OutputOnly The email address of the service account.
    Email string `json:"email,omitempty"`

    // Etag: Optional. Note: `etag` is an inoperable legacy field that is
    // only returned
    // for backwards compatibility.
    Etag string `json:"etag,omitempty"`

    // Name: The resource name of the service account in the following
    // format:
    // `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}`.
    //
    // Requests using `-` as a wildcard for the `PROJECT_ID` will infer
    // the
    // project from the `account` and the `ACCOUNT` value can be the
    // `email`
    // address or the `unique_id` of the service account.
    //
    // In responses the resource name will always be in the
    // format
    // `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}`.
    Name string `json:"name,omitempty"`

    // Oauth2ClientId: @OutputOnly The OAuth2 client id for the service
    // account.
    // This is used in conjunction with the OAuth2 clientconfig API to
    // make
    // three legged OAuth2 (3LO) flows to access the data of Google users.
    Oauth2ClientId string `json:"oauth2ClientId,omitempty"`

    // ProjectId: @OutputOnly The id of the project that owns the service
    // account.
    ProjectId string `json:"projectId,omitempty"`

    // UniqueId: @OutputOnly The unique and stable id of the service
    // account.
    UniqueId string `json:"uniqueId,omitempty"`

    // ServerResponse contains the HTTP response code and headers from the
    // server.
    googleapi.ServerResponse `json:"-"`

    // ForceSendFields is a list of field names (e.g. "Description") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Description") to include
    // in API requests with the JSON null value. By default, fields with
    // empty values are omitted from API requests. However, any field with
    // an empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

ServiceAccount: A service account in the Identity and Access Management API.

To create a service account, specify the `project_id` and the `account_id` for the account. The `account_id` is unique within the project, and is used to generate the service account email address and a stable `unique_id`.

If the account already exists, the account's resource name is returned in the format of projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}. The caller can use the name in other methods to access the account.

All other methods can identify the service account using the format `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}`. Using `-` as a wildcard for the `PROJECT_ID` will infer the project from the account. The `ACCOUNT` value can be the `email` address or the `unique_id` of the service account.

func (*ServiceAccount) MarshalJSON Uses

func (s *ServiceAccount) MarshalJSON() ([]byte, error)

type ServiceAccountKey Uses

type ServiceAccountKey struct {
    // KeyAlgorithm: Specifies the algorithm (and possibly key size) for the
    // key.
    //
    // Possible values:
    //   "KEY_ALG_UNSPECIFIED" - An unspecified key algorithm.
    //   "KEY_ALG_RSA_1024" - 1k RSA Key.
    //   "KEY_ALG_RSA_2048" - 2k RSA Key.
    KeyAlgorithm string `json:"keyAlgorithm,omitempty"`

    // KeyOrigin: The key origin.
    //
    // Possible values:
    //   "ORIGIN_UNSPECIFIED" - Unspecified key origin.
    //   "USER_PROVIDED" - Key is provided by user.
    //   "GOOGLE_PROVIDED" - Key is provided by Google.
    KeyOrigin string `json:"keyOrigin,omitempty"`

    // KeyType: The key type.
    //
    // Possible values:
    //   "KEY_TYPE_UNSPECIFIED" - Unspecified key type. The presence of this
    // in the
    // message will immediately result in an error.
    //   "USER_MANAGED" - User-managed keys (managed and rotated by the
    // user).
    //   "SYSTEM_MANAGED" - System-managed keys (managed and rotated by
    // Google).
    KeyType string `json:"keyType,omitempty"`

    // Name: The resource name of the service account key in the following
    // format
    // `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}`.
    Name string `json:"name,omitempty"`

    // PrivateKeyData: The private key data. Only provided in
    // `CreateServiceAccountKey`
    // responses. Make sure to keep the private key data secure because
    // it
    // allows for the assertion of the service account identity.
    // When base64 decoded, the private key data can be used to authenticate
    // with
    // Google API client libraries and with
    // <a
    // href="/sdk/gcloud/reference/auth/activate-service-account">gcloud
    // auth
    //  activate-service-account</a>.
    PrivateKeyData string `json:"privateKeyData,omitempty"`

    // PrivateKeyType: The output format for the private key.
    // Only provided in `CreateServiceAccountKey` responses, not
    // in `GetServiceAccountKey` or `ListServiceAccountKey`
    // responses.
    //
    // Google never exposes system-managed private keys, and never
    // retains
    // user-managed private keys.
    //
    // Possible values:
    //   "TYPE_UNSPECIFIED" - Unspecified. Equivalent to
    // `TYPE_GOOGLE_CREDENTIALS_FILE`.
    //   "TYPE_PKCS12_FILE" - PKCS12 format.
    // The password for the PKCS12 file is `notasecret`.
    // For more information, see https://tools.ietf.org/html/rfc7292.
    //   "TYPE_GOOGLE_CREDENTIALS_FILE" - Google Credentials File format.
    PrivateKeyType string `json:"privateKeyType,omitempty"`

    // PublicKeyData: The public key data. Only provided in
    // `GetServiceAccountKey` responses.
    PublicKeyData string `json:"publicKeyData,omitempty"`

    // ValidAfterTime: The key can be used after this timestamp.
    ValidAfterTime string `json:"validAfterTime,omitempty"`

    // ValidBeforeTime: The key can be used before this timestamp.
    // For system-managed key pairs, this timestamp is the end time for
    // the
    // private key signing operation. The public key could still be used
    // for verification for a few hours after this time.
    ValidBeforeTime string `json:"validBeforeTime,omitempty"`

    // ServerResponse contains the HTTP response code and headers from the
    // server.
    googleapi.ServerResponse `json:"-"`

    // ForceSendFields is a list of field names (e.g. "KeyAlgorithm") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "KeyAlgorithm") to include
    // in API requests with the JSON null value. By default, fields with
    // empty values are omitted from API requests. However, any field with
    // an empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

ServiceAccountKey: Represents a service account key.

A service account has two sets of key-pairs: user-managed, and system-managed.

User-managed key-pairs can be created and deleted by users. Users are responsible for rotating these keys periodically to ensure security of their service accounts. Users retain the private key of these key-pairs, and Google retains ONLY the public key.

System-managed keys are automatically rotated by Google, and are used for signing for a maximum of two weeks. The rotation process is probabilistic, and usage of the new key will gradually ramp up and down over the key's lifetime. We recommend caching the public key set for a service account for no more than 24 hours to ensure you have access to the latest keys.

Public keys for all service accounts are also published at the OAuth2 Service Account API.

func (*ServiceAccountKey) MarshalJSON Uses

func (s *ServiceAccountKey) MarshalJSON() ([]byte, error)

type SetIamPolicyRequest Uses

type SetIamPolicyRequest struct {
    // Policy: REQUIRED: The complete policy to be applied to the
    // `resource`. The size of
    // the policy is limited to a few 10s of KB. An empty policy is a
    // valid policy but certain Cloud Platform services (such as
    // Projects)
    // might reject them.
    Policy *Policy `json:"policy,omitempty"`

    // UpdateMask: 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
    // following default mask is used:
    // paths: "bindings, etag"
    // This field is only used by Cloud IAM.
    UpdateMask string `json:"updateMask,omitempty"`

    // ForceSendFields is a list of field names (e.g. "Policy") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Policy") to include in API
    // requests with the JSON null value. By default, fields with empty
    // values are omitted from API requests. However, any field with an
    // empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

SetIamPolicyRequest: Request message for `SetIamPolicy` method.

func (*SetIamPolicyRequest) MarshalJSON Uses

func (s *SetIamPolicyRequest) MarshalJSON() ([]byte, error)

type SignBlobRequest Uses

type SignBlobRequest struct {
    // BytesToSign: The bytes to sign.
    BytesToSign string `json:"bytesToSign,omitempty"`

    // ForceSendFields is a list of field names (e.g. "BytesToSign") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "BytesToSign") to include
    // in API requests with the JSON null value. By default, fields with
    // empty values are omitted from API requests. However, any field with
    // an empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

SignBlobRequest: The service account sign blob request.

func (*SignBlobRequest) MarshalJSON Uses

func (s *SignBlobRequest) MarshalJSON() ([]byte, error)

type SignBlobResponse Uses

type SignBlobResponse struct {
    // KeyId: The id of the key used to sign the blob.
    KeyId string `json:"keyId,omitempty"`

    // Signature: The signed blob.
    Signature string `json:"signature,omitempty"`

    // ServerResponse contains the HTTP response code and headers from the
    // server.
    googleapi.ServerResponse `json:"-"`

    // ForceSendFields is a list of field names (e.g. "KeyId") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "KeyId") to include in API
    // requests with the JSON null value. By default, fields with empty
    // values are omitted from API requests. However, any field with an
    // empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

SignBlobResponse: The service account sign blob response.

func (*SignBlobResponse) MarshalJSON Uses

func (s *SignBlobResponse) MarshalJSON() ([]byte, error)

type SignJwtRequest Uses

type SignJwtRequest struct {
    // Payload: The JWT payload to sign, a JSON JWT Claim set.
    Payload string `json:"payload,omitempty"`

    // ForceSendFields is a list of field names (e.g. "Payload") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Payload") to include in
    // API requests with the JSON null value. By default, fields with empty
    // values are omitted from API requests. However, any field with an
    // empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

SignJwtRequest: The service account sign JWT request.

func (*SignJwtRequest) MarshalJSON Uses

func (s *SignJwtRequest) MarshalJSON() ([]byte, error)

type SignJwtResponse Uses

type SignJwtResponse struct {
    // KeyId: The id of the key used to sign the JWT.
    KeyId string `json:"keyId,omitempty"`

    // SignedJwt: The signed JWT.
    SignedJwt string `json:"signedJwt,omitempty"`

    // ServerResponse contains the HTTP response code and headers from the
    // server.
    googleapi.ServerResponse `json:"-"`

    // ForceSendFields is a list of field names (e.g. "KeyId") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "KeyId") to include in API
    // requests with the JSON null value. By default, fields with empty
    // values are omitted from API requests. However, any field with an
    // empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

SignJwtResponse: The service account sign JWT response.

func (*SignJwtResponse) MarshalJSON Uses

func (s *SignJwtResponse) MarshalJSON() ([]byte, error)

type TestIamPermissionsRequest Uses

type TestIamPermissionsRequest struct {
    // Permissions: The set of permissions to check for the `resource`.
    // Permissions with
    // wildcards (such as '*' or 'storage.*') are not allowed. For
    // more
    // information see
    // [IAM
    // Overview](https://cloud.google.com/iam/docs/overview#permissions).
    Permissions []string `json:"permissions,omitempty"`

    // ForceSendFields is a list of field names (e.g. "Permissions") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Permissions") to include
    // in API requests with the JSON null value. By default, fields with
    // empty values are omitted from API requests. However, any field with
    // an empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

TestIamPermissionsRequest: Request message for `TestIamPermissions` method.

func (*TestIamPermissionsRequest) MarshalJSON Uses

func (s *TestIamPermissionsRequest) MarshalJSON() ([]byte, error)

type TestIamPermissionsResponse Uses

type TestIamPermissionsResponse struct {
    // Permissions: A subset of `TestPermissionsRequest.permissions` that
    // the caller is
    // allowed.
    Permissions []string `json:"permissions,omitempty"`

    // ServerResponse contains the HTTP response code and headers from the
    // server.
    googleapi.ServerResponse `json:"-"`

    // ForceSendFields is a list of field names (e.g. "Permissions") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Permissions") to include
    // in API requests with the JSON null value. By default, fields with
    // empty values are omitted from API requests. However, any field with
    // an empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

TestIamPermissionsResponse: Response message for `TestIamPermissions` method.

func (*TestIamPermissionsResponse) MarshalJSON Uses

func (s *TestIamPermissionsResponse) MarshalJSON() ([]byte, error)

type UndeleteRoleRequest Uses

type UndeleteRoleRequest struct {
    // Etag: Used to perform a consistent read-modify-write.
    Etag string `json:"etag,omitempty"`

    // ForceSendFields is a list of field names (e.g. "Etag") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Etag") to include in API
    // requests with the JSON null value. By default, fields with empty
    // values are omitted from API requests. However, any field with an
    // empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

UndeleteRoleRequest: The request to undelete an existing role.

func (*UndeleteRoleRequest) MarshalJSON Uses

func (s *UndeleteRoleRequest) MarshalJSON() ([]byte, error)

type UndeleteServiceAccountRequest Uses

type UndeleteServiceAccountRequest struct {
}

UndeleteServiceAccountRequest: The service account undelete request.

type UndeleteServiceAccountResponse Uses

type UndeleteServiceAccountResponse struct {
    // RestoredAccount: Metadata for the restored service account.
    RestoredAccount *ServiceAccount `json:"restoredAccount,omitempty"`

    // ServerResponse contains the HTTP response code and headers from the
    // server.
    googleapi.ServerResponse `json:"-"`

    // ForceSendFields is a list of field names (e.g. "RestoredAccount") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "RestoredAccount") to
    // include in API requests with the JSON null value. By default, fields
    // with empty values are omitted from API requests. However, any field
    // with an empty value appearing in NullFields will be sent to the
    // server as null. It is an error if a field in this list has a
    // non-empty value. This may be used to include null fields in Patch
    // requests.
    NullFields []string `json:"-"`
}

func (*UndeleteServiceAccountResponse) MarshalJSON Uses

func (s *UndeleteServiceAccountResponse) MarshalJSON() ([]byte, error)

type UploadServiceAccountKeyRequest Uses

type UploadServiceAccountKeyRequest struct {
    // PublicKeyData: A field that allows clients to upload their own public
    // key. If set,
    // use this public key data to create a service account key for
    // given
    // service account.
    // Please note, the expected format for this field is X509_PEM.
    PublicKeyData string `json:"publicKeyData,omitempty"`

    // ForceSendFields is a list of field names (e.g. "PublicKeyData") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "PublicKeyData") to include
    // in API requests with the JSON null value. By default, fields with
    // empty values are omitted from API requests. However, any field with
    // an empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

UploadServiceAccountKeyRequest: The service account key upload request.

func (*UploadServiceAccountKeyRequest) MarshalJSON Uses

func (s *UploadServiceAccountKeyRequest) MarshalJSON() ([]byte, error)

Package iam imports 14 packages (graph) and is imported by 49 packages. Updated 2019-12-05. Refresh now. Tools for package owners.