recommendations

Creates, updates, deletes, gets or lists a recommendations resource.

Overview

Name	recommendations
Type	Resource
Id	google.recommender.recommendations

Fields

The following fields are returned by SELECT queries:

projects_locations_recommenders_recommendations_get

Successful response

Name	Datatype	Description
name	string	Identifier. Name of recommendation.
additionalImpact	array	Optional set of additional impact that this recommendation may have when trying to optimize for the primary category. These may be positive or negative.
associatedInsights	array	Insights that led to this recommendation.
content	object	Content of the recommendation describing recommended changes to resources. (id: GoogleCloudRecommenderV1RecommendationContent)
description	string	Free-form human readable summary in English. The maximum length is 500 characters.
etag	string	Fingerprint of the Recommendation. Provides optimistic locking when updating states.
lastRefreshTime	string (google-datetime)	Last time this recommendation was refreshed by the system that created it in the first place.
primaryImpact	object	The primary impact that this recommendation can have while trying to optimize for one category. (id: GoogleCloudRecommenderV1Impact)
priority	string	Recommendation's priority.
recommenderSubtype	string	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"
stateInfo	object	Information for state. Contains state and metadata. (id: GoogleCloudRecommenderV1RecommendationStateInfo)
targetResources	array	Fully qualified resource names that this recommendation is targeting.
xorGroupId	string	Corresponds to a mutually exclusive group ID within a recommender. A non-empty ID indicates that the recommendation belongs to a mutually exclusive group. This means that only one recommendation within the group is suggested to be applied.

billing_accounts_locations_recommenders_recommendations_get

Successful response

Name	Datatype	Description
name	string	Identifier. Name of recommendation.
additionalImpact	array	Optional set of additional impact that this recommendation may have when trying to optimize for the primary category. These may be positive or negative.
associatedInsights	array	Insights that led to this recommendation.
content	object	Content of the recommendation describing recommended changes to resources. (id: GoogleCloudRecommenderV1RecommendationContent)
description	string	Free-form human readable summary in English. The maximum length is 500 characters.
etag	string	Fingerprint of the Recommendation. Provides optimistic locking when updating states.
lastRefreshTime	string (google-datetime)	Last time this recommendation was refreshed by the system that created it in the first place.
primaryImpact	object	The primary impact that this recommendation can have while trying to optimize for one category. (id: GoogleCloudRecommenderV1Impact)
priority	string	Recommendation's priority.
recommenderSubtype	string	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"
stateInfo	object	Information for state. Contains state and metadata. (id: GoogleCloudRecommenderV1RecommendationStateInfo)
targetResources	array	Fully qualified resource names that this recommendation is targeting.
xorGroupId	string	Corresponds to a mutually exclusive group ID within a recommender. A non-empty ID indicates that the recommendation belongs to a mutually exclusive group. This means that only one recommendation within the group is suggested to be applied.

folders_locations_recommenders_recommendations_get

Successful response

Name	Datatype	Description
name	string	Identifier. Name of recommendation.
additionalImpact	array	Optional set of additional impact that this recommendation may have when trying to optimize for the primary category. These may be positive or negative.
associatedInsights	array	Insights that led to this recommendation.
content	object	Content of the recommendation describing recommended changes to resources. (id: GoogleCloudRecommenderV1RecommendationContent)
description	string	Free-form human readable summary in English. The maximum length is 500 characters.
etag	string	Fingerprint of the Recommendation. Provides optimistic locking when updating states.
lastRefreshTime	string (google-datetime)	Last time this recommendation was refreshed by the system that created it in the first place.
primaryImpact	object	The primary impact that this recommendation can have while trying to optimize for one category. (id: GoogleCloudRecommenderV1Impact)
priority	string	Recommendation's priority.
recommenderSubtype	string	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"
stateInfo	object	Information for state. Contains state and metadata. (id: GoogleCloudRecommenderV1RecommendationStateInfo)
targetResources	array	Fully qualified resource names that this recommendation is targeting.
xorGroupId	string	Corresponds to a mutually exclusive group ID within a recommender. A non-empty ID indicates that the recommendation belongs to a mutually exclusive group. This means that only one recommendation within the group is suggested to be applied.

