Microsoft.Orçamentos de consumo 2018-03-31

• Últimas
• 2024-08-01
• 2023-11-01
• 2023-05-01
• 2023-03-01
• 2022-09-01
• 2021-10-01
• 2021-05-01
• 2019-11-01
• 2019-10-01
• 2019-06-01
• 2019-05-01
• 2019-05-01-preview
• 2019-04-01-preview
• 2019-01-01
• 2018-10-01
• 2018-08-31
• 2018-06-30
• 2018-03-31
• 2018-01-31
• 2017-12-30-preview

Definição de recursos do bíceps

O tipo de recurso de orçamentos pode ser implantado com operações que visam:

• de Subscrição - Consulte comandos de implementação de subscrição* Grupos de recursos - Consulte comandos de implementação de grupos de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.Consumption/budgets, adicione o seguinte Bicep ao seu modelo.

resource symbolicname 'Microsoft.Consumption/budgets@2018-03-31' = {
  eTag: 'string'
  name: 'string'
  properties: {
    amount: int
    category: 'string'
    filters: {
      meters: [
        'string'
      ]
      resourceGroups: [
        'string'
      ]
      resources: [
        'string'
      ]
      tags: {
        {customized property}: [
          'string'
        ]
      }
    }
    notifications: {
      {customized property}: {
        contactEmails: [
          'string'
        ]
        contactGroups: [
          'string'
        ]
        contactRoles: [
          'string'
        ]
        enabled: bool
        operator: 'string'
        threshold: int
      }
    }
    timeGrain: 'string'
    timePeriod: {
      endDate: 'string'
      startDate: 'string'
    }
  }
}

Valores de propriedade

BudgetProperties

Designação	Descrição	Valor
Montante	O valor total do custo a acompanhar com o orçamento	int (obrigatório)
categoria	A categoria do orçamento, se o orçamento controla o custo ou o uso.	'Custo' 'Uso' (obrigatório)
filtros	Pode ser usado para filtrar orçamentos por grupo de recursos, recurso ou medidor.	Filtros
Notificações	Dicionário de notificações associadas ao orçamento. O orçamento pode ter até cinco notificações.	BudgetPropertiesNotifications
timeGrain	O tempo coberto por um orçamento. O rastreamento do valor será redefinido com base no grão de tempo.	'Anualmente' 'Mensal' «Trimestral» (obrigatório)
tempoPeríodo	Tem data de início e fim do orçamento. A data de início deve ser a primeira do mês e deve ser inferior à data de fim. A data de início do orçamento deve ser em ou após 1º de junho de 2017. A data de início futuro não deve ser superior a três meses. A data de início anterior deve ser selecionada dentro do período de tempo. Não há restrições quanto à data de término.	BudgetTimePeriod (obrigatório)

BudgetPropertiesNotifications

Designação	Descrição	Valor

BudgetTimePeriod

Designação	Descrição	Valor
Data de fim	A data final do orçamento. Se não for fornecido, o padrão será de 10 anos a partir da data de início.	string
data de início	A data de início do orçamento.	string (obrigatório)

Filtros

Designação	Descrição	Valor
medidores	A lista de filtros em medidores (GUID), obrigatória para orçamentos da categoria de uso.	string Restrições: Comprimento mínimo = 36 Comprimento máximo = 36 Padrão = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$[]
resourceGroups	A lista de filtros em grupos de recursos, permitida apenas no nível de assinatura.	string[]
Recursos	A lista de filtros em recursos.	string[]
Etiquetas	O dicionário de filtros em tags.	FiltrosTags

FiltrosTags

Designação	Descrição	Valor

Microsoft.Consumo/orçamentos

Designação	Descrição	Valor
eTag	eTag do recurso. Para lidar com o cenário de atualização simultânea, esse campo será usado para determinar se o usuário está atualizando a versão mais recente ou não.	string
Designação	O nome do recurso	string (obrigatório)
propriedades	As propriedades do orçamento.	BudgetProperties

Notificação

Designação	Descrição	Valor
contatoE-mails	Endereços de e-mail para enviar a notificação de orçamento quando o limite for excedido.	string[] (obrigatório)
contatoGrupos	Grupos de ação para enviar a notificação de orçamento quando o limite for excedido.	string[]
contatoFunções	Funções de contato para enviar a notificação de orçamento quando o limite for excedido.	string[]
ativado	A notificação está habilitada ou não.	bool (obrigatório)
Operador	O operador de comparação.	'Igual' 'MaiorQue' 'GreaterThanOrEqualTo' (obrigatório)
limiar	Valor limite associado a uma notificação. A notificação é enviada quando o custo excede o limite. É sempre percentual e tem que estar entre 0 e 1000.	int (obrigatório)

