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 elimine também todas as configurações de grupos de recursos contidos.

PUT https://management.azure.com/subscriptions/{subscriptionId}/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 de configuração do assistente. O valor tem de ser "predefinido"
subscriptionId	path	True	string	O ID da subscrição do Azure.
api-version	query	True	string	A versão da API a utilizar com o pedido de cliente.

Corpo do Pedido

Name	Tipo	Description
properties.digests	DigestConfig[]	Configuração da digestão do assistente. Válido apenas para subscrições
properties.duration	Duration	Duração mínima da avaliação de utilização baixa da CPU do Assistente. Válido apenas para subscrições. Valores válidos: 7 (predefinição), 14, 21, 30, 60 ou 90.
properties.exclude	boolean	Exclua o recurso das avaliações do Assistente. Valores válidos: Falso (predefinição) ou Verdadeiro.
properties.lowCpuThreshold	CpuThreshold	Limiar de percentagem mínimo para avaliação de utilização baixa da CPU do Assistente. Válido apenas para subscrições. Valores válidos: 5 (predefiniçã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 que descreve a razão pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

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

Âmbitos

Name	Description
user_impersonation	representar a sua conta de utilizador

Exemplos

PutConfigurations

Pedido de amostra

HTTP

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 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 a erros 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 de configuração do assistente. O valor tem de ser "predefinido"
CpuThreshold	Limiar de percentagem mínimo para avaliação de utilização baixa da CPU do Assistente. Válido apenas para subscrições. Valores válidos: 5 (predefiniçã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 da digestão.
Duration	Duração mínima da avaliação de utilização baixa da CPU do Assistente. Válido apenas para subscrições. Valores válidos: 7 (predefinição), 14, 21, 30, 60 ou 90.
systemData	Metadados relativos à criação e última modificação do recurso.

ArmErrorResponse

Name	Tipo	Description
error	ARMErrorResponseBody	Corpo da resposta a erros do ARM.

ARMErrorResponseBody

Corpo da resposta a erros do ARM.

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

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

ConfigData

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

Name	Tipo	Description
id	string	ID de recurso completamente 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 da digestão do assistente. Válido apenas para subscrições
properties.duration	Duration	Duração mínima da avaliação de utilização baixa da CPU do Assistente. Válido apenas para subscrições. Valores válidos: 7 (predefinição), 14, 21, 30, 60 ou 90.
properties.exclude	boolean	Exclua o recurso das avaliações do Assistente. Valores válidos: Falso (predefinição) ou Verdadeiro.
properties.lowCpuThreshold	CpuThreshold	Limiar de percentagem mínimo para avaliação de utilização baixa da CPU do Assistente. Válido apenas para subscrições. Valores válidos: 5 (predefinição), 10, 15 ou 20.
systemData	systemData	O Azure Resource Manager metadados que contêm informações createdBy e modifiedBy.
type	string	O tipo de recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

ConfigurationName

Nome de configuração do assistente. O valor tem de ser "predefinido"

Name	Tipo	Description
default	string

CpuThreshold

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

Name	Tipo	Description
10	string
15	string
20	string
5	string

createdByType

O tipo de identidade que criou o recurso.

Name	Tipo	Description
Application	string
Key	string
ManagedIdentity	string
User	string

DigestConfig

Entidade de configuração do Advisor Digest

Name	Tipo	Description
actionGroupResourceId	string	ID de recurso do grupo de ações utilizado pela digestão.
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	A frequência que o resumo será acionada em dias. O valor tem de estar entre 7 e 30 dias, inclusive.
language	string	Idioma para o corpo do conteúdo de resumo. O valor tem de ser código ISO 639-1 para um dos idiomas suportados portal do Azure. Caso contrário, será convertido num só. O valor predefinido é inglês (en).
name	string	Nome da configuração da digestão. O valor não é sensível a maiúsculas e minúsculas e tem de ser exclusivo numa subscrição.
state	DigestConfigState	Estado da configuração da digestão.

DigestConfigState

Estado da configuração da digestão.

Name	Tipo	Description
Active	string
Disabled	string

Duration

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

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

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

Partilhar via