organizations_locations_recommenders_recommendations_get

Successful response

Name	Datatype	Description
name	string	Identifier. Name of recommendation.
additionalImpact	array	Optional set of additional impact that this recommendation may have when trying to optimize for the primary category. These may be positive or negative.
associatedInsights	array	Insights that led to this recommendation.
content	object	Content of the recommendation describing recommended changes to resources. (id: GoogleCloudRecommenderV1RecommendationContent)
description	string	Free-form human readable summary in English. The maximum length is 500 characters.
etag	string	Fingerprint of the Recommendation. Provides optimistic locking when updating states.
lastRefreshTime	string (google-datetime)	Last time this recommendation was refreshed by the system that created it in the first place.
primaryImpact	object	The primary impact that this recommendation can have while trying to optimize for one category. (id: GoogleCloudRecommenderV1Impact)
priority	string	Recommendation's priority.
recommenderSubtype	string	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"
stateInfo	object	Information for state. Contains state and metadata. (id: GoogleCloudRecommenderV1RecommendationStateInfo)
targetResources	array	Fully qualified resource names that this recommendation is targeting.
xorGroupId	string	Corresponds to a mutually exclusive group ID within a recommender. A non-empty ID indicates that the recommendation belongs to a mutually exclusive group. This means that only one recommendation within the group is suggested to be applied.

projects_locations_recommenders_recommendations_list

Successful response

Name	Datatype	Description
name	string	Identifier. Name of recommendation.
additionalImpact	array	Optional set of additional impact that this recommendation may have when trying to optimize for the primary category. These may be positive or negative.
associatedInsights	array	Insights that led to this recommendation.
content	object	Content of the recommendation describing recommended changes to resources. (id: GoogleCloudRecommenderV1RecommendationContent)
description	string	Free-form human readable summary in English. The maximum length is 500 characters.
etag	string	Fingerprint of the Recommendation. Provides optimistic locking when updating states.
lastRefreshTime	string (google-datetime)	Last time this recommendation was refreshed by the system that created it in the first place.
primaryImpact	object	The primary impact that this recommendation can have while trying to optimize for one category. (id: GoogleCloudRecommenderV1Impact)
priority	string	Recommendation's priority.
recommenderSubtype	string	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"
stateInfo	object	Information for state. Contains state and metadata. (id: GoogleCloudRecommenderV1RecommendationStateInfo)
targetResources	array	Fully qualified resource names that this recommendation is targeting.
xorGroupId	string	Corresponds to a mutually exclusive group ID within a recommender. A non-empty ID indicates that the recommendation belongs to a mutually exclusive group. This means that only one recommendation within the group is suggested to be applied.

billing_accounts_locations_recommenders_recommendations_list

Successful response

Name	Datatype	Description
name	string	Identifier. Name of recommendation.
additionalImpact	array	Optional set of additional impact that this recommendation may have when trying to optimize for the primary category. These may be positive or negative.
associatedInsights	array	Insights that led to this recommendation.
content	object	Content of the recommendation describing recommended changes to resources. (id: GoogleCloudRecommenderV1RecommendationContent)
description	string	Free-form human readable summary in English. The maximum length is 500 characters.
etag	string	Fingerprint of the Recommendation. Provides optimistic locking when updating states.
lastRefreshTime	string (google-datetime)	Last time this recommendation was refreshed by the system that created it in the first place.
primaryImpact	object	The primary impact that this recommendation can have while trying to optimize for one category. (id: GoogleCloudRecommenderV1Impact)
priority	string	Recommendation's priority.
recommenderSubtype	string	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"
stateInfo	object	Information for state. Contains state and metadata. (id: GoogleCloudRecommenderV1RecommendationStateInfo)
targetResources	array	Fully qualified resource names that this recommendation is targeting.
xorGroupId	string	Corresponds to a mutually exclusive group ID within a recommender. A non-empty ID indicates that the recommendation belongs to a mutually exclusive group. This means that only one recommendation within the group is suggested to be applied.

folders_locations_recommenders_recommendations_list

Successful response