Exemplos de início rápido

Os exemplos de início rápido a seguir implantam esse tipo de recurso.

Arquivo Bicep	Descrição
Criar um orçamento	Este modelo mostra como criar um orçamento sob uma assinatura.
Criar um orçamento com de filtro	Este modelo mostra como criar um orçamento sob uma assinatura.
Criar um orçamento simples	Este modelo mostra como criar um orçamento sob uma assinatura.

Definição de recurso de modelo ARM

O tipo de recurso de orçamentos pode ser implantado com operações que visam:

• de Subscrição - Consulte comandos de implementação de subscrição* Grupos de recursos - Consulte comandos de implementação de grupos de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.Consumption/budgets, adicione o seguinte JSON ao seu modelo.

{
  "type": "Microsoft.Consumption/budgets",
  "apiVersion": "2018-03-31",
  "name": "string",
  "eTag": "string",
  "properties": {
    "amount": "int",
    "category": "string",
    "filters": {
      "meters": [ "string" ],
      "resourceGroups": [ "string" ],
      "resources": [ "string" ],
      "tags": {
        "{customized property}": [ "string" ]
      }
    },
    "notifications": {
      "{customized property}": {
        "contactEmails": [ "string" ],
        "contactGroups": [ "string" ],
        "contactRoles": [ "string" ],
        "enabled": "bool",
        "operator": "string",
        "threshold": "int"
      }
    },
    "timeGrain": "string",
    "timePeriod": {
      "endDate": "string",
      "startDate": "string"
    }
  }
}

Valores de propriedade

BudgetProperties

Designação	Descrição	Valor
Montante	O valor total do custo a acompanhar com o orçamento	int (obrigatório)
categoria	A categoria do orçamento, se o orçamento controla o custo ou o uso.	'Custo' 'Uso' (obrigatório)
filtros	Pode ser usado para filtrar orçamentos por grupo de recursos, recurso ou medidor.	Filtros
Notificações	Dicionário de notificações associadas ao orçamento. O orçamento pode ter até cinco notificações.	BudgetPropertiesNotifications
timeGrain	O tempo coberto por um orçamento. O rastreamento do valor será redefinido com base no grão de tempo.	'Anualmente' 'Mensal' «Trimestral» (obrigatório)
tempoPeríodo	Tem data de início e fim do orçamento. A data de início deve ser a primeira do mês e deve ser inferior à data de fim. A data de início do orçamento deve ser em ou após 1º de junho de 2017. A data de início futuro não deve ser superior a três meses. A data de início anterior deve ser selecionada dentro do período de tempo. Não há restrições quanto à data de término.	BudgetTimePeriod (obrigatório)

BudgetPropertiesNotifications

Designação	Descrição	Valor

BudgetTimePeriod

Designação	Descrição	Valor
Data de fim	A data final do orçamento. Se não for fornecido, o padrão será de 10 anos a partir da data de início.	string
data de início	A data de início do orçamento.	string (obrigatório)

Filtros

Designação	Descrição	Valor
medidores	A lista de filtros em medidores (GUID), obrigatória para orçamentos da categoria de uso.	string Restrições: Comprimento mínimo = 36 Comprimento máximo = 36 Padrão = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$[]
resourceGroups	A lista de filtros em grupos de recursos, permitida apenas no nível de assinatura.	string[]
Recursos	A lista de filtros em recursos.	string[]
Etiquetas	O dicionário de filtros em tags.	FiltrosTags

FiltrosTags

Designação	Descrição	Valor

Microsoft.Consumo/orçamentos

Designação	Descrição	Valor
apiVersion	A versão api	'2018-03-31'
eTag	eTag do recurso. Para lidar com o cenário de atualização simultânea, esse campo será usado para determinar se o usuário está atualizando a versão mais recente ou não.	string
Designação	O nome do recurso	string (obrigatório)
propriedades	As propriedades do orçamento.	BudgetProperties
tipo	O tipo de recurso	'Microsoft.Consumo/orçamentos'

Notificação

