Documentation ¶
Overview ¶
Package cloudasset provides access to the Cloud Asset API.
For product documentation, see: https://cloud.google.com/asset-inventory/docs/quickstart
Creating a client ¶
Usage example:
import "google.golang.org/api/cloudasset/v1beta1" ... ctx := context.Background() cloudassetService, err := cloudasset.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:
cloudassetService, err := cloudasset.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, ...) cloudassetService, err := cloudasset.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
See https://godoc.org/google.golang.org/api/option/ for details on options.
Index ¶
- Constants
- type Asset
- type AuditConfig
- type AuditLogConfig
- type BatchGetAssetsHistoryResponse
- type Binding
- type ExportAssetsRequest
- type Expr
- type FoldersExportAssetsCall
- func (c *FoldersExportAssetsCall) Context(ctx context.Context) *FoldersExportAssetsCall
- func (c *FoldersExportAssetsCall) Do(opts ...googleapi.CallOption) (*Operation, error)
- func (c *FoldersExportAssetsCall) Fields(s ...googleapi.Field) *FoldersExportAssetsCall
- func (c *FoldersExportAssetsCall) Header() http.Header
- type FoldersOperationsGetCall
- func (c *FoldersOperationsGetCall) Context(ctx context.Context) *FoldersOperationsGetCall
- func (c *FoldersOperationsGetCall) Do(opts ...googleapi.CallOption) (*Operation, error)
- func (c *FoldersOperationsGetCall) Fields(s ...googleapi.Field) *FoldersOperationsGetCall
- func (c *FoldersOperationsGetCall) Header() http.Header
- func (c *FoldersOperationsGetCall) IfNoneMatch(entityTag string) *FoldersOperationsGetCall
- type FoldersOperationsService
- type FoldersService
- type GcsDestination
- type Operation
- type OrganizationsBatchGetAssetsHistoryCall
- func (c *OrganizationsBatchGetAssetsHistoryCall) AssetNames(assetNames ...string) *OrganizationsBatchGetAssetsHistoryCall
- func (c *OrganizationsBatchGetAssetsHistoryCall) ContentType(contentType string) *OrganizationsBatchGetAssetsHistoryCall
- func (c *OrganizationsBatchGetAssetsHistoryCall) Context(ctx context.Context) *OrganizationsBatchGetAssetsHistoryCall
- func (c *OrganizationsBatchGetAssetsHistoryCall) Do(opts ...googleapi.CallOption) (*BatchGetAssetsHistoryResponse, error)
- func (c *OrganizationsBatchGetAssetsHistoryCall) Fields(s ...googleapi.Field) *OrganizationsBatchGetAssetsHistoryCall
- func (c *OrganizationsBatchGetAssetsHistoryCall) Header() http.Header
- func (c *OrganizationsBatchGetAssetsHistoryCall) IfNoneMatch(entityTag string) *OrganizationsBatchGetAssetsHistoryCall
- func (c *OrganizationsBatchGetAssetsHistoryCall) ReadTimeWindowEndTime(readTimeWindowEndTime string) *OrganizationsBatchGetAssetsHistoryCall
- func (c *OrganizationsBatchGetAssetsHistoryCall) ReadTimeWindowStartTime(readTimeWindowStartTime string) *OrganizationsBatchGetAssetsHistoryCall
- type OrganizationsExportAssetsCall
- func (c *OrganizationsExportAssetsCall) Context(ctx context.Context) *OrganizationsExportAssetsCall
- func (c *OrganizationsExportAssetsCall) Do(opts ...googleapi.CallOption) (*Operation, error)
- func (c *OrganizationsExportAssetsCall) Fields(s ...googleapi.Field) *OrganizationsExportAssetsCall
- func (c *OrganizationsExportAssetsCall) Header() http.Header
- type OrganizationsOperationsGetCall
- func (c *OrganizationsOperationsGetCall) Context(ctx context.Context) *OrganizationsOperationsGetCall
- func (c *OrganizationsOperationsGetCall) Do(opts ...googleapi.CallOption) (*Operation, error)
- func (c *OrganizationsOperationsGetCall) Fields(s ...googleapi.Field) *OrganizationsOperationsGetCall
- func (c *OrganizationsOperationsGetCall) Header() http.Header
- func (c *OrganizationsOperationsGetCall) IfNoneMatch(entityTag string) *OrganizationsOperationsGetCall
- type OrganizationsOperationsService
- type OrganizationsService
- type OutputConfig
- type Policy
- type ProjectsBatchGetAssetsHistoryCall
- func (c *ProjectsBatchGetAssetsHistoryCall) AssetNames(assetNames ...string) *ProjectsBatchGetAssetsHistoryCall
- func (c *ProjectsBatchGetAssetsHistoryCall) ContentType(contentType string) *ProjectsBatchGetAssetsHistoryCall
- func (c *ProjectsBatchGetAssetsHistoryCall) Context(ctx context.Context) *ProjectsBatchGetAssetsHistoryCall
- func (c *ProjectsBatchGetAssetsHistoryCall) Do(opts ...googleapi.CallOption) (*BatchGetAssetsHistoryResponse, error)
- func (c *ProjectsBatchGetAssetsHistoryCall) Fields(s ...googleapi.Field) *ProjectsBatchGetAssetsHistoryCall
- func (c *ProjectsBatchGetAssetsHistoryCall) Header() http.Header
- func (c *ProjectsBatchGetAssetsHistoryCall) IfNoneMatch(entityTag string) *ProjectsBatchGetAssetsHistoryCall
- func (c *ProjectsBatchGetAssetsHistoryCall) ReadTimeWindowEndTime(readTimeWindowEndTime string) *ProjectsBatchGetAssetsHistoryCall
- func (c *ProjectsBatchGetAssetsHistoryCall) ReadTimeWindowStartTime(readTimeWindowStartTime string) *ProjectsBatchGetAssetsHistoryCall
- type ProjectsExportAssetsCall
- func (c *ProjectsExportAssetsCall) Context(ctx context.Context) *ProjectsExportAssetsCall
- func (c *ProjectsExportAssetsCall) Do(opts ...googleapi.CallOption) (*Operation, error)
- func (c *ProjectsExportAssetsCall) Fields(s ...googleapi.Field) *ProjectsExportAssetsCall
- func (c *ProjectsExportAssetsCall) Header() http.Header
- type ProjectsOperationsGetCall
- func (c *ProjectsOperationsGetCall) Context(ctx context.Context) *ProjectsOperationsGetCall
- func (c *ProjectsOperationsGetCall) Do(opts ...googleapi.CallOption) (*Operation, error)
- func (c *ProjectsOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsOperationsGetCall
- func (c *ProjectsOperationsGetCall) Header() http.Header
- func (c *ProjectsOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsOperationsGetCall
- type ProjectsOperationsService
- type ProjectsService
- type Resource
- type Service
- type Status
- type TemporalAsset
- type TimeWindow
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.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Asset ¶
type Asset struct { // AssetType: Type of the asset. Example: "google.compute.Disk". AssetType string `json:"assetType,omitempty"` // IamPolicy: Representation of the actual Cloud IAM policy set on a // cloud resource. For // each resource, there must be at most one Cloud IAM policy set on it. IamPolicy *Policy `json:"iamPolicy,omitempty"` // Name: The full name of the asset. For // example: // `//compute.googleapis.com/projects/my_project_123/zones/zone1 // /instances/instance1`. // See // [Resource // Names](https://cloud.google.com/apis/design/resource_names#f // ull_resource_name) // for more information. Name string `json:"name,omitempty"` // Resource: Representation of the resource. Resource *Resource `json:"resource,omitempty"` // ForceSendFields is a list of field names (e.g. "AssetType") 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. "AssetType") 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:"-"` }
Asset: Cloud asset. This includes all Google Cloud Platform resources, Cloud IAM policies, and other non-GCP assets.
func (*Asset) MarshalJSON ¶
type AuditConfig ¶
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 ¶
func (s *AuditConfig) MarshalJSON() ([]byte, error)
type AuditLogConfig ¶
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 ¶
func (s *AuditLogConfig) MarshalJSON() ([]byte, error)
type BatchGetAssetsHistoryResponse ¶
type BatchGetAssetsHistoryResponse struct { // Assets: A list of assets with valid time windows. Assets []*TemporalAsset `json:"assets,omitempty"` // ServerResponse contains the HTTP response code and headers from the // server. googleapi.ServerResponse `json:"-"` // ForceSendFields is a list of field names (e.g. "Assets") 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. "Assets") 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:"-"` }
BatchGetAssetsHistoryResponse: Batch get assets history response.
func (*BatchGetAssetsHistoryResponse) MarshalJSON ¶
func (s *BatchGetAssetsHistoryResponse) MarshalJSON() ([]byte, error)
type Binding ¶
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`. // // * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus // unique // identifier) representing a user that has been recently deleted. // For // example, `alice@example.com?uid=123456789012345678901`. If the // user is // recovered, this value reverts to `user:{emailid}` and the // recovered user // retains the role in the binding. // // * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address // (plus // unique identifier) representing a service account that has been // recently // deleted. For example, // // `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. // // If the service account is undeleted, this value reverts to // `serviceAccount:{emailid}` and the undeleted service account // retains the // role in the binding. // // * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus // unique // identifier) representing a Google group that has been recently // deleted. For example, // `admins@example.com?uid=123456789012345678901`. If // the group is recovered, this value reverts to `group:{emailid}` // and the // recovered group retains the role in the binding. // // // * `domain:{domain}`: The G Suite domain (primary) that represents all // the // users of that domain. For example, `google.com` or // `example.com`. // // 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 ¶
type ExportAssetsRequest ¶
type ExportAssetsRequest struct { // AssetTypes: A list of asset types of which to take a snapshot for. // For example: // "google.compute.Disk". If specified, only matching assets will be // returned. // See [Introduction to Cloud // Asset // Inventory](https://cloud.google.com/resource-manager/docs/cloud- // asset-inventory/overview) // for all supported asset types. AssetTypes []string `json:"assetTypes,omitempty"` // ContentType: Asset content type. If not specified, no content but the // asset name will be // returned. // // Possible values: // "CONTENT_TYPE_UNSPECIFIED" - Unspecified content type. // "RESOURCE" - Resource metadata. // "IAM_POLICY" - The actual IAM policy set on a resource. ContentType string `json:"contentType,omitempty"` // OutputConfig: Required. Output configuration indicating where the // results will be output // to. All results will be in newline delimited JSON format. OutputConfig *OutputConfig `json:"outputConfig,omitempty"` // ReadTime: Timestamp to take an asset snapshot. This can only be set // to a timestamp // between 2018-10-02 UTC (inclusive) and the current time. If not // specified, // the current time will be used. Due to delays in resource data // collection // and indexing, there is a volatile window during which running the // same // query may get different results. ReadTime string `json:"readTime,omitempty"` // ForceSendFields is a list of field names (e.g. "AssetTypes") 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. "AssetTypes") 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:"-"` }
ExportAssetsRequest: Export asset request.
func (*ExportAssetsRequest) MarshalJSON ¶
func (s *ExportAssetsRequest) MarshalJSON() ([]byte, error)
type Expr ¶
type Expr struct { // Description: 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. Expression string `json:"expression,omitempty"` // Location: 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: 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 a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec.
Example (Comparison):
title: "Summary size limit" description: "Determines if a summary is less than 100 chars" expression: "document.summary.size() < 100"
Example (Equality):
title: "Requestor is owner" description: "Determines if requestor is the document owner" expression: "document.owner ==
request.auth.claims.email"
Example (Logic):
title: "Public documents" description: "Determine whether the document should be publicly
visible"
expression: "document.type != 'private' && document.type !=
'internal'"
Example (Data Manipulation):
title: "Notification string" description: "Create a notification string with a timestamp." expression: "'New message received at ' +
string(document.create_time)"
The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information.
func (*Expr) MarshalJSON ¶
type FoldersExportAssetsCall ¶
type FoldersExportAssetsCall struct {
// contains filtered or unexported fields
}
func (*FoldersExportAssetsCall) Context ¶
func (c *FoldersExportAssetsCall) Context(ctx context.Context) *FoldersExportAssetsCall
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 (*FoldersExportAssetsCall) Do ¶
func (c *FoldersExportAssetsCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "cloudasset.folders.exportAssets" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.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 (*FoldersExportAssetsCall) Fields ¶
func (c *FoldersExportAssetsCall) Fields(s ...googleapi.Field) *FoldersExportAssetsCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (*FoldersExportAssetsCall) Header ¶
func (c *FoldersExportAssetsCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
type FoldersOperationsGetCall ¶
type FoldersOperationsGetCall struct {
// contains filtered or unexported fields
}
func (*FoldersOperationsGetCall) Context ¶
func (c *FoldersOperationsGetCall) Context(ctx context.Context) *FoldersOperationsGetCall
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 (*FoldersOperationsGetCall) Do ¶
func (c *FoldersOperationsGetCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "cloudasset.folders.operations.get" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.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 (*FoldersOperationsGetCall) Fields ¶
func (c *FoldersOperationsGetCall) Fields(s ...googleapi.Field) *FoldersOperationsGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (*FoldersOperationsGetCall) Header ¶
func (c *FoldersOperationsGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (*FoldersOperationsGetCall) IfNoneMatch ¶
func (c *FoldersOperationsGetCall) IfNoneMatch(entityTag string) *FoldersOperationsGetCall
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 FoldersOperationsService ¶
type FoldersOperationsService struct {
// contains filtered or unexported fields
}
func NewFoldersOperationsService ¶
func NewFoldersOperationsService(s *Service) *FoldersOperationsService
func (*FoldersOperationsService) Get ¶
func (r *FoldersOperationsService) Get(name string) *FoldersOperationsGetCall
Get: Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.
type FoldersService ¶
type FoldersService struct { Operations *FoldersOperationsService // contains filtered or unexported fields }
func NewFoldersService ¶
func NewFoldersService(s *Service) *FoldersService
func (*FoldersService) ExportAssets ¶
func (r *FoldersService) ExportAssets(parent string, exportassetsrequest *ExportAssetsRequest) *FoldersExportAssetsCall
ExportAssets: Exports assets with time and resource types to a given Cloud Storage location. The output format is newline-delimited JSON. This API implements the google.longrunning.Operation API allowing you to keep track of the export.
type GcsDestination ¶
type GcsDestination struct { // Uri: The uri of the Cloud Storage object. It's the same uri that is // used by // gsutil. For example: "gs://bucket_name/object_name". See [Viewing // and // Editing // Object // Metadata](https://cloud.google.com/storage/docs/viewing-editing // -metadata) // for more information. Uri string `json:"uri,omitempty"` // UriPrefix: The uri prefix of all generated Cloud Storage objects. For // example: // "gs://bucket_name/object_name_prefix". Each object uri is in // format: // "gs://bucket_name/object_name_prefix/<asset type>/<shard number> and // only // contains assets for that type. <shard number> starts from 0. For // example: // "gs://bucket_name/object_name_prefix/google.compute.disk/0" is the // first // shard of output objects containing all google.compute.disk assets. // An INVALID_ARGUMENT error will be returned if file with the same // name // "gs://bucket_name/object_name_prefix" already exists. UriPrefix string `json:"uriPrefix,omitempty"` // ForceSendFields is a list of field names (e.g. "Uri") 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. "Uri") 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:"-"` }
GcsDestination: A Cloud Storage location.
func (*GcsDestination) MarshalJSON ¶
func (s *GcsDestination) MarshalJSON() ([]byte, error)
type Operation ¶
type Operation struct { // Done: If the value is `false`, it means the operation is still in // progress. // If `true`, the operation is completed, and either `error` or // `response` is // available. Done bool `json:"done,omitempty"` // Error: The error result of the operation in case of failure or // cancellation. Error *Status `json:"error,omitempty"` // Metadata: Service-specific metadata associated with the operation. // It typically // contains progress information and common metadata such as create // time. // Some services might not provide such metadata. Any method that // returns a // long-running operation should document the metadata type, if any. Metadata googleapi.RawMessage `json:"metadata,omitempty"` // Name: The server-assigned name, which is only unique within the same // service that // originally returns it. If you use the default HTTP mapping, // the // `name` should be a resource name ending with // `operations/{unique_id}`. Name string `json:"name,omitempty"` // Response: The normal response of the operation in case of success. // If the original // method returns no data on success, such as `Delete`, the response // is // `google.protobuf.Empty`. If the original method is // standard // `Get`/`Create`/`Update`, the response should be the resource. For // other // methods, the response should have the type `XxxResponse`, where // `Xxx` // is the original method name. For example, if the original method // name // is `TakeSnapshot()`, the inferred response type // is // `TakeSnapshotResponse`. Response googleapi.RawMessage `json:"response,omitempty"` // ServerResponse contains the HTTP response code and headers from the // server. googleapi.ServerResponse `json:"-"` // ForceSendFields is a list of field names (e.g. "Done") 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. "Done") 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:"-"` }
Operation: This resource represents a long-running operation that is the result of a network API call.
func (*Operation) MarshalJSON ¶
type OrganizationsBatchGetAssetsHistoryCall ¶
type OrganizationsBatchGetAssetsHistoryCall struct {
// contains filtered or unexported fields
}
func (*OrganizationsBatchGetAssetsHistoryCall) AssetNames ¶
func (c *OrganizationsBatchGetAssetsHistoryCall) AssetNames(assetNames ...string) *OrganizationsBatchGetAssetsHistoryCall
AssetNames sets the optional parameter "assetNames": A list of the full names of the assets. For example: `//compute.googleapis.com/projects/my_project_123/zones/zone1 /instances/instance1`. See [Resource Names](https://cloud.google.com/apis/design/resource_names#f ull_resource_name) for more info.
The request becomes a no-op if the asset name list is empty, and the max size of the asset name list is 100 in one request.
func (*OrganizationsBatchGetAssetsHistoryCall) ContentType ¶
func (c *OrganizationsBatchGetAssetsHistoryCall) ContentType(contentType string) *OrganizationsBatchGetAssetsHistoryCall
ContentType sets the optional parameter "contentType": The content type.
Possible values:
"CONTENT_TYPE_UNSPECIFIED" "RESOURCE" "IAM_POLICY"
func (*OrganizationsBatchGetAssetsHistoryCall) Context ¶
func (c *OrganizationsBatchGetAssetsHistoryCall) Context(ctx context.Context) *OrganizationsBatchGetAssetsHistoryCall
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 (*OrganizationsBatchGetAssetsHistoryCall) Do ¶
func (c *OrganizationsBatchGetAssetsHistoryCall) Do(opts ...googleapi.CallOption) (*BatchGetAssetsHistoryResponse, error)
Do executes the "cloudasset.organizations.batchGetAssetsHistory" call. Exactly one of *BatchGetAssetsHistoryResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *BatchGetAssetsHistoryResponse.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 (*OrganizationsBatchGetAssetsHistoryCall) Fields ¶
func (c *OrganizationsBatchGetAssetsHistoryCall) Fields(s ...googleapi.Field) *OrganizationsBatchGetAssetsHistoryCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (*OrganizationsBatchGetAssetsHistoryCall) Header ¶
func (c *OrganizationsBatchGetAssetsHistoryCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (*OrganizationsBatchGetAssetsHistoryCall) IfNoneMatch ¶
func (c *OrganizationsBatchGetAssetsHistoryCall) IfNoneMatch(entityTag string) *OrganizationsBatchGetAssetsHistoryCall
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 (*OrganizationsBatchGetAssetsHistoryCall) ReadTimeWindowEndTime ¶
func (c *OrganizationsBatchGetAssetsHistoryCall) ReadTimeWindowEndTime(readTimeWindowEndTime string) *OrganizationsBatchGetAssetsHistoryCall
ReadTimeWindowEndTime sets the optional parameter "readTimeWindow.endTime": End time of the time window (inclusive). Current timestamp if not specified.
func (*OrganizationsBatchGetAssetsHistoryCall) ReadTimeWindowStartTime ¶
func (c *OrganizationsBatchGetAssetsHistoryCall) ReadTimeWindowStartTime(readTimeWindowStartTime string) *OrganizationsBatchGetAssetsHistoryCall
ReadTimeWindowStartTime sets the optional parameter "readTimeWindow.startTime": Start time of the time window (exclusive).
type OrganizationsExportAssetsCall ¶
type OrganizationsExportAssetsCall struct {
// contains filtered or unexported fields
}
func (*OrganizationsExportAssetsCall) Context ¶
func (c *OrganizationsExportAssetsCall) Context(ctx context.Context) *OrganizationsExportAssetsCall
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 (*OrganizationsExportAssetsCall) Do ¶
func (c *OrganizationsExportAssetsCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "cloudasset.organizations.exportAssets" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.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 (*OrganizationsExportAssetsCall) Fields ¶
func (c *OrganizationsExportAssetsCall) Fields(s ...googleapi.Field) *OrganizationsExportAssetsCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (*OrganizationsExportAssetsCall) Header ¶
func (c *OrganizationsExportAssetsCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
type OrganizationsOperationsGetCall ¶
type OrganizationsOperationsGetCall struct {
// contains filtered or unexported fields
}
func (*OrganizationsOperationsGetCall) Context ¶
func (c *OrganizationsOperationsGetCall) Context(ctx context.Context) *OrganizationsOperationsGetCall
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 (*OrganizationsOperationsGetCall) Do ¶
func (c *OrganizationsOperationsGetCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "cloudasset.organizations.operations.get" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.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 (*OrganizationsOperationsGetCall) Fields ¶
func (c *OrganizationsOperationsGetCall) Fields(s ...googleapi.Field) *OrganizationsOperationsGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (*OrganizationsOperationsGetCall) Header ¶
func (c *OrganizationsOperationsGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (*OrganizationsOperationsGetCall) IfNoneMatch ¶
func (c *OrganizationsOperationsGetCall) IfNoneMatch(entityTag string) *OrganizationsOperationsGetCall
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 OrganizationsOperationsService ¶
type OrganizationsOperationsService struct {
// contains filtered or unexported fields
}
func NewOrganizationsOperationsService ¶
func NewOrganizationsOperationsService(s *Service) *OrganizationsOperationsService
func (*OrganizationsOperationsService) Get ¶
func (r *OrganizationsOperationsService) Get(name string) *OrganizationsOperationsGetCall
Get: Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.
type OrganizationsService ¶
type OrganizationsService struct { Operations *OrganizationsOperationsService // contains filtered or unexported fields }
func NewOrganizationsService ¶
func NewOrganizationsService(s *Service) *OrganizationsService
func (*OrganizationsService) BatchGetAssetsHistory ¶
func (r *OrganizationsService) BatchGetAssetsHistory(parent string) *OrganizationsBatchGetAssetsHistoryCall
BatchGetAssetsHistory: Batch gets the update history of assets that overlap a time window. For RESOURCE content, this API outputs history with asset in both non-delete or deleted status. For IAM_POLICY content, this API outputs history when the asset and its attached IAM POLICY both exist. This can create gaps in the output history. If a specified asset does not exist, this API returns an INVALID_ARGUMENT error.
func (*OrganizationsService) ExportAssets ¶
func (r *OrganizationsService) ExportAssets(parent string, exportassetsrequest *ExportAssetsRequest) *OrganizationsExportAssetsCall
ExportAssets: Exports assets with time and resource types to a given Cloud Storage location. The output format is newline-delimited JSON. This API implements the google.longrunning.Operation API allowing you to keep track of the export.
type OutputConfig ¶
type OutputConfig struct { // GcsDestination: Destination on Cloud Storage. GcsDestination *GcsDestination `json:"gcsDestination,omitempty"` // ForceSendFields is a list of field names (e.g. "GcsDestination") 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. "GcsDestination") 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:"-"` }
OutputConfig: Output configuration for export assets destination.
func (*OutputConfig) MarshalJSON ¶
func (s *OutputConfig) MarshalJSON() ([]byte, error)
type Policy ¶
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 how and when the `bindings` are applied. // Each // of the `bindings` must contain at least one member. 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. // // **Important:** If you use IAM Conditions, you must include the `etag` // field // whenever you call `setIamPolicy`. If you omit this field, then IAM // allows // you to overwrite a version `3` policy with a version `1` policy, and // all of // the conditions in the version `3` policy are lost. Etag string `json:"etag,omitempty"` // Version: Specifies the format of the policy. // // Valid values are `0`, `1`, and `3`. Requests that specify an invalid // value // are rejected. // // Any operation that affects conditional role bindings must specify // version // `3`. This requirement applies to the following operations: // // * Getting a policy that includes a conditional role binding // * Adding a conditional role binding to a policy // * Changing a conditional role binding in a policy // * Removing any role binding, with or without a condition, from a // policy // that includes conditions // // **Important:** If you use IAM Conditions, you must include the `etag` // field // whenever you call `setIamPolicy`. If you omit this field, then IAM // allows // you to overwrite a version `3` policy with a version `1` policy, and // all of // the conditions in the version `3` policy are lost. // // If a policy does not include any conditions, operations on that // policy may // specify any valid version or leave the field unset. Version int64 `json:"version,omitempty"` // 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: An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud 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; each `role` can be an IAM predefined role or a user-created custom role.
Optionally, a `binding` can specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both.
**JSON example:**
{ "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')",
} } ], "etag": "BwWWja0YfJA=", "version": 3 }
**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')
- etag: BwWWja0YfJA=
- version: 3
For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/).
func (*Policy) MarshalJSON ¶
type ProjectsBatchGetAssetsHistoryCall ¶
type ProjectsBatchGetAssetsHistoryCall struct {
// contains filtered or unexported fields
}
func (*ProjectsBatchGetAssetsHistoryCall) AssetNames ¶
func (c *ProjectsBatchGetAssetsHistoryCall) AssetNames(assetNames ...string) *ProjectsBatchGetAssetsHistoryCall
AssetNames sets the optional parameter "assetNames": A list of the full names of the assets. For example: `//compute.googleapis.com/projects/my_project_123/zones/zone1 /instances/instance1`. See [Resource Names](https://cloud.google.com/apis/design/resource_names#f ull_resource_name) for more info.
The request becomes a no-op if the asset name list is empty, and the max size of the asset name list is 100 in one request.
func (*ProjectsBatchGetAssetsHistoryCall) ContentType ¶
func (c *ProjectsBatchGetAssetsHistoryCall) ContentType(contentType string) *ProjectsBatchGetAssetsHistoryCall
ContentType sets the optional parameter "contentType": The content type.
Possible values:
"CONTENT_TYPE_UNSPECIFIED" "RESOURCE" "IAM_POLICY"
func (*ProjectsBatchGetAssetsHistoryCall) Context ¶
func (c *ProjectsBatchGetAssetsHistoryCall) Context(ctx context.Context) *ProjectsBatchGetAssetsHistoryCall
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 (*ProjectsBatchGetAssetsHistoryCall) Do ¶
func (c *ProjectsBatchGetAssetsHistoryCall) Do(opts ...googleapi.CallOption) (*BatchGetAssetsHistoryResponse, error)
Do executes the "cloudasset.projects.batchGetAssetsHistory" call. Exactly one of *BatchGetAssetsHistoryResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *BatchGetAssetsHistoryResponse.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 (*ProjectsBatchGetAssetsHistoryCall) Fields ¶
func (c *ProjectsBatchGetAssetsHistoryCall) Fields(s ...googleapi.Field) *ProjectsBatchGetAssetsHistoryCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (*ProjectsBatchGetAssetsHistoryCall) Header ¶
func (c *ProjectsBatchGetAssetsHistoryCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (*ProjectsBatchGetAssetsHistoryCall) IfNoneMatch ¶
func (c *ProjectsBatchGetAssetsHistoryCall) IfNoneMatch(entityTag string) *ProjectsBatchGetAssetsHistoryCall
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 (*ProjectsBatchGetAssetsHistoryCall) ReadTimeWindowEndTime ¶
func (c *ProjectsBatchGetAssetsHistoryCall) ReadTimeWindowEndTime(readTimeWindowEndTime string) *ProjectsBatchGetAssetsHistoryCall
ReadTimeWindowEndTime sets the optional parameter "readTimeWindow.endTime": End time of the time window (inclusive). Current timestamp if not specified.
func (*ProjectsBatchGetAssetsHistoryCall) ReadTimeWindowStartTime ¶
func (c *ProjectsBatchGetAssetsHistoryCall) ReadTimeWindowStartTime(readTimeWindowStartTime string) *ProjectsBatchGetAssetsHistoryCall
ReadTimeWindowStartTime sets the optional parameter "readTimeWindow.startTime": Start time of the time window (exclusive).
type ProjectsExportAssetsCall ¶
type ProjectsExportAssetsCall struct {
// contains filtered or unexported fields
}
func (*ProjectsExportAssetsCall) Context ¶
func (c *ProjectsExportAssetsCall) Context(ctx context.Context) *ProjectsExportAssetsCall
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 (*ProjectsExportAssetsCall) Do ¶
func (c *ProjectsExportAssetsCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "cloudasset.projects.exportAssets" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.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 (*ProjectsExportAssetsCall) Fields ¶
func (c *ProjectsExportAssetsCall) Fields(s ...googleapi.Field) *ProjectsExportAssetsCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (*ProjectsExportAssetsCall) Header ¶
func (c *ProjectsExportAssetsCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
type ProjectsOperationsGetCall ¶
type ProjectsOperationsGetCall struct {
// contains filtered or unexported fields
}
func (*ProjectsOperationsGetCall) Context ¶
func (c *ProjectsOperationsGetCall) Context(ctx context.Context) *ProjectsOperationsGetCall
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 (*ProjectsOperationsGetCall) Do ¶
func (c *ProjectsOperationsGetCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "cloudasset.projects.operations.get" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.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 (*ProjectsOperationsGetCall) Fields ¶
func (c *ProjectsOperationsGetCall) Fields(s ...googleapi.Field) *ProjectsOperationsGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (*ProjectsOperationsGetCall) Header ¶
func (c *ProjectsOperationsGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (*ProjectsOperationsGetCall) IfNoneMatch ¶
func (c *ProjectsOperationsGetCall) IfNoneMatch(entityTag string) *ProjectsOperationsGetCall
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 ProjectsOperationsService ¶
type ProjectsOperationsService struct {
// contains filtered or unexported fields
}
func NewProjectsOperationsService ¶
func NewProjectsOperationsService(s *Service) *ProjectsOperationsService
func (*ProjectsOperationsService) Get ¶
func (r *ProjectsOperationsService) Get(name string) *ProjectsOperationsGetCall
Get: Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.
type ProjectsService ¶
type ProjectsService struct { Operations *ProjectsOperationsService // contains filtered or unexported fields }
func NewProjectsService ¶
func NewProjectsService(s *Service) *ProjectsService
func (*ProjectsService) BatchGetAssetsHistory ¶
func (r *ProjectsService) BatchGetAssetsHistory(parent string) *ProjectsBatchGetAssetsHistoryCall
BatchGetAssetsHistory: Batch gets the update history of assets that overlap a time window. For RESOURCE content, this API outputs history with asset in both non-delete or deleted status. For IAM_POLICY content, this API outputs history when the asset and its attached IAM POLICY both exist. This can create gaps in the output history. If a specified asset does not exist, this API returns an INVALID_ARGUMENT error.
func (*ProjectsService) ExportAssets ¶
func (r *ProjectsService) ExportAssets(parent string, exportassetsrequest *ExportAssetsRequest) *ProjectsExportAssetsCall
ExportAssets: Exports assets with time and resource types to a given Cloud Storage location. The output format is newline-delimited JSON. This API implements the google.longrunning.Operation API allowing you to keep track of the export.
type Resource ¶
type Resource struct { // Data: The content of the resource, in which some sensitive fields are // scrubbed // away and may not be present. Data googleapi.RawMessage `json:"data,omitempty"` // DiscoveryDocumentUri: The URL of the discovery document containing // the resource's JSON schema. // For // example: // "https://www.googleapis.com/discovery/v1/apis/compute/v1/res // t". // It will be left unspecified for resources without a discovery-based // API, // such as Cloud Bigtable. DiscoveryDocumentUri string `json:"discoveryDocumentUri,omitempty"` // DiscoveryName: The JSON schema name listed in the discovery // document. // Example: "Project". It will be left unspecified for resources (such // as // Cloud Bigtable) without a discovery-based API. DiscoveryName string `json:"discoveryName,omitempty"` // Parent: The full name of the immediate parent of this resource. // See // [Resource // Names](https://cloud.google.com/apis/design/resource_nam // es#full_resource_name) // for more information. // // For GCP assets, it is the parent resource defined in the [Cloud IAM // policy // hierarchy](https://cloud.google.com/iam/docs/overview#policy_hi // erarchy). // For // example: // "//cloudresourcemanager.googleapis.com/projects/my_project_1 // 23". // // For third-party assets, it is up to the users to define. Parent string `json:"parent,omitempty"` // ResourceUrl: The REST URL for accessing the resource. An HTTP GET // operation using this // URL returns the resource // itself. // Example: // `https://cloudresourcemanager.googleapis.com/v1/proje // cts/my-project-123`. // It will be left unspecified for resources without a REST API. ResourceUrl string `json:"resourceUrl,omitempty"` // Version: The API version. Example: "v1". Version string `json:"version,omitempty"` // ForceSendFields is a list of field names (e.g. "Data") 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. "Data") 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:"-"` }
Resource: Representation of a cloud resource.
func (*Resource) MarshalJSON ¶
type Service ¶
type Service struct { BasePath string // API endpoint base URL UserAgent string // optional additional User-Agent fragment Folders *FoldersService Organizations *OrganizationsService Projects *ProjectsService // contains filtered or unexported fields }
func New
deprecated
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 ¶
NewService creates a new Service.
type Status ¶
type Status struct { // Code: The status code, which should be an enum value of // google.rpc.Code. Code int64 `json:"code,omitempty"` // Details: A list of messages that carry the error details. There is a // common set of // message types for APIs to use. Details []googleapi.RawMessage `json:"details,omitempty"` // Message: A developer-facing error message, which should be in // English. Any // user-facing error message should be localized and sent in // the // google.rpc.Status.details field, or localized by the client. Message string `json:"message,omitempty"` // ForceSendFields is a list of field names (e.g. "Code") 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. "Code") 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:"-"` }
Status: The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details.
You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).
func (*Status) MarshalJSON ¶
type TemporalAsset ¶
type TemporalAsset struct { // Asset: Asset. Asset *Asset `json:"asset,omitempty"` // Deleted: If the asset is deleted or not. Deleted bool `json:"deleted,omitempty"` // Window: The time window when the asset data and state was observed. Window *TimeWindow `json:"window,omitempty"` // ForceSendFields is a list of field names (e.g. "Asset") 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. "Asset") 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:"-"` }
TemporalAsset: Temporal asset. In addition to the asset, the temporal asset includes the status of the asset and valid from and to time of it.
func (*TemporalAsset) MarshalJSON ¶
func (s *TemporalAsset) MarshalJSON() ([]byte, error)
type TimeWindow ¶
type TimeWindow struct { // EndTime: End time of the time window (inclusive). // Current timestamp if not specified. EndTime string `json:"endTime,omitempty"` // StartTime: Start time of the time window (exclusive). StartTime string `json:"startTime,omitempty"` // ForceSendFields is a list of field names (e.g. "EndTime") 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. "EndTime") 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:"-"` }
TimeWindow: A time window of (start_time, end_time].
func (*TimeWindow) MarshalJSON ¶
func (s *TimeWindow) MarshalJSON() ([]byte, error)