Name	Datatype	Description
name	string	Identifier. Name of recommendation.
additionalImpact	array	Optional set of additional impact that this recommendation may have when trying to optimize for the primary category. These may be positive or negative.
associatedInsights	array	Insights that led to this recommendation.
content	object	Content of the recommendation describing recommended changes to resources. (id: GoogleCloudRecommenderV1RecommendationContent)
description	string	Free-form human readable summary in English. The maximum length is 500 characters.
etag	string	Fingerprint of the Recommendation. Provides optimistic locking when updating states.
lastRefreshTime	string (google-datetime)	Last time this recommendation was refreshed by the system that created it in the first place.
primaryImpact	object	The primary impact that this recommendation can have while trying to optimize for one category. (id: GoogleCloudRecommenderV1Impact)
priority	string	Recommendation's priority.
recommenderSubtype	string	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"
stateInfo	object	Information for state. Contains state and metadata. (id: GoogleCloudRecommenderV1RecommendationStateInfo)
targetResources	array	Fully qualified resource names that this recommendation is targeting.
xorGroupId	string	Corresponds to a mutually exclusive group ID within a recommender. A non-empty ID indicates that the recommendation belongs to a mutually exclusive group. This means that only one recommendation within the group is suggested to be applied.

organizations_locations_recommenders_recommendations_list

Successful response

