Configurations - List By Subscription

Service:

Advisor

API Version:

2023-01-01

Retrieve Azure Advisor configurations and also retrieve configurations of contained resource groups.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Advisor/configurations?api-version=2023-01-01

URI Parameters

Name	In	Required	Type	Description
subscriptionId	path	True	string	The Azure subscription ID.
api-version	query	True	string	The version of the API to be used with the client request.

Responses

Name	Type	Description
200 OK	ConfigurationListResult	OK. Successfully retrieved zero or more configurations.
Other Status Codes	ArmErrorResponse	Error response describing why the operation failed.

Security

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	impersonate your user account

Examples

GetConfigurations

Sample Request

HTTP

GET https://management.azure.com/subscriptions/subscriptionId/providers/Microsoft.Advisor/configurations?api-version=2023-01-01

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup/providers/Microsoft.Advisor/configurations/default",
      "type": "Microsoft.Advisor/configurations",
      "name": "default",
      "properties": {
        "lowCpuThreshold": "5",
        "duration": "7",
        "exclude": false,
        "digests": [
          {
            "name": "digestConfigName",
            "actionGroupResourceId": "/subscriptions/subscriptionId/resourceGroups/resourceGroup/providers/microsoft.insights/actionGroups/actionGroupName",
            "frequency": 30,
            "categories": [
              "HighAvailability",
              "Security",
              "Performance",
              "Cost",
              "OperationalExcellence"
            ],
            "language": "en",
            "state": "Active"
          }
        ]
      }
    }
  ],
  "nextLink": "string"
}

Definitions

Name	Description
ArmErrorResponse
ARMErrorResponseBody	ARM error response body.
Category	Categories to send digest for. If categories are not provided, then digest will be sent for all categories.
ConfigData	The Advisor configuration data structure.
ConfigurationListResult	The list of Advisor configurations.
CpuThreshold	Minimum percentage threshold for Advisor low CPU utilization evaluation. Valid only for subscriptions. Valid values: 5 (default), 10, 15 or 20.
createdByType	The type of identity that created the resource.
DigestConfig	Advisor Digest configuration entity
DigestConfigState	State of digest configuration.
Duration	Minimum duration for Advisor low CPU utilization evaluation. Valid only for subscriptions. Valid values: 7 (default), 14, 21, 30, 60 or 90.
systemData	Metadata pertaining to creation and last modification of the resource.

ArmErrorResponse

Name	Type	Description
error	ARMErrorResponseBody	ARM error response body.

ARMErrorResponseBody

ARM error response body.

Name	Type	Description
code	string	Gets or sets the string that can be used to programmatically identify the error.
message	string	Gets or sets the string that describes the error in detail and provides debugging information.

Category

Categories to send digest for. If categories are not provided, then digest will be sent for all categories.

Name	Type	Description
Cost	string
HighAvailability	string
OperationalExcellence	string
Performance	string
Security	string

ConfigData

The Advisor configuration data structure.

Name	Type	Description
id	string	Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	The name of the resource
properties.digests	DigestConfig[]	Advisor digest configuration. Valid only for subscriptions
properties.duration	Duration	Minimum duration for Advisor low CPU utilization evaluation. Valid only for subscriptions. Valid values: 7 (default), 14, 21, 30, 60 or 90.
properties.exclude	boolean	Exclude the resource from Advisor evaluations. Valid values: False (default) or True.
properties.lowCpuThreshold	CpuThreshold	Minimum percentage threshold for Advisor low CPU utilization evaluation. Valid only for subscriptions. Valid values: 5 (default), 10, 15 or 20.
systemData	systemData	Azure Resource Manager metadata containing createdBy and modifiedBy information.
type	string	The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"

ConfigurationListResult

The list of Advisor configurations.

Name	Type	Description
nextLink	string	The link used to get the next page of configurations.
value	ConfigData[]	The list of configurations.

CpuThreshold

Minimum percentage threshold for Advisor low CPU utilization evaluation. Valid only for subscriptions. Valid values: 5 (default), 10, 15 or 20.

Name	Type	Description
10	string
15	string
20	string
5	string

createdByType

The type of identity that created the resource.

Name	Type	Description
Application	string
Key	string
ManagedIdentity	string
User	string

DigestConfig

Advisor Digest configuration entity

Name	Type	Description
actionGroupResourceId	string	Action group resource id used by digest.
categories	Category[]	Categories to send digest for. If categories are not provided, then digest will be sent for all categories.
frequency	integer	Frequency that digest will be triggered, in days. Value must be between 7 and 30 days inclusive.
language	string	Language for digest content body. Value must be ISO 639-1 code for one of Azure portal supported languages. Otherwise, it will be converted into one. Default value is English (en).
name	string	Name of digest configuration. Value is case-insensitive and must be unique within a subscription.
state	DigestConfigState	State of digest configuration.

DigestConfigState

State of digest configuration.

Name	Type	Description
Active	string
Disabled	string

Duration

Minimum duration for Advisor low CPU utilization evaluation. Valid only for subscriptions. Valid values: 7 (default), 14, 21, 30, 60 or 90.

Name	Type	Description
14	string
21	string
30	string
60	string
7	string
90	string

systemData

Metadata pertaining to creation and last modification of the resource.

Name	Type	Description
createdAt	string	The timestamp of resource creation (UTC).
createdBy	string	The identity that created the resource.
createdByType	createdByType	The type of identity that created the resource.
lastModifiedAt	string	The timestamp of resource last modification (UTC)
lastModifiedBy	string	The identity that last modified the resource.
lastModifiedByType	createdByType	The type of identity that last modified the resource.