Compartilhar via

Configurations - Create In Subscription

  • Referência
Serviço:
Advisor
Versão da API:
2023-01-01

Crie/substitua a configuração do Assistente do Azure e exclua todas as configurações de grupos de recursos independentes.

PUT https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Advisor/configurations/default?api-version=2023-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 'default'
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 da solicitação

Nome Tipo Description
properties.digests

DigestConfig[]

Configuração de resumo do Assistente. Válido somente 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 de percentual mínimo para avaliação de utilização de CPU baixa 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

PUT https://management.azure.com/subscriptions/subscriptionId/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 de exemplo

Código de status:
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

Nome Description
ArmErrorResponse
ARMErrorResponseBody

Corpo da resposta de erro do 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 Assistente.
ConfigurationName

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

Limite de percentual mínimo para avaliação de utilização de CPU baixa 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

Nome Tipo Description
error

ARMErrorResponseBody

Corpo da resposta de erro do ARM.

ARMErrorResponseBody

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

Category

Categorias para as quais enviar resumo. Se as categorias não forem fornecidas, o resumo será enviado para todas as categorias.

Nome Tipo Description
Cost

string

HighAvailability

string

OperationalExcellence

string

Performance

string

Security

string

ConfigData

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

Nome Tipo Description
id

string

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 somente 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 de percentual mínimo para avaliação de utilização de CPU baixa do Assistente. Válido somente para assinaturas. Valores válidos: 5 (padrão), 10, 15 ou 20.
systemData

systemData

Os metadados do Azure Resource Manager que contêm as informações createdBy e modifiedBy.
type

string

Tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

ConfigurationName

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

Nome Tipo Description
default

string

CpuThreshold

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

Nome Tipo Description
10

string

15

string

20

string

5

string

createdByType

O tipo de identidade que criou o recurso.

Nome Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

DigestConfig

Entidade de configuração do Advisor Digest

Nome Tipo Description
actionGroupResourceId

string

ID de recurso do grupo de ações usada pelo resumo.
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

Frequência que o resumo será disparado, em dias. O valor deve estar entre 7 e 30 dias, inclusive.
language

string

Linguagem para o corpo do conteúdo do resumo. O valor deve ser o código ISO 639-1 para um dos idiomas portal do Azure com suporte. 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

Estado da configuração de resumo.

Nome Tipo Description
Active

string

Disabled

string

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.

Nome Tipo Description
14

string

21

string

30

string

60

string

7

string

90

string

systemData

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

Nome Tipo Description
createdAt

string

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

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.