Configurations - Create In Resource Group

Serviço:: Advisor

Versão da API:: 2025-01-01

Criar/substituir a configuração do Assistente do Azure.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Advisor/configurations/default?api-version=2025-01-01

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
configurationName	path	True	ConfigurationName	Nome da configuração do Assistente. O valor deve ser 'padrão'
resourceGroup	path	True	string	O nome do grupo de recursos do Azure.
subscriptionId	path	True	string	A ID da assinatura do Azure.
api-version	query	True	string	A versão da API a ser usada com a solicitação do cliente.

Corpo da solicitação

Nome	Tipo	Description
properties.digests	DigestConfig[]	Configuração de resumo do Assistente. Válido apenas para assinaturas
properties.duration	Duration	Duração mínima para avaliação de baixa utilização da CPU do Assistente. Válido somente para assinaturas. Valores válidos: 7 (padrão), 14, 21, 30, 60 ou 90.
properties.exclude	boolean	Exclua o recurso das avaliações do Assistente. Valores válidos: False (padrão) ou True.
properties.lowCpuThreshold	CpuThreshold	Limite mínimo de porcentagem para avaliação de baixa utilização da CPU do Assistente. Válido somente para assinaturas. Valores válidos: 5 (padrão), 10, 15 ou 20.

Respostas

Nome	Tipo	Description
200 OK	ConfigData	Configuração criada/substituída com êxito.
Other Status Codes	ArmErrorResponse	Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

PutConfigurations

Solicitação de exemplo

HTTP

PUT https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup/providers/Microsoft.Advisor/configurations/default?api-version=2025-01-01

{
  "properties": {
    "lowCpuThreshold": "5",
    "duration": "7",
    "exclude": true,
    "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"
      }
    ]
  }
}

Resposta de exemplo

Código de status:: 200

{
  "id": "/subscriptions/58c3f667-7a62-4bfd-a658-846493e9a493/resourceGroups/resourceGroup/providers/Microsoft.Advisor/configurations/default",
  "type": "Microsoft.Advisor/configurations",
  "name": "default",
  "properties": {
    "lowCpuThreshold": "5",
    "duration": "7",
    "exclude": true,
    "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"
      }
    ]
  }
}

Definições

Nome	Description
ArmErrorResponse
ARMErrorResponseBody	Corpo da resposta de erro do ARM.
Category	Categorias para as qual enviar resumo. Se as categorias não forem fornecidas, o resumo será enviado para todas as categorias.
ConfigData	A estrutura de dados de configuração do Assistente.
ConfigurationName	Nome da configuração do Assistente. O valor deve ser 'padrão'
CpuThreshold	Limite mínimo de porcentagem para avaliação de baixa utilização da CPU do Assistente. Válido somente para assinaturas. Valores válidos: 5 (padrão), 10, 15 ou 20.
createdByType	O tipo de identidade que criou o recurso.
DigestConfig	Entidade de configuração do Advisor Digest
DigestConfigState	Estado da configuração de resumo.
Duration	Duração mínima para avaliação de baixa utilização da CPU do Assistente. Válido somente para assinaturas. Valores válidos: 7 (padrão), 14, 21, 30, 60 ou 90.
systemData	Metadados relativos à criação e última modificação do recurso.

ArmErrorResponse

Objeto

Nome	Tipo	Description
error	ARMErrorResponseBody	Corpo da resposta de erro do ARM.

ARMErrorResponseBody

Objeto

Corpo da resposta de erro do ARM.

Nome	Tipo	Description
code	string	Obtém ou define a cadeia de caracteres que pode ser usada para identificar o erro programaticamente.
message	string	Obtém ou define a cadeia de caracteres que descreve o erro em detalhes e fornece informações de depuração.

Valor	Description
HighAvailability
Security
Performance
Cost
OperationalExcellence

ConfigData

Objeto

A estrutura de dados de configuração do Assistente.

Nome	Tipo	Description
id	string (arm-id)	ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	O nome do recurso
properties.digests	DigestConfig[]	Configuração de resumo do Assistente. Válido apenas para assinaturas
properties.duration	Duration	Duração mínima para avaliação de baixa utilização da CPU do Assistente. Válido somente para assinaturas. Valores válidos: 7 (padrão), 14, 21, 30, 60 ou 90.
properties.exclude	boolean	Exclua o recurso das avaliações do Assistente. Valores válidos: False (padrão) ou True.
properties.lowCpuThreshold	CpuThreshold	Limite mínimo de porcentagem para avaliação de baixa utilização da CPU do Assistente. Válido somente para assinaturas. Valores válidos: 5 (padrão), 10, 15 ou 20.
systemData	systemData	Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

ConfigurationName

Enumeração

Nome da configuração do Assistente. O valor deve ser 'padrão'

Valor	Description
default

CpuThreshold

Enumeração

Limite mínimo de porcentagem para avaliação de baixa utilização da CPU do Assistente. Válido somente para assinaturas. Valores válidos: 5 (padrão), 10, 15 ou 20.

Valor	Description
5
10
15
20

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
User
Application
ManagedIdentity
Key

DigestConfig

Objeto

Entidade de configuração do Advisor Digest

Nome	Tipo	Description
actionGroupResourceId	string	ID de recurso do grupo de ações usada pelo digest.
categories	Category[]	Categorias para as qual enviar resumo. Se as categorias não forem fornecidas, o resumo será enviado para todas as categorias.
frequency	integer (int32)	A frequência que o resumo será disparada, em dias. O valor deve estar entre 7 e 30 dias, inclusive.
language	string	Linguagem para o corpo do conteúdo de resumo. O valor deve ser código ISO 639-1 para um dos idiomas compatíveis com o portal do Azure. Caso contrário, ele será convertido em um. O valor padrão é inglês (en).
name	string	Nome da configuração de resumo. O valor não diferencia maiúsculas de minúsculas e deve ser exclusivo em uma assinatura.
state	DigestConfigState	Estado da configuração de resumo.

DigestConfigState

Enumeração

Estado da configuração de resumo.

Valor	Description
Active
Disabled

Duration

Enumeração

Duração mínima para avaliação de baixa utilização da CPU do Assistente. Válido somente para assinaturas. Valores válidos: 7 (padrão), 14, 21, 30, 60 ou 90.

Valor	Description
7
14
21
30
60
90

systemData

Objeto

Metadados relativos à criação e última modificação do recurso.

Nome	Tipo	Description
createdAt	string (date-time)	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

Configurations - Create In Resource Group

Parâmetros de URI

Corpo da solicitação

Respostas

Segurança

azure_auth

Escopos

Exemplos

PutConfigurations

Solicitação de exemplo

Resposta de exemplo

Definições

ArmErrorResponse

ARMErrorResponseBody

Category

ConfigData

ConfigurationName

CpuThreshold

createdByType

DigestConfig

DigestConfigState

Duration

systemData