Name	Datatype	Description
name	string	Identifier. Name of recommendation.
additionalImpact	array	Optional set of additional impact that this recommendation may have when trying to optimize for the primary category. These may be positive or negative.
associatedInsights	array	Insights that led to this recommendation.
content	object	Content of the recommendation describing recommended changes to resources. (id: GoogleCloudRecommenderV1RecommendationContent)
description	string	Free-form human readable summary in English. The maximum length is 500 characters.
etag	string	Fingerprint of the Recommendation. Provides optimistic locking when updating states.
lastRefreshTime	string (google-datetime)	Last time this recommendation was refreshed by the system that created it in the first place.
primaryImpact	object	The primary impact that this recommendation can have while trying to optimize for one category. (id: GoogleCloudRecommenderV1Impact)
priority	string	Recommendation's priority.
recommenderSubtype	string	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"
stateInfo	object	Information for state. Contains state and metadata. (id: GoogleCloudRecommenderV1RecommendationStateInfo)
targetResources	array	Fully qualified resource names that this recommendation is targeting.
xorGroupId	string	Corresponds to a mutually exclusive group ID within a recommender. A non-empty ID indicates that the recommendation belongs to a mutually exclusive group. This means that only one recommendation within the group is suggested to be applied.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
projects_locations_recommenders_recommendations_get	select	projectsId, locationsId, recommendersId, recommendationsId		Gets the requested recommendation. Requires the recommender.*.get IAM permission for the specified recommender.
billing_accounts_locations_recommenders_recommendations_get	select	billingAccountsId, locationsId, recommendersId, recommendationsId		Gets the requested recommendation. Requires the recommender.*.get IAM permission for the specified recommender.
folders_locations_recommenders_recommendations_get	select	foldersId, locationsId, recommendersId, recommendationsId		Gets the requested recommendation. Requires the recommender.*.get IAM permission for the specified recommender.
organizations_locations_recommenders_recommendations_get	select	organizationsId, locationsId, recommendersId, recommendationsId		Gets the requested recommendation. Requires the recommender.*.get IAM permission for the specified recommender.
projects_locations_recommenders_recommendations_list	select	projectsId, locationsId, recommendersId	pageSize, pageToken, filter	Lists recommendations for the specified Cloud Resource. Requires the recommender.*.list IAM permission for the specified recommender.
billing_accounts_locations_recommenders_recommendations_list	select	billingAccountsId, locationsId, recommendersId	pageSize, pageToken, filter	Lists recommendations for the specified Cloud Resource. Requires the recommender.*.list IAM permission for the specified recommender.
folders_locations_recommenders_recommendations_list	select	foldersId, locationsId, recommendersId	pageSize, pageToken, filter	Lists recommendations for the specified Cloud Resource. Requires the recommender.*.list IAM permission for the specified recommender.
organizations_locations_recommenders_recommendations_list	select	organizationsId, locationsId, recommendersId	pageSize, pageToken, filter	Lists recommendations for the specified Cloud Resource. Requires the recommender.*.list IAM permission for the specified recommender.
projects_locations_recommenders_recommendations_mark_dismissed	exec	projectsId, locationsId, recommendersId, recommendationsId		Mark the Recommendation State as Dismissed. Users can use this method to indicate to the Recommender API that an ACTIVE recommendation has to be marked back as DISMISSED. MarkRecommendationDismissed can be applied to recommendations in ACTIVE state. Requires the recommender.*.update IAM permission for the specified recommender.
projects_locations_recommenders_recommendations_mark_claimed	exec	projectsId, locationsId, recommendersId, recommendationsId		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.
projects_locations_recommenders_recommendations_mark_succeeded	exec	projectsId, locationsId, recommendersId, recommendationsId		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.
projects_locations_recommenders_recommendations_mark_failed	exec	projectsId, locationsId, recommendersId, recommendationsId		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.
billing_accounts_locations_recommenders_recommendations_mark_dismissed	exec	billingAccountsId, locationsId, recommendersId, recommendationsId		Mark the Recommendation State as Dismissed. Users can use this method to indicate to the Recommender API that an ACTIVE recommendation has to be marked back as DISMISSED. MarkRecommendationDismissed can be applied to recommendations in ACTIVE state. Requires the recommender.*.update IAM permission for the specified recommender.
billing_accounts_locations_recommenders_recommendations_mark_claimed	exec	billingAccountsId, locationsId, recommendersId, recommendationsId		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.
billing_accounts_locations_recommenders_recommendations_mark_succeeded	exec	billingAccountsId, locationsId, recommendersId, recommendationsId		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.
billing_accounts_locations_recommenders_recommendations_mark_failed	exec	billingAccountsId, locationsId, recommendersId, recommendationsId		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.
folders_locations_recommenders_recommendations_mark_dismissed	exec	foldersId, locationsId, recommendersId, recommendationsId		Mark the Recommendation State as Dismissed. Users can use this method to indicate to the Recommender API that an ACTIVE recommendation has to be marked back as DISMISSED. MarkRecommendationDismissed can be applied to recommendations in ACTIVE state. Requires the recommender.*.update IAM permission for the specified recommender.
folders_locations_recommenders_recommendations_mark_claimed	exec	foldersId, locationsId, recommendersId, recommendationsId		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.
folders_locations_recommenders_recommendations_mark_succeeded	exec	foldersId, locationsId, recommendersId, recommendationsId		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.
folders_locations_recommenders_recommendations_mark_failed	exec	foldersId, locationsId, recommendersId, recommendationsId		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.
organizations_locations_recommenders_recommendations_mark_dismissed	exec	organizationsId, locationsId, recommendersId, recommendationsId		Mark the Recommendation State as Dismissed. Users can use this method to indicate to the Recommender API that an ACTIVE recommendation has to be marked back as DISMISSED. MarkRecommendationDismissed can be applied to recommendations in ACTIVE state. Requires the recommender.*.update IAM permission for the specified recommender.
organizations_locations_recommenders_recommendations_mark_claimed	exec	organizationsId, locationsId, recommendersId, recommendationsId		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.
organizations_locations_recommenders_recommendations_mark_succeeded	exec	organizationsId, locationsId, recommendersId, recommendationsId		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.
organizations_locations_recommenders_recommendations_mark_failed	exec	organizationsId, locationsId, recommendersId, recommendationsId		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.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
billingAccountsId	string
foldersId	string
locationsId	string
organizationsId	string
projectsId	string
recommendationsId	string
recommendersId	string
filter	string
pageSize	integer (int32)
pageToken	string

SELECT examples

projects_locations_recommenders_recommendations_get

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

SELECT
name,
additionalImpact,
associatedInsights,
content,
description,
etag,
lastRefreshTime,
primaryImpact,
priority,
recommenderSubtype,
stateInfo,
targetResources,
xorGroupId
FROM google.recommender.recommendations
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND recommendersId = '{{ recommendersId }}' -- required
AND recommendationsId = '{{ recommendationsId }}' -- required;

billing_accounts_locations_recommenders_recommendations_get

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