Designação	Descrição	Valor
contatoE-mails	Endereços de e-mail para enviar a notificação de orçamento quando o limite for excedido.	string[] (obrigatório)
contatoGrupos	Grupos de ação para enviar a notificação de orçamento quando o limite for excedido.	string[]
contatoFunções	Funções de contato para enviar a notificação de orçamento quando o limite for excedido.	string[]
ativado	A notificação está habilitada ou não.	bool (obrigatório)
Operador	O operador de comparação.	'Igual' 'MaiorQue' 'GreaterThanOrEqualTo' (obrigatório)
limiar	Valor limite associado a uma notificação. A notificação é enviada quando o custo excede o limite. É sempre percentual e tem que estar entre 0 e 1000.	int (obrigatório)

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo	Descrição
Criar um orçamento	Este modelo mostra como criar um orçamento sob uma assinatura.
Criar um orçamento com de filtro	Este modelo mostra como criar um orçamento sob uma assinatura.
Criar um orçamento simples	Este modelo mostra como criar um orçamento sob uma assinatura.

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso de orçamentos pode ser implantado com operações que visam:

• Subscrição* Grupos de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.Consumption/budgets, adicione o seguinte Terraform ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Consumption/budgets@2018-03-31"
  name = "string"
  eTag = "string"
  body = jsonencode({
    properties = {
      amount = int
      category = "string"
      filters = {
        meters = [
          "string"
        ]
        resourceGroups = [
          "string"
        ]
        resources = [
          "string"
        ]
        tags = {
          {customized property} = [
            "string"
          ]
        }
      }
      notifications = {
        {customized property} = {
          contactEmails = [
            "string"
          ]
          contactGroups = [
            "string"
          ]
          contactRoles = [
            "string"
          ]
          enabled = bool
          operator = "string"
          threshold = int
        }
      }
      timeGrain = "string"
      timePeriod = {
        endDate = "string"
        startDate = "string"
      }
    }
  })
}

Valores de propriedade

BudgetProperties

Designação	Descrição	Valor
Montante	O valor total do custo a acompanhar com o orçamento	int (obrigatório)
categoria	A categoria do orçamento, se o orçamento controla o custo ou o uso.	'Custo' 'Uso' (obrigatório)
filtros	Pode ser usado para filtrar orçamentos por grupo de recursos, recurso ou medidor.	Filtros
Notificações	Dicionário de notificações associadas ao orçamento. O orçamento pode ter até cinco notificações.	BudgetPropertiesNotifications
timeGrain	O tempo coberto por um orçamento. O rastreamento do valor será redefinido com base no grão de tempo.	'Anualmente' 'Mensal' «Trimestral» (obrigatório)
tempoPeríodo	Tem data de início e fim do orçamento. A data de início deve ser a primeira do mês e deve ser inferior à data de fim. A data de início do orçamento deve ser em ou após 1º de junho de 2017. A data de início futuro não deve ser superior a três meses. A data de início anterior deve ser selecionada dentro do período de tempo. Não há restrições quanto à data de término.	BudgetTimePeriod (obrigatório)

BudgetPropertiesNotifications

Designação	Descrição	Valor

BudgetTimePeriod

Designação	Descrição	Valor
Data de fim	A data final do orçamento. Se não for fornecido, o padrão será de 10 anos a partir da data de início.	string
data de início	A data de início do orçamento.	string (obrigatório)

Filtros

Designação	Descrição	Valor
medidores	A lista de filtros em medidores (GUID), obrigatória para orçamentos da categoria de uso.	string Restrições: Comprimento mínimo = 36 Comprimento máximo = 36 Padrão = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$[]
resourceGroups	A lista de filtros em grupos de recursos, permitida apenas no nível de assinatura.	string[]
Recursos	A lista de filtros em recursos.	string[]
Etiquetas	O dicionário de filtros em tags.	FiltrosTags

FiltrosTags

Designação	Descrição	Valor

Microsoft.Consumo/orçamentos

Designação	Descrição	Valor
eTag	eTag do recurso. Para lidar com o cenário de atualização simultânea, esse campo será usado para determinar se o usuário está atualizando a versão mais recente ou não.	string
Designação	O nome do recurso	string (obrigatório)
propriedades	As propriedades do orçamento.	BudgetProperties
tipo	O tipo de recurso	"Microsoft.Consumption/budgets@2018-03-31"

Notificação

Designação	Descrição	Valor
contatoE-mails	Endereços de e-mail para enviar a notificação de orçamento quando o limite for excedido.	string[] (obrigatório)
contatoGrupos	Grupos de ação para enviar a notificação de orçamento quando o limite for excedido.	string[]
contatoFunções	Funções de contato para enviar a notificação de orçamento quando o limite for excedido.	string[]
ativado	A notificação está habilitada ou não.	bool (obrigatório)
Operador	O operador de comparação.	'Igual' 'MaiorQue' 'GreaterThanOrEqualTo' (obrigatório)
limiar	Valor limite associado a uma notificação. A notificação é enviada quando o custo excede o limite. É sempre percentual e tem que estar entre 0 e 1000.	int (obrigatório)