recommender

package
v0.48.1-0...-67a0a95 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jun 22, 2021 License: BSD-3-Clause Imports: 15 Imported by: 0

Documentation

Overview

Package recommender provides access to the Recommender API.

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

Creating a client

Usage example:

import "google.golang.org/api/recommender/v1"
...
ctx := context.Background()
recommenderService, err := recommender.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:

recommenderService, err := recommender.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, ...)
recommenderService, err := recommender.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))

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

Index

Constants

View Source
const (
	// See, edit, configure, and delete your Google Cloud Platform data
	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 BillingAccountsLocationsInsightTypesInsightsGetCall

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

func (*BillingAccountsLocationsInsightTypesInsightsGetCall) Context

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 (*BillingAccountsLocationsInsightTypesInsightsGetCall) Do

Do executes the "recommender.billingAccounts.locations.insightTypes.insights.get" call. Exactly one of *GoogleCloudRecommenderV1Insight or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *GoogleCloudRecommenderV1Insight.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 (*BillingAccountsLocationsInsightTypesInsightsGetCall) Fields

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

func (*BillingAccountsLocationsInsightTypesInsightsGetCall) Header

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

func (*BillingAccountsLocationsInsightTypesInsightsGetCall) IfNoneMatch

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 BillingAccountsLocationsInsightTypesInsightsListCall

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

func (*BillingAccountsLocationsInsightTypesInsightsListCall) Context

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 (*BillingAccountsLocationsInsightTypesInsightsListCall) Do

Do executes the "recommender.billingAccounts.locations.insightTypes.insights.list" call. Exactly one of *GoogleCloudRecommenderV1ListInsightsResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *GoogleCloudRecommenderV1ListInsightsResponse.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 (*BillingAccountsLocationsInsightTypesInsightsListCall) Fields

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

func (*BillingAccountsLocationsInsightTypesInsightsListCall) Filter

Filter sets the optional parameter "filter": Filter expression to restrict the insights returned. Supported filter fields: * `stateInfo.state` * `insightSubtype` * `severity` Examples: * `stateInfo.state = ACTIVE OR stateInfo.state = DISMISSED` * `insightSubtype = PERMISSIONS_USAGE` * `severity = CRITICAL OR severity = HIGH` * `stateInfo.state = ACTIVE AND (severity = CRITICAL OR severity = HIGH)` (These expressions are based on the filter language described at https://google.aip.dev/160)

func (*BillingAccountsLocationsInsightTypesInsightsListCall) Header

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

func (*BillingAccountsLocationsInsightTypesInsightsListCall) IfNoneMatch

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 (*BillingAccountsLocationsInsightTypesInsightsListCall) PageSize

PageSize sets the optional parameter "pageSize": The maximum number of results to return from this request. Non-positive values are ignored. If not specified, the server will determine the number of results to return.

func (*BillingAccountsLocationsInsightTypesInsightsListCall) PageToken

PageToken sets the optional parameter "pageToken": If present, retrieves the next batch of results from the preceding call to this method. `page_token` must be the value of `next_page_token` from the previous response. The values of other method parameters must be identical to those in the previous call.

func (*BillingAccountsLocationsInsightTypesInsightsListCall) Pages

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 BillingAccountsLocationsInsightTypesInsightsMarkAcceptedCall

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

func (*BillingAccountsLocationsInsightTypesInsightsMarkAcceptedCall) Context

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 (*BillingAccountsLocationsInsightTypesInsightsMarkAcceptedCall) Do

Do executes the "recommender.billingAccounts.locations.insightTypes.insights.markAccepted" call. Exactly one of *GoogleCloudRecommenderV1Insight or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *GoogleCloudRecommenderV1Insight.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 (*BillingAccountsLocationsInsightTypesInsightsMarkAcceptedCall) Fields

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

func (*BillingAccountsLocationsInsightTypesInsightsMarkAcceptedCall) Header

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

type BillingAccountsLocationsInsightTypesInsightsService

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

func (*BillingAccountsLocationsInsightTypesInsightsService) Get

Get: Gets the requested insight. Requires the recommender.*.get IAM permission for the specified insight type.

- name: Name of the insight.

func (*BillingAccountsLocationsInsightTypesInsightsService) List

List: Lists insights for the specified Cloud Resource. Requires the recommender.*.list IAM permission for the specified insight type.

  • parent: The container resource on which to execute the request. Acceptable formats: 1. `projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGH T_TYPE_ID]` 2. `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/insightTy pes/[INSIGHT_TYPE_ID]` 3. `folders/[FOLDER_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE _ID]` 4. `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/insightTypes/[ INSIGHT_TYPE_ID]` LOCATION here refers to GCP Locations: https://cloud.google.com/about/locations/ INSIGHT_TYPE_ID refers to supported insight types: https://cloud.google.com/recommender/docs/insights/insight-types.

func (*BillingAccountsLocationsInsightTypesInsightsService) MarkAccepted

MarkAccepted: Marks the Insight State as Accepted. Users can use this method to indicate to the Recommender API that they have applied some action based on the insight. This stops the insight content from being updated. MarkInsightAccepted can be applied to insights in ACTIVE state. Requires the recommender.*.update IAM permission for the specified insight.

- name: Name of the insight.

type BillingAccountsLocationsInsightTypesService

type BillingAccountsLocationsInsightTypesService struct {
	Insights *BillingAccountsLocationsInsightTypesInsightsService
	// contains filtered or unexported fields
}

func NewBillingAccountsLocationsInsightTypesService

func NewBillingAccountsLocationsInsightTypesService(s *Service) *BillingAccountsLocationsInsightTypesService

type BillingAccountsLocationsRecommendersRecommendationsGetCall

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

func (*BillingAccountsLocationsRecommendersRecommendationsGetCall) Context

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 (*BillingAccountsLocationsRecommendersRecommendationsGetCall) Do

Do executes the "recommender.billingAccounts.locations.recommenders.recommendations.get" call. Exactly one of *GoogleCloudRecommenderV1Recommendation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *GoogleCloudRecommenderV1Recommendation.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 (*BillingAccountsLocationsRecommendersRecommendationsGetCall) Fields

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

func (*BillingAccountsLocationsRecommendersRecommendationsGetCall) Header

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

func (*BillingAccountsLocationsRecommendersRecommendationsGetCall) IfNoneMatch

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 BillingAccountsLocationsRecommendersRecommendationsListCall

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

func (*BillingAccountsLocationsRecommendersRecommendationsListCall) Context

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 (*BillingAccountsLocationsRecommendersRecommendationsListCall) Do

Do executes the "recommender.billingAccounts.locations.recommenders.recommendations.list" call. Exactly one of *GoogleCloudRecommenderV1ListRecommendationsResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *GoogleCloudRecommenderV1ListRecommendationsResponse.ServerResponse.He ader 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 (*BillingAccountsLocationsRecommendersRecommendationsListCall) Fields

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

func (*BillingAccountsLocationsRecommendersRecommendationsListCall) Filter

Filter sets the optional parameter "filter": Filter expression to restrict the recommendations returned. Supported filter fields: * `state_info.state` * `recommenderSubtype` * `priority` Examples: * `stateInfo.state = ACTIVE OR stateInfo.state = DISMISSED` * `recommenderSubtype = REMOVE_ROLE OR recommenderSubtype = REPLACE_ROLE` * `priority = P1 OR priority = P2` * `stateInfo.state = ACTIVE AND (priority = P1 OR priority = P2)` (These expressions are based on the filter language described at https://google.aip.dev/160)

func (*BillingAccountsLocationsRecommendersRecommendationsListCall) Header

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

func (*BillingAccountsLocationsRecommendersRecommendationsListCall) IfNoneMatch

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 (*BillingAccountsLocationsRecommendersRecommendationsListCall) PageSize

PageSize sets the optional parameter "pageSize": The maximum number of results to return from this request. Non-positive values are ignored. If not specified, the server will determine the number of results to return.

func (*BillingAccountsLocationsRecommendersRecommendationsListCall) PageToken

PageToken sets the optional parameter "pageToken": If present, retrieves the next batch of results from the preceding call to this method. `page_token` must be the value of `next_page_token` from the previous response. The values of other method parameters must be identical to those in the previous call.

func (*BillingAccountsLocationsRecommendersRecommendationsListCall) Pages

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 BillingAccountsLocationsRecommendersRecommendationsMarkClaimedCall

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

func (*BillingAccountsLocationsRecommendersRecommendationsMarkClaimedCall) Context

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 (*BillingAccountsLocationsRecommendersRecommendationsMarkClaimedCall) Do

Do executes the "recommender.billingAccounts.locations.recommenders.recommendations.markClaimed" call. Exactly one of *GoogleCloudRecommenderV1Recommendation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *GoogleCloudRecommenderV1Recommendation.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 (*BillingAccountsLocationsRecommendersRecommendationsMarkClaimedCall) Fields

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

func (*BillingAccountsLocationsRecommendersRecommendationsMarkClaimedCall) Header

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

type BillingAccountsLocationsRecommendersRecommendationsMarkFailedCall

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

func (*BillingAccountsLocationsRecommendersRecommendationsMarkFailedCall) Context

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 (*BillingAccountsLocationsRecommendersRecommendationsMarkFailedCall) Do

Do executes the "recommender.billingAccounts.locations.recommenders.recommendations.markFailed" call. Exactly one of *GoogleCloudRecommenderV1Recommendation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *GoogleCloudRecommenderV1Recommendation.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 (*BillingAccountsLocationsRecommendersRecommendationsMarkFailedCall) Fields

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

func (*BillingAccountsLocationsRecommendersRecommendationsMarkFailedCall) Header

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

type BillingAccountsLocationsRecommendersRecommendationsMarkSucceededCall

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

func (*BillingAccountsLocationsRecommendersRecommendationsMarkSucceededCall) Context

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 (*BillingAccountsLocationsRecommendersRecommendationsMarkSucceededCall) Do

Do executes the "recommender.billingAccounts.locations.recommenders.recommendations.markSucceeded" call. Exactly one of *GoogleCloudRecommenderV1Recommendation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *GoogleCloudRecommenderV1Recommendation.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 (*BillingAccountsLocationsRecommendersRecommendationsMarkSucceededCall) Fields

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

func (*BillingAccountsLocationsRecommendersRecommendationsMarkSucceededCall) Header

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

type BillingAccountsLocationsRecommendersRecommendationsService

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

func (*BillingAccountsLocationsRecommendersRecommendationsService) Get

Get: Gets the requested recommendation. Requires the recommender.*.get IAM permission for the specified recommender.

- name: Name of the recommendation.

func (*BillingAccountsLocationsRecommendersRecommendationsService) List

List: Lists recommendations for the specified Cloud Resource. Requires the recommender.*.list IAM permission for the specified recommender.

  • parent: The container resource on which to execute the request. Acceptable formats: 1. `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMM ENDER_ID]` 2. `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/recommend ers/[RECOMMENDER_ID]` 3. `folders/[FOLDER_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ ID]` 4. `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[ RECOMMENDER_ID]` LOCATION here refers to GCP Locations: https://cloud.google.com/about/locations/ RECOMMENDER_ID refers to supported recommenders: https://cloud.google.com/recommender/docs/recommenders.

func (*BillingAccountsLocationsRecommendersRecommendationsService) MarkClaimed

MarkClaimed: Marks the Recommendation State as Claimed. Users can use this method to indicate to the Recommender API that they are starting to apply the recommendation themselves. This stops the recommendation content from being updated. Associated insights are frozen and placed in the ACCEPTED state. MarkRecommendationClaimed can be applied to recommendations in CLAIMED, SUCCEEDED, FAILED, or ACTIVE state. Requires the recommender.*.update IAM permission for the specified recommender.

- name: Name of the recommendation.

func (*BillingAccountsLocationsRecommendersRecommendationsService) MarkFailed

MarkFailed: Marks the Recommendation State as Failed. Users can use this method to indicate to the Recommender API that they have applied the recommendation themselves, and the operation failed. This stops the recommendation content from being updated. Associated insights are frozen and placed in the ACCEPTED state. MarkRecommendationFailed can be applied to recommendations in ACTIVE, CLAIMED, SUCCEEDED, or FAILED state. Requires the recommender.*.update IAM permission for the specified recommender.

- name: Name of the recommendation.

func (*BillingAccountsLocationsRecommendersRecommendationsService) MarkSucceeded

MarkSucceeded: Marks the Recommendation State as Succeeded. Users can use this method to indicate to the Recommender API that they have applied the recommendation themselves, and the operation was successful. This stops the recommendation content from being updated. Associated insights are frozen and placed in the ACCEPTED state. MarkRecommendationSucceeded can be applied to recommendations in ACTIVE, CLAIMED, SUCCEEDED, or FAILED state. Requires the recommender.*.update IAM permission for the specified recommender.

- name: Name of the recommendation.

type BillingAccountsLocationsRecommendersService

type BillingAccountsLocationsRecommendersService struct {
	Recommendations *BillingAccountsLocationsRecommendersRecommendationsService
	// contains filtered or unexported fields
}

func NewBillingAccountsLocationsRecommendersService

func NewBillingAccountsLocationsRecommendersService(s *Service) *BillingAccountsLocationsRecommendersService

type BillingAccountsLocationsService

type BillingAccountsLocationsService struct {
	InsightTypes *BillingAccountsLocationsInsightTypesService

	Recommenders *BillingAccountsLocationsRecommendersService
	// contains filtered or unexported fields
}

func NewBillingAccountsLocationsService

func NewBillingAccountsLocationsService(s *Service) *BillingAccountsLocationsService

type BillingAccountsService

type BillingAccountsService struct {
	Locations *BillingAccountsLocationsService
	// contains filtered or unexported fields
}

func NewBillingAccountsService

func NewBillingAccountsService(s *Service) *BillingAccountsService

type FoldersLocationsInsightTypesInsightsGetCall

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

func (*FoldersLocationsInsightTypesInsightsGetCall) Context

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 (*FoldersLocationsInsightTypesInsightsGetCall) Do

Do executes the "recommender.folders.locations.insightTypes.insights.get" call. Exactly one of *GoogleCloudRecommenderV1Insight or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *GoogleCloudRecommenderV1Insight.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 (*FoldersLocationsInsightTypesInsightsGetCall) Fields

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

func (*FoldersLocationsInsightTypesInsightsGetCall) Header

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

func (*FoldersLocationsInsightTypesInsightsGetCall) IfNoneMatch

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 FoldersLocationsInsightTypesInsightsListCall

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

func (*FoldersLocationsInsightTypesInsightsListCall) Context

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 (*FoldersLocationsInsightTypesInsightsListCall) Do

Do executes the "recommender.folders.locations.insightTypes.insights.list" call. Exactly one of *GoogleCloudRecommenderV1ListInsightsResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *GoogleCloudRecommenderV1ListInsightsResponse.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 (*FoldersLocationsInsightTypesInsightsListCall) Fields

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

func (*FoldersLocationsInsightTypesInsightsListCall) Filter

Filter sets the optional parameter "filter": Filter expression to restrict the insights returned. Supported filter fields: * `stateInfo.state` * `insightSubtype` * `severity` Examples: * `stateInfo.state = ACTIVE OR stateInfo.state = DISMISSED` * `insightSubtype = PERMISSIONS_USAGE` * `severity = CRITICAL OR severity = HIGH` * `stateInfo.state = ACTIVE AND (severity = CRITICAL OR severity = HIGH)` (These expressions are based on the filter language described at https://google.aip.dev/160)

func (*FoldersLocationsInsightTypesInsightsListCall) Header

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

func (*FoldersLocationsInsightTypesInsightsListCall) IfNoneMatch

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 (*FoldersLocationsInsightTypesInsightsListCall) PageSize

PageSize sets the optional parameter "pageSize": The maximum number of results to return from this request. Non-positive values are ignored. If not specified, the server will determine the number of results to return.

func (*FoldersLocationsInsightTypesInsightsListCall) PageToken

PageToken sets the optional parameter "pageToken": If present, retrieves the next batch of results from the preceding call to this method. `page_token` must be the value of `next_page_token` from the previous response. The values of other method parameters must be identical to those in the previous call.

func (*FoldersLocationsInsightTypesInsightsListCall) Pages

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 FoldersLocationsInsightTypesInsightsMarkAcceptedCall

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

func (*FoldersLocationsInsightTypesInsightsMarkAcceptedCall) Context

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 (*FoldersLocationsInsightTypesInsightsMarkAcceptedCall) Do

Do executes the "recommender.folders.locations.insightTypes.insights.markAccepted" call. Exactly one of *GoogleCloudRecommenderV1Insight or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *GoogleCloudRecommenderV1Insight.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 (*FoldersLocationsInsightTypesInsightsMarkAcceptedCall) Fields

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

func (*FoldersLocationsInsightTypesInsightsMarkAcceptedCall) Header

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

type FoldersLocationsInsightTypesInsightsService

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

func NewFoldersLocationsInsightTypesInsightsService

func NewFoldersLocationsInsightTypesInsightsService(s *Service) *FoldersLocationsInsightTypesInsightsService

func (*FoldersLocationsInsightTypesInsightsService) Get

Get: Gets the requested insight. Requires the recommender.*.get IAM permission for the specified insight type.

- name: Name of the insight.

func (*FoldersLocationsInsightTypesInsightsService) List

List: Lists insights for the specified Cloud Resource. Requires the recommender.*.list IAM permission for the specified insight type.

  • parent: The container resource on which to execute the request. Acceptable formats: 1. `projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGH T_TYPE_ID]` 2. `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/insightTy pes/[INSIGHT_TYPE_ID]` 3. `folders/[FOLDER_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE _ID]` 4. `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/insightTypes/[ INSIGHT_TYPE_ID]` LOCATION here refers to GCP Locations: https://cloud.google.com/about/locations/ INSIGHT_TYPE_ID refers to supported insight types: https://cloud.google.com/recommender/docs/insights/insight-types.

func (*FoldersLocationsInsightTypesInsightsService) MarkAccepted

MarkAccepted: Marks the Insight State as Accepted. Users can use this method to indicate to the Recommender API that they have applied some action based on the insight. This stops the insight content from being updated. MarkInsightAccepted can be applied to insights in ACTIVE state. Requires the recommender.*.update IAM permission for the specified insight.

- name: Name of the insight.

type FoldersLocationsInsightTypesService

type FoldersLocationsInsightTypesService struct {
	Insights *FoldersLocationsInsightTypesInsightsService
	// contains filtered or unexported fields
}

func NewFoldersLocationsInsightTypesService

func NewFoldersLocationsInsightTypesService(s *Service) *FoldersLocationsInsightTypesService

type FoldersLocationsRecommendersRecommendationsGetCall

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

func (*FoldersLocationsRecommendersRecommendationsGetCall) Context

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 (*FoldersLocationsRecommendersRecommendationsGetCall) Do

Do executes the "recommender.folders.locations.recommenders.recommendations.get" call. Exactly one of *GoogleCloudRecommenderV1Recommendation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *GoogleCloudRecommenderV1Recommendation.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 (*FoldersLocationsRecommendersRecommendationsGetCall) Fields

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

func (*FoldersLocationsRecommendersRecommendationsGetCall) Header

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

func (*FoldersLocationsRecommendersRecommendationsGetCall) IfNoneMatch

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 FoldersLocationsRecommendersRecommendationsListCall

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

func (*FoldersLocationsRecommendersRecommendationsListCall) Context

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 (*FoldersLocationsRecommendersRecommendationsListCall) Do

Do executes the "recommender.folders.locations.recommenders.recommendations.list" call. Exactly one of *GoogleCloudRecommenderV1ListRecommendationsResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *GoogleCloudRecommenderV1ListRecommendationsResponse.ServerResponse.He ader 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 (*FoldersLocationsRecommendersRecommendationsListCall) Fields

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

func (*FoldersLocationsRecommendersRecommendationsListCall) Filter

Filter sets the optional parameter "filter": Filter expression to restrict the recommendations returned. Supported filter fields: * `state_info.state` * `recommenderSubtype` * `priority` Examples: * `stateInfo.state = ACTIVE OR stateInfo.state = DISMISSED` * `recommenderSubtype = REMOVE_ROLE OR recommenderSubtype = REPLACE_ROLE` * `priority = P1 OR priority = P2` * `stateInfo.state = ACTIVE AND (priority = P1 OR priority = P2)` (These expressions are based on the filter language described at https://google.aip.dev/160)

func (*FoldersLocationsRecommendersRecommendationsListCall) Header

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

func (*FoldersLocationsRecommendersRecommendationsListCall) IfNoneMatch

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 (*FoldersLocationsRecommendersRecommendationsListCall) PageSize

PageSize sets the optional parameter "pageSize": The maximum number of results to return from this request. Non-positive values are ignored. If not specified, the server will determine the number of results to return.

func (*FoldersLocationsRecommendersRecommendationsListCall) PageToken

PageToken sets the optional parameter "pageToken": If present, retrieves the next batch of results from the preceding call to this method. `page_token` must be the value of `next_page_token` from the previous response. The values of other method parameters must be identical to those in the previous call.

func (*FoldersLocationsRecommendersRecommendationsListCall) Pages

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 FoldersLocationsRecommendersRecommendationsMarkClaimedCall

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

func (*FoldersLocationsRecommendersRecommendationsMarkClaimedCall) Context

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 (*FoldersLocationsRecommendersRecommendationsMarkClaimedCall) Do

Do executes the "recommender.folders.locations.recommenders.recommendations.markClaimed" call. Exactly one of *GoogleCloudRecommenderV1Recommendation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *GoogleCloudRecommenderV1Recommendation.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 (*FoldersLocationsRecommendersRecommendationsMarkClaimedCall) Fields

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

func (*FoldersLocationsRecommendersRecommendationsMarkClaimedCall) Header

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

type FoldersLocationsRecommendersRecommendationsMarkFailedCall

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

func (*FoldersLocationsRecommendersRecommendationsMarkFailedCall) Context

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 (*FoldersLocationsRecommendersRecommendationsMarkFailedCall) Do

Do executes the "recommender.folders.locations.recommenders.recommendations.markFailed" call. Exactly one of *GoogleCloudRecommenderV1Recommendation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *GoogleCloudRecommenderV1Recommendation.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 (*FoldersLocationsRecommendersRecommendationsMarkFailedCall) Fields

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

func (*FoldersLocationsRecommendersRecommendationsMarkFailedCall) Header

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

type FoldersLocationsRecommendersRecommendationsMarkSucceededCall

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

func (*FoldersLocationsRecommendersRecommendationsMarkSucceededCall) Context

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 (*FoldersLocationsRecommendersRecommendationsMarkSucceededCall) Do

Do executes the "recommender.folders.locations.recommenders.recommendations.markSucceeded" call. Exactly one of *GoogleCloudRecommenderV1Recommendation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *GoogleCloudRecommenderV1Recommendation.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 (*FoldersLocationsRecommendersRecommendationsMarkSucceededCall) Fields

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

func (*FoldersLocationsRecommendersRecommendationsMarkSucceededCall) Header

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

type FoldersLocationsRecommendersRecommendationsService

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

func (*FoldersLocationsRecommendersRecommendationsService) Get

Get: Gets the requested recommendation. Requires the recommender.*.get IAM permission for the specified recommender.

- name: Name of the recommendation.

func (*FoldersLocationsRecommendersRecommendationsService) List

List: Lists recommendations for the specified Cloud Resource. Requires the recommender.*.list IAM permission for the specified recommender.

  • parent: The container resource on which to execute the request. Acceptable formats: 1. `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMM ENDER_ID]` 2. `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/recommend ers/[RECOMMENDER_ID]` 3. `folders/[FOLDER_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ ID]` 4. `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[ RECOMMENDER_ID]` LOCATION here refers to GCP Locations: https://cloud.google.com/about/locations/ RECOMMENDER_ID refers to supported recommenders: https://cloud.google.com/recommender/docs/recommenders.

func (*FoldersLocationsRecommendersRecommendationsService) MarkClaimed

MarkClaimed: Marks the Recommendation State as Claimed. Users can use this method to indicate to the Recommender API that they are starting to apply the recommendation themselves. This stops the recommendation content from being updated. Associated insights are frozen and placed in the ACCEPTED state. MarkRecommendationClaimed can be applied to recommendations in CLAIMED, SUCCEEDED, FAILED, or ACTIVE state. Requires the recommender.*.update IAM permission for the specified recommender.

- name: Name of the recommendation.

func (*FoldersLocationsRecommendersRecommendationsService) MarkFailed

MarkFailed: Marks the Recommendation State as Failed. Users can use this method to indicate to the Recommender API that they have applied the recommendation themselves, and the operation failed. This stops the recommendation content from being updated. Associated insights are frozen and placed in the ACCEPTED state. MarkRecommendationFailed can be applied to recommendations in ACTIVE, CLAIMED, SUCCEEDED, or FAILED state. Requires the recommender.*.update IAM permission for the specified recommender.

- name: Name of the recommendation.

func (*FoldersLocationsRecommendersRecommendationsService) MarkSucceeded

MarkSucceeded: Marks the Recommendation State as Succeeded. Users can use this method to indicate to the Recommender API that they have applied the recommendation themselves, and the operation was successful. This stops the recommendation content from being updated. Associated insights are frozen and placed in the ACCEPTED state. MarkRecommendationSucceeded can be applied to recommendations in ACTIVE, CLAIMED, SUCCEEDED, or FAILED state. Requires the recommender.*.update IAM permission for the specified recommender.

- name: Name of the recommendation.

type FoldersLocationsRecommendersService

type FoldersLocationsRecommendersService struct {
	Recommendations *FoldersLocationsRecommendersRecommendationsService
	// contains filtered or unexported fields
}

func NewFoldersLocationsRecommendersService

func NewFoldersLocationsRecommendersService(s *Service) *FoldersLocationsRecommendersService

type FoldersLocationsService

type FoldersLocationsService struct {
	InsightTypes *FoldersLocationsInsightTypesService

	Recommenders *FoldersLocationsRecommendersService
	// contains filtered or unexported fields
}

func NewFoldersLocationsService

func NewFoldersLocationsService(s *Service) *FoldersLocationsService

type FoldersService

type FoldersService struct {
	Locations *FoldersLocationsService
	// contains filtered or unexported fields
}

func NewFoldersService

func NewFoldersService(s *Service) *FoldersService

type GoogleCloudRecommenderV1CostProjection

type GoogleCloudRecommenderV1CostProjection struct {
	// Cost: An approximate projection on amount saved or amount incurred.
	// Negative cost units indicate cost savings and positive cost units
	// indicate increase. See google.type.Money documentation for
	// positive/negative units.
	Cost *GoogleTypeMoney `json:"cost,omitempty"`

	// Duration: Duration for which this cost applies.
	Duration string `json:"duration,omitempty"`

	// ForceSendFields is a list of field names (e.g. "Cost") 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. "Cost") 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:"-"`
}

GoogleCloudRecommenderV1CostProjection: Contains metadata about how much money a recommendation can save or incur.

func (*GoogleCloudRecommenderV1CostProjection) MarshalJSON

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

type GoogleCloudRecommenderV1Impact

type GoogleCloudRecommenderV1Impact struct {
	// Category: Category that is being targeted.
	//
	// Possible values:
	//   "CATEGORY_UNSPECIFIED" - Default unspecified category. Don't use
	// directly.
	//   "COST" - Indicates a potential increase or decrease in cost.
	//   "SECURITY" - Indicates a potential increase or decrease in
	// security.
	//   "PERFORMANCE" - Indicates a potential increase or decrease in
	// performance.
	//   "MANAGEABILITY" - Indicates a potential increase or decrease in
	// manageability.
	Category string `json:"category,omitempty"`

	// CostProjection: Use with CategoryType.COST
	CostProjection *GoogleCloudRecommenderV1CostProjection `json:"costProjection,omitempty"`

	// SecurityProjection: Use with CategoryType.SECURITY
	SecurityProjection *GoogleCloudRecommenderV1SecurityProjection `json:"securityProjection,omitempty"`

	// ForceSendFields is a list of field names (e.g. "Category") 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. "Category") 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:"-"`
}

GoogleCloudRecommenderV1Impact: Contains the impact a recommendation can have for a given category.

func (*GoogleCloudRecommenderV1Impact) MarshalJSON

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

type GoogleCloudRecommenderV1Insight

type GoogleCloudRecommenderV1Insight struct {
	// AssociatedRecommendations: Recommendations derived from this insight.
	AssociatedRecommendations []*GoogleCloudRecommenderV1InsightRecommendationReference `json:"associatedRecommendations,omitempty"`

	// Category: Category being targeted by the insight.
	//
	// Possible values:
	//   "CATEGORY_UNSPECIFIED" - Unspecified category.
	//   "COST" - The insight is related to cost.
	//   "SECURITY" - The insight is related to security.
	//   "PERFORMANCE" - The insight is related to performance.
	//   "MANAGEABILITY" - This insight is related to manageability.
	Category string `json:"category,omitempty"`

	// Content: A struct of custom fields to explain the insight. Example:
	// "grantedPermissionsCount": "1000"
	Content googleapi.RawMessage `json:"content,omitempty"`

	// Description: Free-form human readable summary in English. The maximum
	// length is 500 characters.
	Description string `json:"description,omitempty"`

	// Etag: Fingerprint of the Insight. Provides optimistic locking when
	// updating states.
	Etag string `json:"etag,omitempty"`

	// InsightSubtype: Insight subtype. Insight content schema will be
	// stable for a given subtype.
	InsightSubtype string `json:"insightSubtype,omitempty"`

	// LastRefreshTime: Timestamp of the latest data used to generate the
	// insight.
	LastRefreshTime string `json:"lastRefreshTime,omitempty"`

	// Name: Name of the insight.
	Name string `json:"name,omitempty"`

	// ObservationPeriod: Observation period that led to the insight. The
	// source data used to generate the insight ends at last_refresh_time
	// and begins at (last_refresh_time - observation_period).
	ObservationPeriod string `json:"observationPeriod,omitempty"`

	// Severity: Insight's severity.
	//
	// Possible values:
	//   "SEVERITY_UNSPECIFIED" - Insight has unspecified severity.
	//   "LOW" - Insight has low severity.
	//   "MEDIUM" - Insight has medium severity.
	//   "HIGH" - Insight has high severity.
	//   "CRITICAL" - Insight has critical severity.
	Severity string `json:"severity,omitempty"`

	// StateInfo: Information state and metadata.
	StateInfo *GoogleCloudRecommenderV1InsightStateInfo `json:"stateInfo,omitempty"`

	// TargetResources: Fully qualified resource names that this insight is
	// targeting.
	TargetResources []string `json:"targetResources,omitempty"`

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

	// ForceSendFields is a list of field names (e.g.
	// "AssociatedRecommendations") 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.
	// "AssociatedRecommendations") 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:"-"`
}

GoogleCloudRecommenderV1Insight: An insight along with the information used to derive the insight. The insight may have associated recomendations as well.

func (*GoogleCloudRecommenderV1Insight) MarshalJSON

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

type GoogleCloudRecommenderV1InsightRecommendationReference

type GoogleCloudRecommenderV1InsightRecommendationReference struct {
	// Recommendation: Recommendation resource name, e.g.
	// projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMEND
	// ER_ID]/recommendations/[RECOMMENDATION_ID]
	Recommendation string `json:"recommendation,omitempty"`

	// ForceSendFields is a list of field names (e.g. "Recommendation") 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. "Recommendation") 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:"-"`
}

GoogleCloudRecommenderV1InsightRecommendationReference: Reference to an associated recommendation.

func (*GoogleCloudRecommenderV1InsightRecommendationReference) MarshalJSON

type GoogleCloudRecommenderV1InsightStateInfo

type GoogleCloudRecommenderV1InsightStateInfo struct {
	// State: Insight state.
	//
	// Possible values:
	//   "STATE_UNSPECIFIED" - Unspecified state.
	//   "ACTIVE" - Insight is active. Content for ACTIVE insights can be
	// updated by Google. ACTIVE insights can be marked DISMISSED OR
	// ACCEPTED.
	//   "ACCEPTED" - Some action has been taken based on this insight.
	// Insights become accepted when a recommendation derived from the
	// insight has been marked CLAIMED, SUCCEEDED, or FAILED. ACTIVE
	// insights can also be marked ACCEPTED explicitly. Content for ACCEPTED
	// insights is immutable. ACCEPTED insights can only be marked ACCEPTED
	// (which may update state metadata).
	//   "DISMISSED" - Insight is dismissed. Content for DISMISSED insights
	// can be updated by Google. DISMISSED insights can be marked as ACTIVE.
	State string `json:"state,omitempty"`

	// StateMetadata: A map of metadata for the state, provided by user or
	// automations systems.
	StateMetadata map[string]string `json:"stateMetadata,omitempty"`

	// ForceSendFields is a list of field names (e.g. "State") 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. "State") 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:"-"`
}

GoogleCloudRecommenderV1InsightStateInfo: Information related to insight state.

func (*GoogleCloudRecommenderV1InsightStateInfo) MarshalJSON

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

type GoogleCloudRecommenderV1ListInsightsResponse

type GoogleCloudRecommenderV1ListInsightsResponse struct {
	// Insights: The set of insights for the `parent` resource.
	Insights []*GoogleCloudRecommenderV1Insight `json:"insights,omitempty"`

	// NextPageToken: A token that can be used to request the next page of
	// results. This field is empty if there are no additional results.
	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. "Insights") 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. "Insights") 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:"-"`
}

GoogleCloudRecommenderV1ListInsightsResponse: Response to the `ListInsights` method.

func (*GoogleCloudRecommenderV1ListInsightsResponse) MarshalJSON

type GoogleCloudRecommenderV1ListRecommendationsResponse

type GoogleCloudRecommenderV1ListRecommendationsResponse struct {
	// NextPageToken: A token that can be used to request the next page of
	// results. This field is empty if there are no additional results.
	NextPageToken string `json:"nextPageToken,omitempty"`

	// Recommendations: The set of recommendations for the `parent`
	// resource.
	Recommendations []*GoogleCloudRecommenderV1Recommendation `json:"recommendations,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:"-"`
}

GoogleCloudRecommenderV1ListRecommendationsResponse: Response to the `ListRecommendations` method.

func (*GoogleCloudRecommenderV1ListRecommendationsResponse) MarshalJSON

type GoogleCloudRecommenderV1MarkInsightAcceptedRequest

type GoogleCloudRecommenderV1MarkInsightAcceptedRequest struct {
	// Etag: Required. Fingerprint of the Insight. Provides optimistic
	// locking.
	Etag string `json:"etag,omitempty"`

	// StateMetadata: Optional. State properties user wish to include with
	// this state. Full replace of the current state_metadata.
	StateMetadata map[string]string `json:"stateMetadata,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:"-"`
}

GoogleCloudRecommenderV1MarkInsightAcceptedRequest: Request for the `MarkInsightAccepted` method.

func (*GoogleCloudRecommenderV1MarkInsightAcceptedRequest) MarshalJSON

type GoogleCloudRecommenderV1MarkRecommendationClaimedRequest

type GoogleCloudRecommenderV1MarkRecommendationClaimedRequest struct {
	// Etag: Required. Fingerprint of the Recommendation. Provides
	// optimistic locking.
	Etag string `json:"etag,omitempty"`

	// StateMetadata: State properties to include with this state.
	// Overwrites any existing `state_metadata`. Keys must match the regex
	// /^a-z0-9{0,62}$/. Values must match the regex
	// /^[a-zA-Z0-9_./-]{0,255}$/.
	StateMetadata map[string]string `json:"stateMetadata,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:"-"`
}

GoogleCloudRecommenderV1MarkRecommendationClaimedRequest: Request for the `MarkRecommendationClaimed` Method.

func (*GoogleCloudRecommenderV1MarkRecommendationClaimedRequest) MarshalJSON

type GoogleCloudRecommenderV1MarkRecommendationFailedRequest

type GoogleCloudRecommenderV1MarkRecommendationFailedRequest struct {
	// Etag: Required. Fingerprint of the Recommendation. Provides
	// optimistic locking.
	Etag string `json:"etag,omitempty"`

	// StateMetadata: State properties to include with this state.
	// Overwrites any existing `state_metadata`. Keys must match the regex
	// /^a-z0-9{0,62}$/. Values must match the regex
	// /^[a-zA-Z0-9_./-]{0,255}$/.
	StateMetadata map[string]string `json:"stateMetadata,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:"-"`
}

GoogleCloudRecommenderV1MarkRecommendationFailedRequest: Request for the `MarkRecommendationFailed` Method.

func (*GoogleCloudRecommenderV1MarkRecommendationFailedRequest) MarshalJSON

type GoogleCloudRecommenderV1MarkRecommendationSucceededRequest

type GoogleCloudRecommenderV1MarkRecommendationSucceededRequest struct {
	// Etag: Required. Fingerprint of the Recommendation. Provides
	// optimistic locking.
	Etag string `json:"etag,omitempty"`

	// StateMetadata: State properties to include with this state.
	// Overwrites any existing `state_metadata`. Keys must match the regex
	// /^a-z0-9{0,62}$/. Values must match the regex
	// /^[a-zA-Z0-9_./-]{0,255}$/.
	StateMetadata map[string]string `json:"stateMetadata,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:"-"`
}

GoogleCloudRecommenderV1MarkRecommendationSucceededRequest: Request for the `MarkRecommendationSucceeded` Method.

func (*GoogleCloudRecommenderV1MarkRecommendationSucceededRequest) MarshalJSON

type GoogleCloudRecommenderV1Operation

type GoogleCloudRecommenderV1Operation struct {
	// Action: Type of this operation. Contains one of 'add', 'remove',
	// 'replace', 'move', 'copy', 'test' and custom operations. This field
	// is case-insensitive and always populated.
	Action string `json:"action,omitempty"`

	// Path: Path to the target field being operated on. If the operation is
	// at the resource level, then path should be "/". This field is always
	// populated.
	Path string `json:"path,omitempty"`

	// PathFilters: Set of filters to apply if `path` refers to array
	// elements or nested array elements in order to narrow down to a single
	// unique element that is being tested/modified. This is intended to be
	// an exact match per filter. To perform advanced matching, use
	// path_value_matchers. * Example: { "/versions/*/name" : "it-123"
	// "/versions/*/targetSize/percent": 20 } * Example: {
	// "/bindings/*/role": "roles/owner" "/bindings/*/condition" : null } *
	// Example: { "/bindings/*/role": "roles/owner" "/bindings/*/members/*"
	// : ["x@example.com", "y@example.com"] } When both path_filters and
	// path_value_matchers are set, an implicit AND must be performed.
	PathFilters googleapi.RawMessage `json:"pathFilters,omitempty"`

	// PathValueMatchers: Similar to path_filters, this contains set of
	// filters to apply if `path` field refers to array elements. This is
	// meant to support value matching beyond exact match. To perform exact
	// match, use path_filters. When both path_filters and
	// path_value_matchers are set, an implicit AND must be performed.
	PathValueMatchers map[string]GoogleCloudRecommenderV1ValueMatcher `json:"pathValueMatchers,omitempty"`

	// Resource: Contains the fully qualified resource name. This field is
	// always populated. ex:
	// //cloudresourcemanager.googleapis.com/projects/foo.
	Resource string `json:"resource,omitempty"`

	// ResourceType: Type of GCP resource being modified/tested. This field
	// is always populated. Example:
	// cloudresourcemanager.googleapis.com/Project,
	// compute.googleapis.com/Instance
	ResourceType string `json:"resourceType,omitempty"`

	// SourcePath: Can be set with action 'copy' or 'move' to indicate the
	// source field within resource or source_resource, ignored if provided
	// for other operation types.
	SourcePath string `json:"sourcePath,omitempty"`

	// SourceResource: Can be set with action 'copy' to copy resource
	// configuration across different resources of the same type. Example: A
	// resource clone can be done via action = 'copy', path = "/", from =
	// "/", source_resource = and resource_name = . This field is empty for
	// all other values of `action`.
	SourceResource string `json:"sourceResource,omitempty"`

	// Value: Value for the `path` field. Will be set for
	// actions:'add'/'replace'. Maybe set for action: 'test'. Either this or
	// `value_matcher` will be set for 'test' operation. An exact match must
	// be performed.
	Value interface{} `json:"value,omitempty"`

	// ValueMatcher: Can be set for action 'test' for advanced matching for
	// the value of 'path' field. Either this or `value` will be set for
	// 'test' operation.
	ValueMatcher *GoogleCloudRecommenderV1ValueMatcher `json:"valueMatcher,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:"-"`
}

GoogleCloudRecommenderV1Operation: Contains an operation for a resource loosely based on the JSON-PATCH format with support for: * Custom filters for describing partial array patch. * Extended path values for describing nested arrays. * Custom fields for describing the resource for which the operation is being described. * Allows extension to custom operations not natively supported by RFC6902. See https://tools.ietf.org/html/rfc6902 for details on the original RFC.

func (*GoogleCloudRecommenderV1Operation) MarshalJSON

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

type GoogleCloudRecommenderV1OperationGroup

type GoogleCloudRecommenderV1OperationGroup struct {
	// Operations: List of operations across one or more resources that
	// belong to this group. Loosely based on RFC6902 and should be
	// performed in the order they appear.
	Operations []*GoogleCloudRecommenderV1Operation `json:"operations,omitempty"`

	// ForceSendFields is a list of field names (e.g. "Operations") 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. "Operations") 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:"-"`
}

GoogleCloudRecommenderV1OperationGroup: Group of operations that need to be performed atomically.

func (*GoogleCloudRecommenderV1OperationGroup) MarshalJSON

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

type GoogleCloudRecommenderV1Recommendation

type GoogleCloudRecommenderV1Recommendation struct {
	// AdditionalImpact: Optional set of additional impact that this
	// recommendation may have when trying to optimize for the primary
	// category. These may be positive or negative.
	AdditionalImpact []*GoogleCloudRecommenderV1Impact `json:"additionalImpact,omitempty"`

	// AssociatedInsights: Insights that led to this recommendation.
	AssociatedInsights []*GoogleCloudRecommenderV1RecommendationInsightReference `json:"associatedInsights,omitempty"`

	// Content: Content of the recommendation describing recommended changes
	// to resources.
	Content *GoogleCloudRecommenderV1RecommendationContent `json:"content,omitempty"`

	// Description: Free-form human readable summary in English. The maximum
	// length is 500 characters.
	Description string `json:"description,omitempty"`

	// Etag: Fingerprint of the Recommendation. Provides optimistic locking
	// when updating states.
	Etag string `json:"etag,omitempty"`

	// LastRefreshTime: Last time this recommendation was refreshed by the
	// system that created it in the first place.
	LastRefreshTime string `json:"lastRefreshTime,omitempty"`

	// Name: Name of recommendation.
	Name string `json:"name,omitempty"`

	// PrimaryImpact: The primary impact that this recommendation can have
	// while trying to optimize for one category.
	PrimaryImpact *GoogleCloudRecommenderV1Impact `json:"primaryImpact,omitempty"`

	// Priority: Recommendation's priority.
	//
	// Possible values:
	//   "PRIORITY_UNSPECIFIED" - Recommendation has unspecified priority.
	//   "P4" - Recommendation has P4 priority (lowest priority).
	//   "P3" - Recommendation has P3 priority (second lowest priority).
	//   "P2" - Recommendation has P2 priority (second highest priority).
	//   "P1" - Recommendation has P1 priority (highest priority).
	Priority string `json:"priority,omitempty"`

	// RecommenderSubtype: Contains an identifier for a subtype of
	// recommendations produced for the same recommender. Subtype is a
	// function of content and impact, meaning a new subtype might be added
	// when significant changes to `content` or `primary_impact.category`
	// are introduced. See the Recommenders section to see a list of
	// subtypes for a given Recommender. Examples: For recommender =
	// "google.iam.policy.Recommender", recommender_subtype can be one of
	// "REMOVE_ROLE"/"REPLACE_ROLE"
	RecommenderSubtype string `json:"recommenderSubtype,omitempty"`

	// StateInfo: Information for state. Contains state and metadata.
	StateInfo *GoogleCloudRecommenderV1RecommendationStateInfo `json:"stateInfo,omitempty"`

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

	// ForceSendFields is a list of field names (e.g. "AdditionalImpact") 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. "AdditionalImpact") 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:"-"`
}

GoogleCloudRecommenderV1Recommendation: A recommendation along with a suggested action. E.g., a rightsizing recommendation for an underutilized VM, IAM role recommendations, etc

func (*GoogleCloudRecommenderV1Recommendation) MarshalJSON

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

type GoogleCloudRecommenderV1RecommendationContent

type GoogleCloudRecommenderV1RecommendationContent struct {
	// OperationGroups: Operations to one or more Google Cloud resources
	// grouped in such a way that, all operations within one group are
	// expected to be performed atomically and in an order.
	OperationGroups []*GoogleCloudRecommenderV1OperationGroup `json:"operationGroups,omitempty"`

	// ForceSendFields is a list of field names (e.g. "OperationGroups") 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. "OperationGroups") 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:"-"`
}

GoogleCloudRecommenderV1RecommendationContent: Contains what resources are changing and how they are changing.

func (*GoogleCloudRecommenderV1RecommendationContent) MarshalJSON

type GoogleCloudRecommenderV1RecommendationInsightReference

type GoogleCloudRecommenderV1RecommendationInsightReference struct {
	// Insight: Insight resource name, e.g.
	// projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_T
	// YPE_ID]/insights/[INSIGHT_ID]
	Insight string `json:"insight,omitempty"`

	// ForceSendFields is a list of field names (e.g. "Insight") 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. "Insight") 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:"-"`
}

GoogleCloudRecommenderV1RecommendationInsightReference: Reference to an associated insight.

func (*GoogleCloudRecommenderV1RecommendationInsightReference) MarshalJSON

type GoogleCloudRecommenderV1RecommendationStateInfo

type GoogleCloudRecommenderV1RecommendationStateInfo struct {
	// State: The state of the recommendation, Eg ACTIVE, SUCCEEDED, FAILED.
	//
	// Possible values:
	//   "STATE_UNSPECIFIED" - Default state. Don't use directly.
	//   "ACTIVE" - Recommendation is active and can be applied.
	// Recommendations content can be updated by Google. ACTIVE
	// recommendations can be marked as CLAIMED, SUCCEEDED, or FAILED.
	//   "CLAIMED" - Recommendation is in claimed state. Recommendations
	// content is immutable and cannot be updated by Google. CLAIMED
	// recommendations can be marked as CLAIMED, SUCCEEDED, or FAILED.
	//   "SUCCEEDED" - Recommendation is in succeeded state. Recommendations
	// content is immutable and cannot be updated by Google. SUCCEEDED
	// recommendations can be marked as SUCCEEDED, or FAILED.
	//   "FAILED" - Recommendation is in failed state. Recommendations
	// content is immutable and cannot be updated by Google. FAILED
	// recommendations can be marked as SUCCEEDED, or FAILED.
	//   "DISMISSED" - Recommendation is in dismissed state. Recommendation
	// content can be updated by Google. DISMISSED recommendations can be
	// marked as ACTIVE.
	State string `json:"state,omitempty"`

	// StateMetadata: A map of metadata for the state, provided by user or
	// automations systems.
	StateMetadata map[string]string `json:"stateMetadata,omitempty"`

	// ForceSendFields is a list of field names (e.g. "State") 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. "State") 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:"-"`
}

GoogleCloudRecommenderV1RecommendationStateInfo: Information for state. Contains state and metadata.

func (*GoogleCloudRecommenderV1RecommendationStateInfo) MarshalJSON

type GoogleCloudRecommenderV1SecurityProjection

type GoogleCloudRecommenderV1SecurityProjection struct {
	// Details: Additional security impact details that is provided by the
	// recommender.
	Details googleapi.RawMessage `json:"details,omitempty"`

	// ForceSendFields is a list of field names (e.g. "Details") 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. "Details") 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:"-"`
}

GoogleCloudRecommenderV1SecurityProjection: Contains various ways of describing the impact on Security.

func (*GoogleCloudRecommenderV1SecurityProjection) MarshalJSON

type GoogleCloudRecommenderV1ValueMatcher

type GoogleCloudRecommenderV1ValueMatcher struct {
	// MatchesPattern: To be used for full regex matching. The regular
	// expression is using the Google RE2 syntax
	// (https://github.com/google/re2/wiki/Syntax), so to be used with
	// RE2::FullMatch
	MatchesPattern string `json:"matchesPattern,omitempty"`

	// ForceSendFields is a list of field names (e.g. "MatchesPattern") 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. "MatchesPattern") 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:"-"`
}

GoogleCloudRecommenderV1ValueMatcher: Contains various matching options for values for a GCP resource field.

func (*GoogleCloudRecommenderV1ValueMatcher) MarshalJSON

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

type GoogleTypeMoney

type GoogleTypeMoney struct {
	// CurrencyCode: The three-letter currency code defined in ISO 4217.
	CurrencyCode string `json:"currencyCode,omitempty"`

	// Nanos: Number of nano (10^-9) units of the amount. The value must be
	// between -999,999,999 and +999,999,999 inclusive. If `units` is
	// positive, `nanos` must be positive or zero. If `units` is zero,
	// `nanos` can be positive, zero, or negative. If `units` is negative,
	// `nanos` must be negative or zero. For example $-1.75 is represented
	// as `units`=-1 and `nanos`=-750,000,000.
	Nanos int64 `json:"nanos,omitempty"`

	// Units: The whole units of the amount. For example if `currencyCode`
	// is "USD", then 1 unit is one US dollar.
	Units int64 `json:"units,omitempty,string"`

	// ForceSendFields is a list of field names (e.g. "CurrencyCode") 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. "CurrencyCode") 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:"-"`
}

GoogleTypeMoney: Represents an amount of money with its currency type.

func (*GoogleTypeMoney) MarshalJSON

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

type OrganizationsLocationsInsightTypesInsightsGetCall

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

func (*OrganizationsLocationsInsightTypesInsightsGetCall) Context

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 (*OrganizationsLocationsInsightTypesInsightsGetCall) Do

Do executes the "recommender.organizations.locations.insightTypes.insights.get" call. Exactly one of *GoogleCloudRecommenderV1Insight or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *GoogleCloudRecommenderV1Insight.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 (*OrganizationsLocationsInsightTypesInsightsGetCall) Fields

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

func (*OrganizationsLocationsInsightTypesInsightsGetCall) Header

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

func (*OrganizationsLocationsInsightTypesInsightsGetCall) IfNoneMatch

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 OrganizationsLocationsInsightTypesInsightsListCall

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

func (*OrganizationsLocationsInsightTypesInsightsListCall) Context

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 (*OrganizationsLocationsInsightTypesInsightsListCall) Do

Do executes the "recommender.organizations.locations.insightTypes.insights.list" call. Exactly one of *GoogleCloudRecommenderV1ListInsightsResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *GoogleCloudRecommenderV1ListInsightsResponse.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 (*OrganizationsLocationsInsightTypesInsightsListCall) Fields

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

func (*OrganizationsLocationsInsightTypesInsightsListCall) Filter

Filter sets the optional parameter "filter": Filter expression to restrict the insights returned. Supported filter fields: * `stateInfo.state` * `insightSubtype` * `severity` Examples: * `stateInfo.state = ACTIVE OR stateInfo.state = DISMISSED` * `insightSubtype = PERMISSIONS_USAGE` * `severity = CRITICAL OR severity = HIGH` * `stateInfo.state = ACTIVE AND (severity = CRITICAL OR severity = HIGH)` (These expressions are based on the filter language described at https://google.aip.dev/160)

func (*OrganizationsLocationsInsightTypesInsightsListCall) Header

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

func (*OrganizationsLocationsInsightTypesInsightsListCall) IfNoneMatch

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 (*OrganizationsLocationsInsightTypesInsightsListCall) PageSize

PageSize sets the optional parameter "pageSize": The maximum number of results to return from this request. Non-positive values are ignored. If not specified, the server will determine the number of results to return.

func (*OrganizationsLocationsInsightTypesInsightsListCall) PageToken

PageToken sets the optional parameter "pageToken": If present, retrieves the next batch of results from the preceding call to this method. `page_token` must be the value of `next_page_token` from the previous response. The values of other method parameters must be identical to those in the previous call.

func (*OrganizationsLocationsInsightTypesInsightsListCall) Pages

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 OrganizationsLocationsInsightTypesInsightsMarkAcceptedCall

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

func (*OrganizationsLocationsInsightTypesInsightsMarkAcceptedCall) Context

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 (*OrganizationsLocationsInsightTypesInsightsMarkAcceptedCall) Do

Do executes the "recommender.organizations.locations.insightTypes.insights.markAccepted" call. Exactly one of *GoogleCloudRecommenderV1Insight or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *GoogleCloudRecommenderV1Insight.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 (*OrganizationsLocationsInsightTypesInsightsMarkAcceptedCall) Fields

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

func (*OrganizationsLocationsInsightTypesInsightsMarkAcceptedCall) Header

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

type OrganizationsLocationsInsightTypesInsightsService

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

func (*OrganizationsLocationsInsightTypesInsightsService) Get

Get: Gets the requested insight. Requires the recommender.*.get IAM permission for the specified insight type.

- name: Name of the insight.

func (*OrganizationsLocationsInsightTypesInsightsService) List

List: Lists insights for the specified Cloud Resource. Requires the recommender.*.list IAM permission for the specified insight type.

  • parent: The container resource on which to execute the request. Acceptable formats: 1. `projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGH T_TYPE_ID]` 2. `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/insightTy pes/[INSIGHT_TYPE_ID]` 3. `folders/[FOLDER_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE _ID]` 4. `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/insightTypes/[ INSIGHT_TYPE_ID]` LOCATION here refers to GCP Locations: https://cloud.google.com/about/locations/ INSIGHT_TYPE_ID refers to supported insight types: https://cloud.google.com/recommender/docs/insights/insight-types.

func (*OrganizationsLocationsInsightTypesInsightsService) MarkAccepted

MarkAccepted: Marks the Insight State as Accepted. Users can use this method to indicate to the Recommender API that they have applied some action based on the insight. This stops the insight content from being updated. MarkInsightAccepted can be applied to insights in ACTIVE state. Requires the recommender.*.update IAM permission for the specified insight.

- name: Name of the insight.

type OrganizationsLocationsInsightTypesService

type OrganizationsLocationsInsightTypesService struct {
	Insights *OrganizationsLocationsInsightTypesInsightsService
	// contains filtered or unexported fields
}

func NewOrganizationsLocationsInsightTypesService

func NewOrganizationsLocationsInsightTypesService(s *Service) *OrganizationsLocationsInsightTypesService

type OrganizationsLocationsRecommendersRecommendationsGetCall

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

func (*OrganizationsLocationsRecommendersRecommendationsGetCall) Context

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 (*OrganizationsLocationsRecommendersRecommendationsGetCall) Do

Do executes the "recommender.organizations.locations.recommenders.recommendations.get" call. Exactly one of *GoogleCloudRecommenderV1Recommendation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *GoogleCloudRecommenderV1Recommendation.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 (*OrganizationsLocationsRecommendersRecommendationsGetCall) Fields

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

func (*OrganizationsLocationsRecommendersRecommendationsGetCall) Header

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

func (*OrganizationsLocationsRecommendersRecommendationsGetCall) IfNoneMatch

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 OrganizationsLocationsRecommendersRecommendationsListCall

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

func (*OrganizationsLocationsRecommendersRecommendationsListCall) Context

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 (*OrganizationsLocationsRecommendersRecommendationsListCall) Do

Do executes the "recommender.organizations.locations.recommenders.recommendations.list" call. Exactly one of *GoogleCloudRecommenderV1ListRecommendationsResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *GoogleCloudRecommenderV1ListRecommendationsResponse.ServerResponse.He ader 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 (*OrganizationsLocationsRecommendersRecommendationsListCall) Fields

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

func (*OrganizationsLocationsRecommendersRecommendationsListCall) Filter

Filter sets the optional parameter "filter": Filter expression to restrict the recommendations returned. Supported filter fields: * `state_info.state` * `recommenderSubtype` * `priority` Examples: * `stateInfo.state = ACTIVE OR stateInfo.state = DISMISSED` * `recommenderSubtype = REMOVE_ROLE OR recommenderSubtype = REPLACE_ROLE` * `priority = P1 OR priority = P2` * `stateInfo.state = ACTIVE AND (priority = P1 OR priority = P2)` (These expressions are based on the filter language described at https://google.aip.dev/160)

func (*OrganizationsLocationsRecommendersRecommendationsListCall) Header

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

func (*OrganizationsLocationsRecommendersRecommendationsListCall) IfNoneMatch

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 (*OrganizationsLocationsRecommendersRecommendationsListCall) PageSize

PageSize sets the optional parameter "pageSize": The maximum number of results to return from this request. Non-positive values are ignored. If not specified, the server will determine the number of results to return.

func (*OrganizationsLocationsRecommendersRecommendationsListCall) PageToken

PageToken sets the optional parameter "pageToken": If present, retrieves the next batch of results from the preceding call to this method. `page_token` must be the value of `next_page_token` from the previous response. The values of other method parameters must be identical to those in the previous call.

func (*OrganizationsLocationsRecommendersRecommendationsListCall) Pages

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 OrganizationsLocationsRecommendersRecommendationsMarkClaimedCall

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

func (*OrganizationsLocationsRecommendersRecommendationsMarkClaimedCall) Context

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 (*OrganizationsLocationsRecommendersRecommendationsMarkClaimedCall) Do

Do executes the "recommender.organizations.locations.recommenders.recommendations.markClaimed" call. Exactly one of *GoogleCloudRecommenderV1Recommendation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *GoogleCloudRecommenderV1Recommendation.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 (*OrganizationsLocationsRecommendersRecommendationsMarkClaimedCall) Fields

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

func (*OrganizationsLocationsRecommendersRecommendationsMarkClaimedCall) Header

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

type OrganizationsLocationsRecommendersRecommendationsMarkFailedCall

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

func (*OrganizationsLocationsRecommendersRecommendationsMarkFailedCall) Context

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 (*OrganizationsLocationsRecommendersRecommendationsMarkFailedCall) Do

Do executes the "recommender.organizations.locations.recommenders.recommendations.markFailed" call. Exactly one of *GoogleCloudRecommenderV1Recommendation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *GoogleCloudRecommenderV1Recommendation.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 (*OrganizationsLocationsRecommendersRecommendationsMarkFailedCall) Fields

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

func (*OrganizationsLocationsRecommendersRecommendationsMarkFailedCall) Header

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

type OrganizationsLocationsRecommendersRecommendationsMarkSucceededCall

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

func (*OrganizationsLocationsRecommendersRecommendationsMarkSucceededCall) Context

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 (*OrganizationsLocationsRecommendersRecommendationsMarkSucceededCall) Do

Do executes the "recommender.organizations.locations.recommenders.recommendations.markSucceeded" call. Exactly one of *GoogleCloudRecommenderV1Recommendation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *GoogleCloudRecommenderV1Recommendation.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 (*OrganizationsLocationsRecommendersRecommendationsMarkSucceededCall) Fields

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

func (*OrganizationsLocationsRecommendersRecommendationsMarkSucceededCall) Header

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

type OrganizationsLocationsRecommendersRecommendationsService

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

func (*OrganizationsLocationsRecommendersRecommendationsService) Get

Get: Gets the requested recommendation. Requires the recommender.*.get IAM permission for the specified recommender.

- name: Name of the recommendation.

func (*OrganizationsLocationsRecommendersRecommendationsService) List

List: Lists recommendations for the specified Cloud Resource. Requires the recommender.*.list IAM permission for the specified recommender.

  • parent: The container resource on which to execute the request. Acceptable formats: 1. `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMM ENDER_ID]` 2. `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/recommend ers/[RECOMMENDER_ID]` 3. `folders/[FOLDER_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ ID]` 4. `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[ RECOMMENDER_ID]` LOCATION here refers to GCP Locations: https://cloud.google.com/about/locations/ RECOMMENDER_ID refers to supported recommenders: https://cloud.google.com/recommender/docs/recommenders.

func (*OrganizationsLocationsRecommendersRecommendationsService) MarkClaimed

MarkClaimed: Marks the Recommendation State as Claimed. Users can use this method to indicate to the Recommender API that they are starting to apply the recommendation themselves. This stops the recommendation content from being updated. Associated insights are frozen and placed in the ACCEPTED state. MarkRecommendationClaimed can be applied to recommendations in CLAIMED, SUCCEEDED, FAILED, or ACTIVE state. Requires the recommender.*.update IAM permission for the specified recommender.

- name: Name of the recommendation.

func (*OrganizationsLocationsRecommendersRecommendationsService) MarkFailed

MarkFailed: Marks the Recommendation State as Failed. Users can use this method to indicate to the Recommender API that they have applied the recommendation themselves, and the operation failed. This stops the recommendation content from being updated. Associated insights are frozen and placed in the ACCEPTED state. MarkRecommendationFailed can be applied to recommendations in ACTIVE, CLAIMED, SUCCEEDED, or FAILED state. Requires the recommender.*.update IAM permission for the specified recommender.

- name: Name of the recommendation.

func (*OrganizationsLocationsRecommendersRecommendationsService) MarkSucceeded

MarkSucceeded: Marks the Recommendation State as Succeeded. Users can use this method to indicate to the Recommender API that they have applied the recommendation themselves, and the operation was successful. This stops the recommendation content from being updated. Associated insights are frozen and placed in the ACCEPTED state. MarkRecommendationSucceeded can be applied to recommendations in ACTIVE, CLAIMED, SUCCEEDED, or FAILED state. Requires the recommender.*.update IAM permission for the specified recommender.

- name: Name of the recommendation.

type OrganizationsLocationsRecommendersService

type OrganizationsLocationsRecommendersService struct {
	Recommendations *OrganizationsLocationsRecommendersRecommendationsService
	// contains filtered or unexported fields
}

func NewOrganizationsLocationsRecommendersService

func NewOrganizationsLocationsRecommendersService(s *Service) *OrganizationsLocationsRecommendersService

type OrganizationsLocationsService

type OrganizationsLocationsService struct {
	InsightTypes *OrganizationsLocationsInsightTypesService

	Recommenders *OrganizationsLocationsRecommendersService
	// contains filtered or unexported fields
}

func NewOrganizationsLocationsService

func NewOrganizationsLocationsService(s *Service) *OrganizationsLocationsService

type OrganizationsService

type OrganizationsService struct {
	Locations *OrganizationsLocationsService
	// contains filtered or unexported fields
}

func NewOrganizationsService

func NewOrganizationsService(s *Service) *OrganizationsService

type ProjectsLocationsInsightTypesInsightsGetCall

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

func (*ProjectsLocationsInsightTypesInsightsGetCall) Context

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 (*ProjectsLocationsInsightTypesInsightsGetCall) Do

Do executes the "recommender.projects.locations.insightTypes.insights.get" call. Exactly one of *GoogleCloudRecommenderV1Insight or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *GoogleCloudRecommenderV1Insight.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 (*ProjectsLocationsInsightTypesInsightsGetCall) Fields

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

func (*ProjectsLocationsInsightTypesInsightsGetCall) Header

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

func (*ProjectsLocationsInsightTypesInsightsGetCall) IfNoneMatch

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 ProjectsLocationsInsightTypesInsightsListCall

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

func (*ProjectsLocationsInsightTypesInsightsListCall) Context

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 (*ProjectsLocationsInsightTypesInsightsListCall) Do

Do executes the "recommender.projects.locations.insightTypes.insights.list" call. Exactly one of *GoogleCloudRecommenderV1ListInsightsResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *GoogleCloudRecommenderV1ListInsightsResponse.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 (*ProjectsLocationsInsightTypesInsightsListCall) Fields

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

func (*ProjectsLocationsInsightTypesInsightsListCall) Filter

Filter sets the optional parameter "filter": Filter expression to restrict the insights returned. Supported filter fields: * `stateInfo.state` * `insightSubtype` * `severity` Examples: * `stateInfo.state = ACTIVE OR stateInfo.state = DISMISSED` * `insightSubtype = PERMISSIONS_USAGE` * `severity = CRITICAL OR severity = HIGH` * `stateInfo.state = ACTIVE AND (severity = CRITICAL OR severity = HIGH)` (These expressions are based on the filter language described at https://google.aip.dev/160)

func (*ProjectsLocationsInsightTypesInsightsListCall) Header

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

func (*ProjectsLocationsInsightTypesInsightsListCall) IfNoneMatch

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 (*ProjectsLocationsInsightTypesInsightsListCall) PageSize

PageSize sets the optional parameter "pageSize": The maximum number of results to return from this request. Non-positive values are ignored. If not specified, the server will determine the number of results to return.

func (*ProjectsLocationsInsightTypesInsightsListCall) PageToken

PageToken sets the optional parameter "pageToken": If present, retrieves the next batch of results from the preceding call to this method. `page_token` must be the value of `next_page_token` from the previous response. The values of other method parameters must be identical to those in the previous call.

func (*ProjectsLocationsInsightTypesInsightsListCall) Pages

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 ProjectsLocationsInsightTypesInsightsMarkAcceptedCall

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

func (*ProjectsLocationsInsightTypesInsightsMarkAcceptedCall) Context

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 (*ProjectsLocationsInsightTypesInsightsMarkAcceptedCall) Do

Do executes the "recommender.projects.locations.insightTypes.insights.markAccepted" call. Exactly one of *GoogleCloudRecommenderV1Insight or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *GoogleCloudRecommenderV1Insight.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 (*ProjectsLocationsInsightTypesInsightsMarkAcceptedCall) Fields

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

func (*ProjectsLocationsInsightTypesInsightsMarkAcceptedCall) Header

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

type ProjectsLocationsInsightTypesInsightsService

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

func NewProjectsLocationsInsightTypesInsightsService

func NewProjectsLocationsInsightTypesInsightsService(s *Service) *ProjectsLocationsInsightTypesInsightsService

func (*ProjectsLocationsInsightTypesInsightsService) Get

Get: Gets the requested insight. Requires the recommender.*.get IAM permission for the specified insight type.

- name: Name of the insight.

func (*ProjectsLocationsInsightTypesInsightsService) List

List: Lists insights for the specified Cloud Resource. Requires the recommender.*.list IAM permission for the specified insight type.

  • parent: The container resource on which to execute the request. Acceptable formats: 1. `projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGH T_TYPE_ID]` 2. `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/insightTy pes/[INSIGHT_TYPE_ID]` 3. `folders/[FOLDER_ID]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE _ID]` 4. `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/insightTypes/[ INSIGHT_TYPE_ID]` LOCATION here refers to GCP Locations: https://cloud.google.com/about/locations/ INSIGHT_TYPE_ID refers to supported insight types: https://cloud.google.com/recommender/docs/insights/insight-types.

func (*ProjectsLocationsInsightTypesInsightsService) MarkAccepted

MarkAccepted: Marks the Insight State as Accepted. Users can use this method to indicate to the Recommender API that they have applied some action based on the insight. This stops the insight content from being updated. MarkInsightAccepted can be applied to insights in ACTIVE state. Requires the recommender.*.update IAM permission for the specified insight.

- name: Name of the insight.

type ProjectsLocationsInsightTypesService

type ProjectsLocationsInsightTypesService struct {
	Insights *ProjectsLocationsInsightTypesInsightsService
	// contains filtered or unexported fields
}

func NewProjectsLocationsInsightTypesService

func NewProjectsLocationsInsightTypesService(s *Service) *ProjectsLocationsInsightTypesService

type ProjectsLocationsRecommendersRecommendationsGetCall

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

func (*ProjectsLocationsRecommendersRecommendationsGetCall) Context

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 (*ProjectsLocationsRecommendersRecommendationsGetCall) Do

Do executes the "recommender.projects.locations.recommenders.recommendations.get" call. Exactly one of *GoogleCloudRecommenderV1Recommendation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *GoogleCloudRecommenderV1Recommendation.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 (*ProjectsLocationsRecommendersRecommendationsGetCall) Fields

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

func (*ProjectsLocationsRecommendersRecommendationsGetCall) Header

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

func (*ProjectsLocationsRecommendersRecommendationsGetCall) IfNoneMatch

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 ProjectsLocationsRecommendersRecommendationsListCall

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

func (*ProjectsLocationsRecommendersRecommendationsListCall) Context

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 (*ProjectsLocationsRecommendersRecommendationsListCall) Do

Do executes the "recommender.projects.locations.recommenders.recommendations.list" call. Exactly one of *GoogleCloudRecommenderV1ListRecommendationsResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *GoogleCloudRecommenderV1ListRecommendationsResponse.ServerResponse.He ader 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 (*ProjectsLocationsRecommendersRecommendationsListCall) Fields

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

func (*ProjectsLocationsRecommendersRecommendationsListCall) Filter

Filter sets the optional parameter "filter": Filter expression to restrict the recommendations returned. Supported filter fields: * `state_info.state` * `recommenderSubtype` * `priority` Examples: * `stateInfo.state = ACTIVE OR stateInfo.state = DISMISSED` * `recommenderSubtype = REMOVE_ROLE OR recommenderSubtype = REPLACE_ROLE` * `priority = P1 OR priority = P2` * `stateInfo.state = ACTIVE AND (priority = P1 OR priority = P2)` (These expressions are based on the filter language described at https://google.aip.dev/160)

func (*ProjectsLocationsRecommendersRecommendationsListCall) Header

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

func (*ProjectsLocationsRecommendersRecommendationsListCall) IfNoneMatch

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 (*ProjectsLocationsRecommendersRecommendationsListCall) PageSize

PageSize sets the optional parameter "pageSize": The maximum number of results to return from this request. Non-positive values are ignored. If not specified, the server will determine the number of results to return.

func (*ProjectsLocationsRecommendersRecommendationsListCall) PageToken

PageToken sets the optional parameter "pageToken": If present, retrieves the next batch of results from the preceding call to this method. `page_token` must be the value of `next_page_token` from the previous response. The values of other method parameters must be identical to those in the previous call.

func (*ProjectsLocationsRecommendersRecommendationsListCall) Pages

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 ProjectsLocationsRecommendersRecommendationsMarkClaimedCall

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

func (*ProjectsLocationsRecommendersRecommendationsMarkClaimedCall) Context

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 (*ProjectsLocationsRecommendersRecommendationsMarkClaimedCall) Do

Do executes the "recommender.projects.locations.recommenders.recommendations.markClaimed" call. Exactly one of *GoogleCloudRecommenderV1Recommendation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *GoogleCloudRecommenderV1Recommendation.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 (*ProjectsLocationsRecommendersRecommendationsMarkClaimedCall) Fields

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

func (*ProjectsLocationsRecommendersRecommendationsMarkClaimedCall) Header

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

type ProjectsLocationsRecommendersRecommendationsMarkFailedCall

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

func (*ProjectsLocationsRecommendersRecommendationsMarkFailedCall) Context

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 (*ProjectsLocationsRecommendersRecommendationsMarkFailedCall) Do

Do executes the "recommender.projects.locations.recommenders.recommendations.markFailed" call. Exactly one of *GoogleCloudRecommenderV1Recommendation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *GoogleCloudRecommenderV1Recommendation.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 (*ProjectsLocationsRecommendersRecommendationsMarkFailedCall) Fields

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

func (*ProjectsLocationsRecommendersRecommendationsMarkFailedCall) Header

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

type ProjectsLocationsRecommendersRecommendationsMarkSucceededCall

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

func (*ProjectsLocationsRecommendersRecommendationsMarkSucceededCall) Context

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 (*ProjectsLocationsRecommendersRecommendationsMarkSucceededCall) Do

Do executes the "recommender.projects.locations.recommenders.recommendations.markSucceeded" call. Exactly one of *GoogleCloudRecommenderV1Recommendation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *GoogleCloudRecommenderV1Recommendation.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 (*ProjectsLocationsRecommendersRecommendationsMarkSucceededCall) Fields

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

func (*ProjectsLocationsRecommendersRecommendationsMarkSucceededCall) Header

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

type ProjectsLocationsRecommendersRecommendationsService

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

func (*ProjectsLocationsRecommendersRecommendationsService) Get

Get: Gets the requested recommendation. Requires the recommender.*.get IAM permission for the specified recommender.

- name: Name of the recommendation.

func (*ProjectsLocationsRecommendersRecommendationsService) List

List: Lists recommendations for the specified Cloud Resource. Requires the recommender.*.list IAM permission for the specified recommender.

  • parent: The container resource on which to execute the request. Acceptable formats: 1. `projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMM ENDER_ID]` 2. `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION]/recommend ers/[RECOMMENDER_ID]` 3. `folders/[FOLDER_ID]/locations/[LOCATION]/recommenders/[RECOMMENDER_ ID]` 4. `organizations/[ORGANIZATION_ID]/locations/[LOCATION]/recommenders/[ RECOMMENDER_ID]` LOCATION here refers to GCP Locations: https://cloud.google.com/about/locations/ RECOMMENDER_ID refers to supported recommenders: https://cloud.google.com/recommender/docs/recommenders.

func (*ProjectsLocationsRecommendersRecommendationsService) MarkClaimed

MarkClaimed: Marks the Recommendation State as Claimed. Users can use this method to indicate to the Recommender API that they are starting to apply the recommendation themselves. This stops the recommendation content from being updated. Associated insights are frozen and placed in the ACCEPTED state. MarkRecommendationClaimed can be applied to recommendations in CLAIMED, SUCCEEDED, FAILED, or ACTIVE state. Requires the recommender.*.update IAM permission for the specified recommender.

- name: Name of the recommendation.

func (*ProjectsLocationsRecommendersRecommendationsService) MarkFailed

MarkFailed: Marks the Recommendation State as Failed. Users can use this method to indicate to the Recommender API that they have applied the recommendation themselves, and the operation failed. This stops the recommendation content from being updated. Associated insights are frozen and placed in the ACCEPTED state. MarkRecommendationFailed can be applied to recommendations in ACTIVE, CLAIMED, SUCCEEDED, or FAILED state. Requires the recommender.*.update IAM permission for the specified recommender.

- name: Name of the recommendation.

func (*ProjectsLocationsRecommendersRecommendationsService) MarkSucceeded

MarkSucceeded: Marks the Recommendation State as Succeeded. Users can use this method to indicate to the Recommender API that they have applied the recommendation themselves, and the operation was successful. This stops the recommendation content from being updated. Associated insights are frozen and placed in the ACCEPTED state. MarkRecommendationSucceeded can be applied to recommendations in ACTIVE, CLAIMED, SUCCEEDED, or FAILED state. Requires the recommender.*.update IAM permission for the specified recommender.

- name: Name of the recommendation.

type ProjectsLocationsRecommendersService

type ProjectsLocationsRecommendersService struct {
	Recommendations *ProjectsLocationsRecommendersRecommendationsService
	// contains filtered or unexported fields
}

func NewProjectsLocationsRecommendersService

func NewProjectsLocationsRecommendersService(s *Service) *ProjectsLocationsRecommendersService

type ProjectsLocationsService

type ProjectsLocationsService struct {
	InsightTypes *ProjectsLocationsInsightTypesService

	Recommenders *ProjectsLocationsRecommendersService
	// contains filtered or unexported fields
}

func NewProjectsLocationsService

func NewProjectsLocationsService(s *Service) *ProjectsLocationsService

type ProjectsService

type ProjectsService struct {
	Locations *ProjectsLocationsService
	// contains filtered or unexported fields
}

func NewProjectsService

func NewProjectsService(s *Service) *ProjectsService

type Service

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

	BillingAccounts *BillingAccountsService

	Folders *FoldersService

	Organizations *OrganizationsService

	Projects *ProjectsService
	// contains filtered or unexported fields
}

func New deprecated

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

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

NewService creates a new Service.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL