Configurations - Create In Resource Group

Referência

Serviço:: Advisor

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

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

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

Parâmetros do URI

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

Corpo do Pedido

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

Respostas

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

Segurança

azure_auth

Fluxo OAuth2 do Azure Ative Directory.

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

Âmbitos

Name	Description
user_impersonation	personificar a sua conta de utilizador

Exemplos

PutConfigurations

Pedido de amostra

HTTP

PUT https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup/providers/Microsoft.Advisor/configurations/default?api-version=2023-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 da amostra

Código de estado:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup/providers/Microsoft.Advisor/configurations/v2/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

Name	Description
ArmErrorResponse
ARMErrorResponseBody	Corpo da resposta de erro ARM.
Category	Categorias para as quais 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 Advisor.
ConfigurationName	Nome da configuração do consultor. O valor deve ser 'padrão'
CpuThreshold	Limite percentual mínimo para avaliação de baixa utilização da CPU do Advisor. Válido apenas para subscrições. 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 de configuração digest.
Duration	Duração mínima para avaliação de baixa utilização da CPU do Advisor. Válido apenas para subscrições. Valores válidos: 7 (padrão), 14, 21, 30, 60 ou 90.
systemData	Metadados referentes à criação e última modificação do recurso.

ArmErrorResponse

Object

Name	Tipo	Description
error	ARMErrorResponseBody	Corpo da resposta de erro ARM.

ARMErrorResponseBody

Object

Corpo da resposta de erro ARM.

Name	Tipo	Description
code	string	Obtém ou define a cadeia de caracteres que pode ser usada para identificar programaticamente o erro.
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
Cost
HighAvailability
OperationalExcellence
Performance
Security

ConfigData

Object

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

Name	Tipo	Description
id	string (arm-id)	ID de recurso totalmente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	O nome do recurso
properties.digests	DigestConfig[]	Configuração do resumo do Advisor. Válido apenas para subscrições
properties.duration	Duration	Duração mínima para avaliação de baixa utilização da CPU do Advisor. Válido apenas para subscrições. Valores válidos: 7 (padrão), 14, 21, 30, 60 ou 90.
properties.exclude	boolean	Exclua o recurso das avaliações do Advisor. Valores válidos: False (padrão) ou True.
properties.lowCpuThreshold	CpuThreshold	Limite percentual mínimo para avaliação de baixa utilização da CPU do Advisor. Válido apenas para subscrições. Valores válidos: 5 (padrão), 10, 15 ou 20.
systemData	systemData	Metadados do Azure Resource Manager contendo 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 consultor. O valor deve ser 'padrão'

Valor	Description
default

CpuThreshold

Enumeração

Limite percentual mínimo para avaliação de baixa utilização da CPU do Advisor. Válido apenas para subscrições. Valores válidos: 5 (padrão), 10, 15 ou 20.

Valor	Description
10
15
20
5

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
Application
Key
ManagedIdentity
User

DigestConfig

Object

Entidade de configuração do Advisor Digest

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

DigestConfigState

Enumeração

Estado de configuração digest.

Valor	Description
Active
Disabled

Duration

Enumeração

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

Valor	Description
14
21
30
60
7
90

systemData

Object

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

Name	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.

Partilhar via

Configurations - Create In Resource Group

Parâmetros do URI

Corpo do Pedido

Respostas

Segurança

azure_auth

Âmbitos

Exemplos

PutConfigurations

Pedido de amostra

Resposta da amostra

Definições

ArmErrorResponse

ARMErrorResponseBody

Category

ConfigData

ConfigurationName

CpuThreshold

createdByType

DigestConfig

DigestConfigState

Duration

systemData

Recursos adicionais