ComputeOptimizer / Client / get_recommendation_preferences

get_recommendation_preferences#

ComputeOptimizer.Client.get_recommendation_preferences(**kwargs)#

Returns existing recommendation preferences, such as enhanced infrastructure metrics.

Use the scope parameter to specify which preferences to return. You can specify to return preferences for an organization, a specific account ID, or a specific EC2 instance or Auto Scaling group Amazon Resource Name (ARN).

For more information, see Activating enhanced infrastructure metrics in the Compute Optimizer User Guide.

Request Syntax

response = client.get_recommendation_preferences(
    resourceType='Ec2Instance'|'AutoScalingGroup'|'EbsVolume'|'LambdaFunction'|'NotApplicable'|'EcsService'|'License',
    scope={
        'name': 'Organization'|'AccountId'|'ResourceArn',
        'value': 'string'
    },
    nextToken='string',
    maxResults=123
)

Parameters:

resourceType (string) –
[REQUIRED]

The target resource type of the recommendation preference for which to return preferences.

The Ec2Instance option encompasses standalone instances and instances that are part of Auto Scaling groups. The AutoScalingGroup option encompasses only instances that are part of an Auto Scaling group.

Note
The valid values for this parameter are Ec2Instance and AutoScalingGroup.
scope (dict) –
An object that describes the scope of the recommendation preference to return.

You can return recommendation preferences that are created at the organization level (for management accounts of an organization only), account level, and resource level. For more information, see Activating enhanced infrastructure metrics in the Compute Optimizer User Guide.
- name (string) –
  
  The name of the scope.
  
  The following scopes are possible:
  - Organization - Specifies that the recommendation preference applies at the organization level, for all member accounts of an organization.
  - AccountId - Specifies that the recommendation preference applies at the account level, for all resources of a given resource type in an account.
  - ResourceArn - Specifies that the recommendation preference applies at the individual resource level.
- value (string) –
  
  The value of the scope.
  
  If you specified the name of the scope as:
  - Organization - The value must be ALL_ACCOUNTS.
  - AccountId - The value must be a 12-digit Amazon Web Services account ID.
  - ResourceArn - The value must be the Amazon Resource Name (ARN) of an EC2 instance or an Auto Scaling group.
  Only EC2 instance and Auto Scaling group ARNs are currently supported.
nextToken (string) – The token to advance to the next page of recommendation preferences.
maxResults (integer) –
The maximum number of recommendation preferences to return with a single request.

To retrieve the remaining results, make another request with the returned nextToken value.

Return type:

dict

Returns:

Response Syntax

{
    'nextToken': 'string',
    'recommendationPreferencesDetails': [
        {
            'scope': {
                'name': 'Organization'|'AccountId'|'ResourceArn',
                'value': 'string'
            },
            'resourceType': 'Ec2Instance'|'AutoScalingGroup'|'EbsVolume'|'LambdaFunction'|'NotApplicable'|'EcsService'|'License',
            'enhancedInfrastructureMetrics': 'Active'|'Inactive',
            'inferredWorkloadTypes': 'Active'|'Inactive',
            'externalMetricsPreference': {
                'source': 'Datadog'|'Dynatrace'|'NewRelic'|'Instana'
            }
        },
    ]
}

Response Structure

(dict) –
- nextToken (string) –
  
  The token to use to advance to the next page of recommendation preferences.
  
  This value is null when there are no more pages of recommendation preferences to return.
- recommendationPreferencesDetails (list) –
  
  An array of objects that describe recommendation preferences.
  - (dict) –
    
    Describes a recommendation preference.
    - scope (dict) –
      
      An object that describes the scope of the recommendation preference.
      
      Recommendation preferences can be created at the organization level (for management accounts of an organization only), account level, and resource level. For more information, see Activating enhanced infrastructure metrics in the Compute Optimizer User Guide.
      - name (string) –
        
        The name of the scope.
        
        The following scopes are possible:
        
        Organization - Specifies that the recommendation preference applies at the organization level, for all member accounts of an organization.
        
        AccountId - Specifies that the recommendation preference applies at the account level, for all resources of a given resource type in an account.
        
        ResourceArn - Specifies that the recommendation preference applies at the individual resource level.
      - value (string) –
        
        The value of the scope.
        
        If you specified the name of the scope as:
        
        Organization - The value must be ALL_ACCOUNTS.
        
        AccountId - The value must be a 12-digit Amazon Web Services account ID.
        
        ResourceArn - The value must be the Amazon Resource Name (ARN) of an EC2 instance or an Auto Scaling group.
        
        Only EC2 instance and Auto Scaling group ARNs are currently supported.
    - resourceType (string) –
      
      The target resource type of the recommendation preference to create.
      
      The Ec2Instance option encompasses standalone instances and instances that are part of Auto Scaling groups. The AutoScalingGroup option encompasses only instances that are part of an Auto Scaling group.
    - enhancedInfrastructureMetrics (string) –
      
      The status of the enhanced infrastructure metrics recommendation preference.
      
      When the recommendations page is refreshed, a status of Active confirms that the preference is applied to the recommendations, and a status of Inactive confirms that the preference isn’t yet applied to recommendations.
      
      For more information, see Enhanced infrastructure metrics in the Compute Optimizer User Guide.
    - inferredWorkloadTypes (string) –
      
      The status of the inferred workload types recommendation preference.
      
      When the recommendations page is refreshed, a status of Active confirms that the preference is applied to the recommendations, and a status of Inactive confirms that the preference isn’t yet applied to recommendations.
    - externalMetricsPreference (dict) –
      
      An object that describes the external metrics recommendation preference.
      
      If the preference is applied in the latest recommendation refresh, an object with a valid source value appears in the response. If the preference isn’t applied to the recommendations already, then this object doesn’t appear in the response.
      - source (string) –
        
        Contains the source options for external metrics preferences.

Exceptions

ComputeOptimizer.Client.exceptions.OptInRequiredException
ComputeOptimizer.Client.exceptions.InternalServerException
ComputeOptimizer.Client.exceptions.ServiceUnavailableException
ComputeOptimizer.Client.exceptions.AccessDeniedException
ComputeOptimizer.Client.exceptions.InvalidParameterValueException
ComputeOptimizer.Client.exceptions.ResourceNotFoundException
ComputeOptimizer.Client.exceptions.MissingAuthenticationToken
ComputeOptimizer.Client.exceptions.ThrottlingException