SELECT
name,
additionalImpact,
associatedInsights,
content,
description,
etag,
lastRefreshTime,
primaryImpact,
priority,
recommenderSubtype,
stateInfo,
targetResources,
xorGroupId
FROM google.recommender.recommendations
WHERE billingAccountsId = '{{ billingAccountsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND recommendersId = '{{ recommendersId }}' -- required
AND recommendationsId = '{{ recommendationsId }}' -- required;

folders_locations_recommenders_recommendations_get

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

SELECT
name,
additionalImpact,
associatedInsights,
content,
description,
etag,
lastRefreshTime,
primaryImpact,
priority,
recommenderSubtype,
stateInfo,
targetResources,
xorGroupId
FROM google.recommender.recommendations
WHERE foldersId = '{{ foldersId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND recommendersId = '{{ recommendersId }}' -- required
AND recommendationsId = '{{ recommendationsId }}' -- required;

organizations_locations_recommenders_recommendations_get

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

SELECT
name,
additionalImpact,
associatedInsights,
content,
description,
etag,
lastRefreshTime,
primaryImpact,
priority,
recommenderSubtype,
stateInfo,
targetResources,
xorGroupId
FROM google.recommender.recommendations
WHERE organizationsId = '{{ organizationsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND recommendersId = '{{ recommendersId }}' -- required
AND recommendationsId = '{{ recommendationsId }}' -- required;

projects_locations_recommenders_recommendations_list

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

SELECT
name,
additionalImpact,
associatedInsights,
content,
description,
etag,
lastRefreshTime,
primaryImpact,
priority,
recommenderSubtype,
stateInfo,
targetResources,
xorGroupId
FROM google.recommender.recommendations
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND recommendersId = '{{ recommendersId }}' -- required
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}'
AND filter = '{{ filter }}';

billing_accounts_locations_recommenders_recommendations_list

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

SELECT
name,
additionalImpact,
associatedInsights,
content,
description,
etag,
lastRefreshTime,
primaryImpact,
priority,
recommenderSubtype,
stateInfo,
targetResources,
xorGroupId
FROM google.recommender.recommendations
WHERE billingAccountsId = '{{ billingAccountsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND recommendersId = '{{ recommendersId }}' -- required
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}'
AND filter = '{{ filter }}';

folders_locations_recommenders_recommendations_list

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

SELECT
name,
additionalImpact,
associatedInsights,
content,
description,
etag,
lastRefreshTime,
primaryImpact,
priority,
recommenderSubtype,
stateInfo,
targetResources,
xorGroupId
FROM google.recommender.recommendations
WHERE foldersId = '{{ foldersId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND recommendersId = '{{ recommendersId }}' -- required
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}'
AND filter = '{{ filter }}';

organizations_locations_recommenders_recommendations_list

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

SELECT
name,
additionalImpact,
associatedInsights,
content,
description,
etag,
lastRefreshTime,
primaryImpact,
priority,
recommenderSubtype,
stateInfo,
targetResources,
xorGroupId
FROM google.recommender.recommendations
WHERE organizationsId = '{{ organizationsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND recommendersId = '{{ recommendersId }}' -- required
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}'
AND filter = '{{ filter }}';

Lifecycle Methods

projects_locations_recommenders_recommendations_mark_dismissed

Mark the Recommendation State as Dismissed. Users can use this method to indicate to the Recommender API that an ACTIVE recommendation has to be marked back as DISMISSED. MarkRecommendationDismissed can be applied to recommendations in ACTIVE state. Requires the recommender.*.update IAM permission for the specified recommender.

EXEC google.recommender.recommendations.projects_locations_recommenders_recommendations_mark_dismissed 
@projectsId='{{ projectsId }}' --required, 
@locationsId='{{ locationsId }}' --required, 
@recommendersId='{{ recommendersId }}' --required, 
@recommendationsId='{{ recommendationsId }}' --required 
@@json=
'{
"etag": "{{ etag }}"
}';

projects_locations_recommenders_recommendations_mark_claimed

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.

