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
- type GoogleCloudRecommenderV1CostProjection
- type GoogleCloudRecommenderV1Impact
- type GoogleCloudRecommenderV1Insight
- type GoogleCloudRecommenderV1InsightRecommendationReference
- type GoogleCloudRecommenderV1InsightStateInfo
- type GoogleCloudRecommenderV1ListInsightsResponse
- type GoogleCloudRecommenderV1ListRecommendationsResponse
- type GoogleCloudRecommenderV1MarkInsightAcceptedRequest
- type GoogleCloudRecommenderV1MarkRecommendationClaimedRequest
- type GoogleCloudRecommenderV1MarkRecommendationFailedRequest
- type GoogleCloudRecommenderV1MarkRecommendationSucceededRequest
- type GoogleCloudRecommenderV1Operation
- type GoogleCloudRecommenderV1OperationGroup
- type GoogleCloudRecommenderV1Recommendation
- type GoogleCloudRecommenderV1RecommendationContent
- type GoogleCloudRecommenderV1RecommendationInsightReference
- type GoogleCloudRecommenderV1RecommendationStateInfo
- type GoogleCloudRecommenderV1ValueMatcher
- type GoogleTypeMoney
- type ProjectsLocationsInsightTypesInsightsGetCall
- func (c *ProjectsLocationsInsightTypesInsightsGetCall) Context(ctx context.Context) *ProjectsLocationsInsightTypesInsightsGetCall
- func (c *ProjectsLocationsInsightTypesInsightsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRecommenderV1Insight, error)
- func (c *ProjectsLocationsInsightTypesInsightsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsInsightTypesInsightsGetCall
- func (c *ProjectsLocationsInsightTypesInsightsGetCall) Header() http.Header
- func (c *ProjectsLocationsInsightTypesInsightsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsInsightTypesInsightsGetCall
- type ProjectsLocationsInsightTypesInsightsListCall
- func (c *ProjectsLocationsInsightTypesInsightsListCall) Context(ctx context.Context) *ProjectsLocationsInsightTypesInsightsListCall
- func (c *ProjectsLocationsInsightTypesInsightsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRecommenderV1ListInsightsResponse, error)
- func (c *ProjectsLocationsInsightTypesInsightsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsInsightTypesInsightsListCall
- func (c *ProjectsLocationsInsightTypesInsightsListCall) Filter(filter string) *ProjectsLocationsInsightTypesInsightsListCall
- func (c *ProjectsLocationsInsightTypesInsightsListCall) Header() http.Header
- func (c *ProjectsLocationsInsightTypesInsightsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsInsightTypesInsightsListCall
- func (c *ProjectsLocationsInsightTypesInsightsListCall) PageSize(pageSize int64) *ProjectsLocationsInsightTypesInsightsListCall
- func (c *ProjectsLocationsInsightTypesInsightsListCall) PageToken(pageToken string) *ProjectsLocationsInsightTypesInsightsListCall
- func (c *ProjectsLocationsInsightTypesInsightsListCall) Pages(ctx context.Context, ...) error
- type ProjectsLocationsInsightTypesInsightsMarkAcceptedCall
- func (c *ProjectsLocationsInsightTypesInsightsMarkAcceptedCall) Context(ctx context.Context) *ProjectsLocationsInsightTypesInsightsMarkAcceptedCall
- func (c *ProjectsLocationsInsightTypesInsightsMarkAcceptedCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRecommenderV1Insight, error)
- func (c *ProjectsLocationsInsightTypesInsightsMarkAcceptedCall) Fields(s ...googleapi.Field) *ProjectsLocationsInsightTypesInsightsMarkAcceptedCall
- func (c *ProjectsLocationsInsightTypesInsightsMarkAcceptedCall) Header() http.Header
- type ProjectsLocationsInsightTypesInsightsService
- func (r *ProjectsLocationsInsightTypesInsightsService) Get(name string) *ProjectsLocationsInsightTypesInsightsGetCall
- func (r *ProjectsLocationsInsightTypesInsightsService) List(parent string) *ProjectsLocationsInsightTypesInsightsListCall
- func (r *ProjectsLocationsInsightTypesInsightsService) MarkAccepted(name string, ...) *ProjectsLocationsInsightTypesInsightsMarkAcceptedCall
- type ProjectsLocationsInsightTypesService
- type ProjectsLocationsRecommendersRecommendationsGetCall
- func (c *ProjectsLocationsRecommendersRecommendationsGetCall) Context(ctx context.Context) *ProjectsLocationsRecommendersRecommendationsGetCall
- func (c *ProjectsLocationsRecommendersRecommendationsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRecommenderV1Recommendation, error)
- func (c *ProjectsLocationsRecommendersRecommendationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsRecommendersRecommendationsGetCall
- func (c *ProjectsLocationsRecommendersRecommendationsGetCall) Header() http.Header
- func (c *ProjectsLocationsRecommendersRecommendationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsRecommendersRecommendationsGetCall
- type ProjectsLocationsRecommendersRecommendationsListCall
- func (c *ProjectsLocationsRecommendersRecommendationsListCall) Context(ctx context.Context) *ProjectsLocationsRecommendersRecommendationsListCall
- func (c *ProjectsLocationsRecommendersRecommendationsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRecommenderV1ListRecommendationsResponse, error)
- func (c *ProjectsLocationsRecommendersRecommendationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsRecommendersRecommendationsListCall
- func (c *ProjectsLocationsRecommendersRecommendationsListCall) Filter(filter string) *ProjectsLocationsRecommendersRecommendationsListCall
- func (c *ProjectsLocationsRecommendersRecommendationsListCall) Header() http.Header
- func (c *ProjectsLocationsRecommendersRecommendationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsRecommendersRecommendationsListCall
- func (c *ProjectsLocationsRecommendersRecommendationsListCall) PageSize(pageSize int64) *ProjectsLocationsRecommendersRecommendationsListCall
- func (c *ProjectsLocationsRecommendersRecommendationsListCall) PageToken(pageToken string) *ProjectsLocationsRecommendersRecommendationsListCall
- func (c *ProjectsLocationsRecommendersRecommendationsListCall) Pages(ctx context.Context, ...) error
- type ProjectsLocationsRecommendersRecommendationsMarkClaimedCall
- func (c *ProjectsLocationsRecommendersRecommendationsMarkClaimedCall) Context(ctx context.Context) *ProjectsLocationsRecommendersRecommendationsMarkClaimedCall
- func (c *ProjectsLocationsRecommendersRecommendationsMarkClaimedCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRecommenderV1Recommendation, error)
- func (c *ProjectsLocationsRecommendersRecommendationsMarkClaimedCall) Fields(s ...googleapi.Field) *ProjectsLocationsRecommendersRecommendationsMarkClaimedCall
- func (c *ProjectsLocationsRecommendersRecommendationsMarkClaimedCall) Header() http.Header
- type ProjectsLocationsRecommendersRecommendationsMarkFailedCall
- func (c *ProjectsLocationsRecommendersRecommendationsMarkFailedCall) Context(ctx context.Context) *ProjectsLocationsRecommendersRecommendationsMarkFailedCall
- func (c *ProjectsLocationsRecommendersRecommendationsMarkFailedCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRecommenderV1Recommendation, error)
- func (c *ProjectsLocationsRecommendersRecommendationsMarkFailedCall) Fields(s ...googleapi.Field) *ProjectsLocationsRecommendersRecommendationsMarkFailedCall
- func (c *ProjectsLocationsRecommendersRecommendationsMarkFailedCall) Header() http.Header
- type ProjectsLocationsRecommendersRecommendationsMarkSucceededCall
- func (c *ProjectsLocationsRecommendersRecommendationsMarkSucceededCall) Context(ctx context.Context) *ProjectsLocationsRecommendersRecommendationsMarkSucceededCall
- func (c *ProjectsLocationsRecommendersRecommendationsMarkSucceededCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRecommenderV1Recommendation, error)
- func (c *ProjectsLocationsRecommendersRecommendationsMarkSucceededCall) Fields(s ...googleapi.Field) *ProjectsLocationsRecommendersRecommendationsMarkSucceededCall
- func (c *ProjectsLocationsRecommendersRecommendationsMarkSucceededCall) Header() http.Header
- type ProjectsLocationsRecommendersRecommendationsService
- func (r *ProjectsLocationsRecommendersRecommendationsService) Get(name string) *ProjectsLocationsRecommendersRecommendationsGetCall
- func (r *ProjectsLocationsRecommendersRecommendationsService) List(parent string) *ProjectsLocationsRecommendersRecommendationsListCall
- func (r *ProjectsLocationsRecommendersRecommendationsService) MarkClaimed(name string, ...) *ProjectsLocationsRecommendersRecommendationsMarkClaimedCall
- func (r *ProjectsLocationsRecommendersRecommendationsService) MarkFailed(name string, ...) *ProjectsLocationsRecommendersRecommendationsMarkFailedCall
- func (r *ProjectsLocationsRecommendersRecommendationsService) MarkSucceeded(name string, ...) *ProjectsLocationsRecommendersRecommendationsMarkSucceededCall
- type ProjectsLocationsRecommendersService
- type ProjectsLocationsService
- type ProjectsService
- type Service
Constants ¶
const (
// View and manage your data across Google Cloud Platform services
CloudPlatformScope = "https://www.googleapis.com/auth/cloud-platform"
)
OAuth2 scopes used by this API.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type 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"` // 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 ¶ added in v0.30.0
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"` // 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 ¶ added in v0.30.0
func (s *GoogleCloudRecommenderV1Insight) MarshalJSON() ([]byte, error)
type GoogleCloudRecommenderV1InsightRecommendationReference ¶ added in v0.30.0
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 ¶ added in v0.30.0
func (s *GoogleCloudRecommenderV1InsightRecommendationReference) MarshalJSON() ([]byte, error)
type GoogleCloudRecommenderV1InsightStateInfo ¶ added in v0.30.0
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 ¶ added in v0.30.0
func (s *GoogleCloudRecommenderV1InsightStateInfo) MarshalJSON() ([]byte, error)
type GoogleCloudRecommenderV1ListInsightsResponse ¶ added in v0.30.0
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 ¶ added in v0.30.0
func (s *GoogleCloudRecommenderV1ListInsightsResponse) MarshalJSON() ([]byte, error)
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 ¶
func (s *GoogleCloudRecommenderV1ListRecommendationsResponse) MarshalJSON() ([]byte, error)
type GoogleCloudRecommenderV1MarkInsightAcceptedRequest ¶ added in v0.30.0
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 ¶ added in v0.30.0
func (s *GoogleCloudRecommenderV1MarkInsightAcceptedRequest) MarshalJSON() ([]byte, error)
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 ¶
func (s *GoogleCloudRecommenderV1MarkRecommendationClaimedRequest) MarshalJSON() ([]byte, error)
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 ¶
func (s *GoogleCloudRecommenderV1MarkRecommendationFailedRequest) MarshalJSON() ([]byte, error)
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 ¶
func (s *GoogleCloudRecommenderV1MarkRecommendationSucceededRequest) MarshalJSON() ([]byte, error)
type GoogleCloudRecommenderV1Operation ¶
type GoogleCloudRecommenderV1Operation struct { // Action: Type of this operation. Contains one of 'and', '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/admin" "/bindings/*/condition" : null } * // Example: { "/bindings/*/role": "roles/admin" "/bindings/*/members/*" // : ["x@google.com", "y@google.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 referes 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"` // 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 ¶
func (s *GoogleCloudRecommenderV1RecommendationContent) MarshalJSON() ([]byte, error)
type GoogleCloudRecommenderV1RecommendationInsightReference ¶ added in v0.30.0
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 ¶ added in v0.30.0
func (s *GoogleCloudRecommenderV1RecommendationInsightReference) MarshalJSON() ([]byte, error)
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 ¶
func (s *GoogleCloudRecommenderV1RecommendationStateInfo) MarshalJSON() ([]byte, error)
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 ProjectsLocationsInsightTypesInsightsGetCall ¶ added in v0.30.0
type ProjectsLocationsInsightTypesInsightsGetCall struct {
// contains filtered or unexported fields
}
func (*ProjectsLocationsInsightTypesInsightsGetCall) Context ¶ added in v0.30.0
func (c *ProjectsLocationsInsightTypesInsightsGetCall) Context(ctx context.Context) *ProjectsLocationsInsightTypesInsightsGetCall
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 ¶ added in v0.30.0
func (c *ProjectsLocationsInsightTypesInsightsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRecommenderV1Insight, error)
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 ¶ added in v0.30.0
func (c *ProjectsLocationsInsightTypesInsightsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsInsightTypesInsightsGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (*ProjectsLocationsInsightTypesInsightsGetCall) Header ¶ added in v0.30.0
func (c *ProjectsLocationsInsightTypesInsightsGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (*ProjectsLocationsInsightTypesInsightsGetCall) IfNoneMatch ¶ added in v0.30.0
func (c *ProjectsLocationsInsightTypesInsightsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsInsightTypesInsightsGetCall
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 ¶ added in v0.30.0
type ProjectsLocationsInsightTypesInsightsListCall struct {
// contains filtered or unexported fields
}
func (*ProjectsLocationsInsightTypesInsightsListCall) Context ¶ added in v0.30.0
func (c *ProjectsLocationsInsightTypesInsightsListCall) Context(ctx context.Context) *ProjectsLocationsInsightTypesInsightsListCall
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 ¶ added in v0.30.0
func (c *ProjectsLocationsInsightTypesInsightsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRecommenderV1ListInsightsResponse, error)
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 ¶ added in v0.30.0
func (c *ProjectsLocationsInsightTypesInsightsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsInsightTypesInsightsListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (*ProjectsLocationsInsightTypesInsightsListCall) Filter ¶ added in v0.30.0
func (c *ProjectsLocationsInsightTypesInsightsListCall) Filter(filter string) *ProjectsLocationsInsightTypesInsightsListCall
Filter sets the optional parameter "filter": Filter expression to restrict the insights returned. Supported filter fields: state Eg: `state:"DISMISSED" or state:"ACTIVE"
func (*ProjectsLocationsInsightTypesInsightsListCall) Header ¶ added in v0.30.0
func (c *ProjectsLocationsInsightTypesInsightsListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (*ProjectsLocationsInsightTypesInsightsListCall) IfNoneMatch ¶ added in v0.30.0
func (c *ProjectsLocationsInsightTypesInsightsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsInsightTypesInsightsListCall
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 ¶ added in v0.30.0
func (c *ProjectsLocationsInsightTypesInsightsListCall) PageSize(pageSize int64) *ProjectsLocationsInsightTypesInsightsListCall
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 ¶ added in v0.30.0
func (c *ProjectsLocationsInsightTypesInsightsListCall) PageToken(pageToken string) *ProjectsLocationsInsightTypesInsightsListCall
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 ¶ added in v0.30.0
func (c *ProjectsLocationsInsightTypesInsightsListCall) Pages(ctx context.Context, f func(*GoogleCloudRecommenderV1ListInsightsResponse) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type ProjectsLocationsInsightTypesInsightsMarkAcceptedCall ¶ added in v0.30.0
type ProjectsLocationsInsightTypesInsightsMarkAcceptedCall struct {
// contains filtered or unexported fields
}
func (*ProjectsLocationsInsightTypesInsightsMarkAcceptedCall) Context ¶ added in v0.30.0
func (c *ProjectsLocationsInsightTypesInsightsMarkAcceptedCall) Context(ctx context.Context) *ProjectsLocationsInsightTypesInsightsMarkAcceptedCall
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 ¶ added in v0.30.0
func (c *ProjectsLocationsInsightTypesInsightsMarkAcceptedCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRecommenderV1Insight, error)
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 ¶ added in v0.30.0
func (c *ProjectsLocationsInsightTypesInsightsMarkAcceptedCall) Fields(s ...googleapi.Field) *ProjectsLocationsInsightTypesInsightsMarkAcceptedCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (*ProjectsLocationsInsightTypesInsightsMarkAcceptedCall) Header ¶ added in v0.30.0
func (c *ProjectsLocationsInsightTypesInsightsMarkAcceptedCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
type ProjectsLocationsInsightTypesInsightsService ¶ added in v0.30.0
type ProjectsLocationsInsightTypesInsightsService struct {
// contains filtered or unexported fields
}
func NewProjectsLocationsInsightTypesInsightsService ¶ added in v0.30.0
func NewProjectsLocationsInsightTypesInsightsService(s *Service) *ProjectsLocationsInsightTypesInsightsService
func (*ProjectsLocationsInsightTypesInsightsService) Get ¶ added in v0.30.0
func (r *ProjectsLocationsInsightTypesInsightsService) Get(name string) *ProjectsLocationsInsightTypesInsightsGetCall
Get: Gets the requested insight. Requires the recommender.*.get IAM permission for the specified insight type.
func (*ProjectsLocationsInsightTypesInsightsService) List ¶ added in v0.30.0
func (r *ProjectsLocationsInsightTypesInsightsService) List(parent string) *ProjectsLocationsInsightTypesInsightsListCall
List: Lists insights for a Cloud project. Requires the recommender.*.list IAM permission for the specified insight type.
func (*ProjectsLocationsInsightTypesInsightsService) MarkAccepted ¶ added in v0.30.0
func (r *ProjectsLocationsInsightTypesInsightsService) MarkAccepted(name string, googlecloudrecommenderv1markinsightacceptedrequest *GoogleCloudRecommenderV1MarkInsightAcceptedRequest) *ProjectsLocationsInsightTypesInsightsMarkAcceptedCall
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.
type ProjectsLocationsInsightTypesService ¶ added in v0.30.0
type ProjectsLocationsInsightTypesService struct { Insights *ProjectsLocationsInsightTypesInsightsService // contains filtered or unexported fields }
func NewProjectsLocationsInsightTypesService ¶ added in v0.30.0
func NewProjectsLocationsInsightTypesService(s *Service) *ProjectsLocationsInsightTypesService
type ProjectsLocationsRecommendersRecommendationsGetCall ¶
type ProjectsLocationsRecommendersRecommendationsGetCall struct {
// contains filtered or unexported fields
}
func (*ProjectsLocationsRecommendersRecommendationsGetCall) Context ¶
func (c *ProjectsLocationsRecommendersRecommendationsGetCall) Context(ctx context.Context) *ProjectsLocationsRecommendersRecommendationsGetCall
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 ¶
func (c *ProjectsLocationsRecommendersRecommendationsGetCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRecommenderV1Recommendation, error)
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 ¶
func (c *ProjectsLocationsRecommendersRecommendationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsRecommendersRecommendationsGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (*ProjectsLocationsRecommendersRecommendationsGetCall) Header ¶
func (c *ProjectsLocationsRecommendersRecommendationsGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (*ProjectsLocationsRecommendersRecommendationsGetCall) IfNoneMatch ¶
func (c *ProjectsLocationsRecommendersRecommendationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsRecommendersRecommendationsGetCall
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 ¶
func (c *ProjectsLocationsRecommendersRecommendationsListCall) Context(ctx context.Context) *ProjectsLocationsRecommendersRecommendationsListCall
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 ¶
func (c *ProjectsLocationsRecommendersRecommendationsListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRecommenderV1ListRecommendationsResponse, error)
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 ¶
func (c *ProjectsLocationsRecommendersRecommendationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsRecommendersRecommendationsListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (*ProjectsLocationsRecommendersRecommendationsListCall) Filter ¶
func (c *ProjectsLocationsRecommendersRecommendationsListCall) Filter(filter string) *ProjectsLocationsRecommendersRecommendationsListCall
Filter sets the optional parameter "filter": Filter expression to restrict the recommendations returned. Supported filter fields: state_info.state Eg: `state_info.state:"DISMISSED" or state_info.state:"FAILED"
func (*ProjectsLocationsRecommendersRecommendationsListCall) Header ¶
func (c *ProjectsLocationsRecommendersRecommendationsListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (*ProjectsLocationsRecommendersRecommendationsListCall) IfNoneMatch ¶
func (c *ProjectsLocationsRecommendersRecommendationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsRecommendersRecommendationsListCall
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 ¶
func (c *ProjectsLocationsRecommendersRecommendationsListCall) PageSize(pageSize int64) *ProjectsLocationsRecommendersRecommendationsListCall
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 ¶
func (c *ProjectsLocationsRecommendersRecommendationsListCall) PageToken(pageToken string) *ProjectsLocationsRecommendersRecommendationsListCall
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 ¶
func (c *ProjectsLocationsRecommendersRecommendationsListCall) Pages(ctx context.Context, f func(*GoogleCloudRecommenderV1ListRecommendationsResponse) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type ProjectsLocationsRecommendersRecommendationsMarkClaimedCall ¶
type ProjectsLocationsRecommendersRecommendationsMarkClaimedCall struct {
// contains filtered or unexported fields
}
func (*ProjectsLocationsRecommendersRecommendationsMarkClaimedCall) Context ¶
func (c *ProjectsLocationsRecommendersRecommendationsMarkClaimedCall) Context(ctx context.Context) *ProjectsLocationsRecommendersRecommendationsMarkClaimedCall
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 ¶
func (c *ProjectsLocationsRecommendersRecommendationsMarkClaimedCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRecommenderV1Recommendation, error)
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 ¶
func (c *ProjectsLocationsRecommendersRecommendationsMarkClaimedCall) Fields(s ...googleapi.Field) *ProjectsLocationsRecommendersRecommendationsMarkClaimedCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (*ProjectsLocationsRecommendersRecommendationsMarkClaimedCall) Header ¶
func (c *ProjectsLocationsRecommendersRecommendationsMarkClaimedCall) Header() http.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 ¶
func (c *ProjectsLocationsRecommendersRecommendationsMarkFailedCall) Context(ctx context.Context) *ProjectsLocationsRecommendersRecommendationsMarkFailedCall
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 ¶
func (c *ProjectsLocationsRecommendersRecommendationsMarkFailedCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRecommenderV1Recommendation, error)
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 ¶
func (c *ProjectsLocationsRecommendersRecommendationsMarkFailedCall) Fields(s ...googleapi.Field) *ProjectsLocationsRecommendersRecommendationsMarkFailedCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (*ProjectsLocationsRecommendersRecommendationsMarkFailedCall) Header ¶
func (c *ProjectsLocationsRecommendersRecommendationsMarkFailedCall) Header() http.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 ¶
func (c *ProjectsLocationsRecommendersRecommendationsMarkSucceededCall) Context(ctx context.Context) *ProjectsLocationsRecommendersRecommendationsMarkSucceededCall
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 ¶
func (c *ProjectsLocationsRecommendersRecommendationsMarkSucceededCall) Do(opts ...googleapi.CallOption) (*GoogleCloudRecommenderV1Recommendation, error)
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 ¶
func (c *ProjectsLocationsRecommendersRecommendationsMarkSucceededCall) Fields(s ...googleapi.Field) *ProjectsLocationsRecommendersRecommendationsMarkSucceededCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (*ProjectsLocationsRecommendersRecommendationsMarkSucceededCall) Header ¶
func (c *ProjectsLocationsRecommendersRecommendationsMarkSucceededCall) Header() http.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 NewProjectsLocationsRecommendersRecommendationsService ¶
func NewProjectsLocationsRecommendersRecommendationsService(s *Service) *ProjectsLocationsRecommendersRecommendationsService
func (*ProjectsLocationsRecommendersRecommendationsService) Get ¶
func (r *ProjectsLocationsRecommendersRecommendationsService) Get(name string) *ProjectsLocationsRecommendersRecommendationsGetCall
Get: Gets the requested recommendation. Requires the recommender.*.get IAM permission for the specified recommender.
func (*ProjectsLocationsRecommendersRecommendationsService) List ¶
func (r *ProjectsLocationsRecommendersRecommendationsService) List(parent string) *ProjectsLocationsRecommendersRecommendationsListCall
List: Lists recommendations for a Cloud project. Requires the recommender.*.list IAM permission for the specified recommender.
func (*ProjectsLocationsRecommendersRecommendationsService) MarkClaimed ¶
func (r *ProjectsLocationsRecommendersRecommendationsService) MarkClaimed(name string, googlecloudrecommenderv1markrecommendationclaimedrequest *GoogleCloudRecommenderV1MarkRecommendationClaimedRequest) *ProjectsLocationsRecommendersRecommendationsMarkClaimedCall
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.
func (*ProjectsLocationsRecommendersRecommendationsService) MarkFailed ¶
func (r *ProjectsLocationsRecommendersRecommendationsService) MarkFailed(name string, googlecloudrecommenderv1markrecommendationfailedrequest *GoogleCloudRecommenderV1MarkRecommendationFailedRequest) *ProjectsLocationsRecommendersRecommendationsMarkFailedCall
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.
func (*ProjectsLocationsRecommendersRecommendationsService) MarkSucceeded ¶
func (r *ProjectsLocationsRecommendersRecommendationsService) MarkSucceeded(name string, googlecloudrecommenderv1markrecommendationsucceededrequest *GoogleCloudRecommenderV1MarkRecommendationSucceededRequest) *ProjectsLocationsRecommendersRecommendationsMarkSucceededCall
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.
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 Projects *ProjectsService // contains filtered or unexported fields }
func New
deprecated
New creates a new Service. It uses the provided http.Client for requests.
Deprecated: please use NewService instead. To provide a custom HTTP client, use option.WithHTTPClient. If you are using google.golang.org/api/googleapis/transport.APIKey, use option.WithAPIKey with NewService instead.
func NewService ¶
NewService creates a new Service.