EXEC google.recommender.recommendations.projects_locations_recommenders_recommendations_mark_claimed 
@projectsId='{{ projectsId }}' --required, 
@locationsId='{{ locationsId }}' --required, 
@recommendersId='{{ recommendersId }}' --required, 
@recommendationsId='{{ recommendationsId }}' --required 
@@json=
'{
"stateMetadata": "{{ stateMetadata }}", 
"etag": "{{ etag }}"
}';

projects_locations_recommenders_recommendations_mark_succeeded

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.

EXEC google.recommender.recommendations.projects_locations_recommenders_recommendations_mark_succeeded 
@projectsId='{{ projectsId }}' --required, 
@locationsId='{{ locationsId }}' --required, 
@recommendersId='{{ recommendersId }}' --required, 
@recommendationsId='{{ recommendationsId }}' --required 
@@json=
'{
"stateMetadata": "{{ stateMetadata }}", 
"etag": "{{ etag }}"
}';

projects_locations_recommenders_recommendations_mark_failed

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.

EXEC google.recommender.recommendations.projects_locations_recommenders_recommendations_mark_failed 
@projectsId='{{ projectsId }}' --required, 
@locationsId='{{ locationsId }}' --required, 
@recommendersId='{{ recommendersId }}' --required, 
@recommendationsId='{{ recommendationsId }}' --required 
@@json=
'{
"stateMetadata": "{{ stateMetadata }}", 
"etag": "{{ etag }}"
}';

billing_accounts_locations_recommenders_recommendations_mark_dismissed

Mark the Recommendation State as Dismissed. Users can use this method to indicate to the Recommender API that an ACTIVE recommendation has to be marked back as DISMISSED. MarkRecommendationDismissed can be applied to recommendations in ACTIVE state. Requires the recommender.*.update IAM permission for the specified recommender.

EXEC google.recommender.recommendations.billing_accounts_locations_recommenders_recommendations_mark_dismissed 
@billingAccountsId='{{ billingAccountsId }}' --required, 
@locationsId='{{ locationsId }}' --required, 
@recommendersId='{{ recommendersId }}' --required, 
@recommendationsId='{{ recommendationsId }}' --required 
@@json=
'{
"etag": "{{ etag }}"
}';

billing_accounts_locations_recommenders_recommendations_mark_claimed

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.

EXEC google.recommender.recommendations.billing_accounts_locations_recommenders_recommendations_mark_claimed 
@billingAccountsId='{{ billingAccountsId }}' --required, 
@locationsId='{{ locationsId }}' --required, 
@recommendersId='{{ recommendersId }}' --required, 
@recommendationsId='{{ recommendationsId }}' --required 
@@json=
'{
"stateMetadata": "{{ stateMetadata }}", 
"etag": "{{ etag }}"
}';

billing_accounts_locations_recommenders_recommendations_mark_succeeded

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.

EXEC google.recommender.recommendations.billing_accounts_locations_recommenders_recommendations_mark_succeeded 
@billingAccountsId='{{ billingAccountsId }}' --required, 
@locationsId='{{ locationsId }}' --required, 
@recommendersId='{{ recommendersId }}' --required, 
@recommendationsId='{{ recommendationsId }}' --required 
@@json=
'{
"stateMetadata": "{{ stateMetadata }}", 
"etag": "{{ etag }}"
}';

billing_accounts_locations_recommenders_recommendations_mark_failed

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.

EXEC google.recommender.recommendations.billing_accounts_locations_recommenders_recommendations_mark_failed 
@billingAccountsId='{{ billingAccountsId }}' --required, 
@locationsId='{{ locationsId }}' --required, 
@recommendersId='{{ recommendersId }}' --required, 
@recommendationsId='{{ recommendationsId }}' --required 
@@json=
'{
"stateMetadata": "{{ stateMetadata }}", 
"etag": "{{ etag }}"
}';

folders_locations_recommenders_recommendations_mark_dismissed

Mark the Recommendation State as Dismissed. Users can use this method to indicate to the Recommender API that an ACTIVE recommendation has to be marked back as DISMISSED. MarkRecommendationDismissed can be applied to recommendations in ACTIVE state. Requires the recommender.*.update IAM permission for the specified recommender.

EXEC google.recommender.recommendations.folders_locations_recommenders_recommendations_mark_dismissed 
@foldersId='{{ foldersId }}' --required, 
@locationsId='{{ locationsId }}' --required, 
@recommendersId='{{ recommendersId }}' --required, 
@recommendationsId='{{ recommendationsId }}' --required 
@@json=
'{
"etag": "{{ etag }}"
}';

folders_locations_recommenders_recommendations_mark_claimed

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.

EXEC google.recommender.recommendations.folders_locations_recommenders_recommendations_mark_claimed 
@foldersId='{{ foldersId }}' --required, 
@locationsId='{{ locationsId }}' --required, 
@recommendersId='{{ recommendersId }}' --required, 
@recommendationsId='{{ recommendationsId }}' --required 
@@json=
'{
"stateMetadata": "{{ stateMetadata }}", 
"etag": "{{ etag }}"
}';

folders_locations_recommenders_recommendations_mark_succeeded

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.

EXEC google.recommender.recommendations.folders_locations_recommenders_recommendations_mark_succeeded 
@foldersId='{{ foldersId }}' --required, 
@locationsId='{{ locationsId }}' --required, 
@recommendersId='{{ recommendersId }}' --required, 
@recommendationsId='{{ recommendationsId }}' --required 
@@json=
'{
"stateMetadata": "{{ stateMetadata }}", 
"etag": "{{ etag }}"
}';

folders_locations_recommenders_recommendations_mark_failed

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.

EXEC google.recommender.recommendations.folders_locations_recommenders_recommendations_mark_failed 
@foldersId='{{ foldersId }}' --required, 
@locationsId='{{ locationsId }}' --required, 
@recommendersId='{{ recommendersId }}' --required, 
@recommendationsId='{{ recommendationsId }}' --required 
@@json=
'{
"stateMetadata": "{{ stateMetadata }}", 
"etag": "{{ etag }}"
}';

organizations_locations_recommenders_recommendations_mark_dismissed

Mark the Recommendation State as Dismissed. Users can use this method to indicate to the Recommender API that an ACTIVE recommendation has to be marked back as DISMISSED. MarkRecommendationDismissed can be applied to recommendations in ACTIVE state. Requires the recommender.*.update IAM permission for the specified recommender.

EXEC google.recommender.recommendations.organizations_locations_recommenders_recommendations_mark_dismissed 
@organizationsId='{{ organizationsId }}' --required, 
@locationsId='{{ locationsId }}' --required, 
@recommendersId='{{ recommendersId }}' --required, 
@recommendationsId='{{ recommendationsId }}' --required 
@@json=
'{
"etag": "{{ etag }}"
}';

organizations_locations_recommenders_recommendations_mark_claimed

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.

EXEC google.recommender.recommendations.organizations_locations_recommenders_recommendations_mark_claimed 
@organizationsId='{{ organizationsId }}' --required, 
@locationsId='{{ locationsId }}' --required, 
@recommendersId='{{ recommendersId }}' --required, 
@recommendationsId='{{ recommendationsId }}' --required 
@@json=
'{
"stateMetadata": "{{ stateMetadata }}", 
"etag": "{{ etag }}"
}';

organizations_locations_recommenders_recommendations_mark_succeeded

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.

EXEC google.recommender.recommendations.organizations_locations_recommenders_recommendations_mark_succeeded 
@organizationsId='{{ organizationsId }}' --required, 
@locationsId='{{ locationsId }}' --required, 
@recommendersId='{{ recommendersId }}' --required, 
@recommendationsId='{{ recommendationsId }}' --required 
@@json=
'{
"stateMetadata": "{{ stateMetadata }}", 
"etag": "{{ etag }}"
}';

organizations_locations_recommenders_recommendations_mark_failed

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.

EXEC google.recommender.recommendations.organizations_locations_recommenders_recommendations_mark_failed 
@organizationsId='{{ organizationsId }}' --required, 
@locationsId='{{ locationsId }}' --required, 
@recommendersId='{{ recommendersId }}' --required, 
@recommendationsId='{{ recommendationsId }}' --required 
@@json=
'{
"stateMetadata": "{{ stateMetadata }}", 
"etag": "{{ etag }}"
}';