Partilhar via


Settings - Create Or Update By Scope

Crie ou atualize uma configuração dentro do escopo determinado.

PUT https://management.azure.com/{scope}/providers/Microsoft.CostManagement/settings/taginheritance?api-version=2024-08-01

Parâmetros do URI

Name Em Necessário Tipo Description
scope
path True

string

O escopo associado a essa configuração. Isso inclui 'subscriptions/{subscriptionId}' para o escopo da assinatura, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' para o escopo da Conta de Cobrança, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' para o escopo do perfil de cobrança.

type
path True

SettingType

Tipo de configuração.

api-version
query True

string

A versão da API a ser usada para esta operação.

Corpo do Pedido

TagInheritanceSetting

Definição de configuração de herança de tag.

Name Necessário Tipo Description
kind True string:

taginheritance

Especifica o tipo de configurações.

properties

TagInheritanceProperties

As propriedades da configuração de herança de tag.

Respostas

Name Tipo Description
200 OK Setting:

TagInheritanceSetting

Configuração atualizada.

201 Created Setting:

TagInheritanceSetting

Configuração criada.

Other Status Codes

ErrorResponse

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

CreateOrUpdateSettingByScope

Pedido de amostra

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/settings/taginheritance?api-version=2024-08-01

{
  "kind": "taginheritance",
  "properties": {
    "preferContainerTags": false
  }
}

Resposta da amostra

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/settings/taginheritance",
  "name": "taginheritance",
  "type": "Microsoft.CostManagement/Settings",
  "kind": "taginheritance",
  "properties": {
    "preferContainerTags": false
  }
}
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/settings/taginheritance",
  "name": "taginheritance",
  "type": "Microsoft.CostManagement/Settings",
  "kind": "taginheritance",
  "properties": {
    "preferContainerTags": false
  }
}

Definições

Name Description
ErrorDetails

Os detalhes do erro.

ErrorResponse

A resposta de erro indica que o serviço não é capaz de processar a solicitação de entrada. O motivo é fornecido na mensagem de erro.

Algumas respostas de erro:

  • 429 TooManyRequests - A solicitação está limitada. Tente novamente depois de aguardar o tempo especificado no cabeçalho "x-ms-ratelimit-microsoft.consumption-retry-after".

  • 503 ServiçoIndisponível - O serviço está temporariamente indisponível. Tente novamente depois de aguardar o tempo especificado no cabeçalho "Retry-After".

SettingType

Tipo de configuração.

TagInheritanceProperties

As propriedades da configuração de herança de tag.

TagInheritanceSetting

Definição de configuração de herança de tag.

ErrorDetails

Os detalhes do erro.

Name Tipo Description
code

string

Código de erro.

message

string

Mensagem de erro indicando por que a operação falhou.

ErrorResponse

A resposta de erro indica que o serviço não é capaz de processar a solicitação de entrada. O motivo é fornecido na mensagem de erro.

Algumas respostas de erro:

  • 429 TooManyRequests - A solicitação está limitada. Tente novamente depois de aguardar o tempo especificado no cabeçalho "x-ms-ratelimit-microsoft.consumption-retry-after".

  • 503 ServiçoIndisponível - O serviço está temporariamente indisponível. Tente novamente depois de aguardar o tempo especificado no cabeçalho "Retry-After".

Name Tipo Description
error

ErrorDetails

Os detalhes do erro.

SettingType

Tipo de configuração.

Name Tipo Description
taginheritance

string

Esta definição aplica as etiquetas de perfil de faturação, secção de fatura, subscrição e grupo de recursos aos dados de utilização dos recursos subordinados do mês atual.

TagInheritanceProperties

As propriedades da configuração de herança de tag.

Name Tipo Description
preferContainerTags

boolean

Essa propriedade define o comportamento quando uma tag herdada que está sendo aplicada corresponde a uma tag de escopo inferior (por exemplo, A tag de assinatura corresponde à tag de recurso). Se definido como true - quando as tags corresponderem, as tags de escopo mais alto serão aplicadas. O perfil de faturamento é o escopo mais alto, seguido por seções de fatura, assinaturas e grupos de recursos (permite a substituição de valores de tag de escopo mais baixos). Se definido como false - quando as tags corresponderem, as tags de escopo mais baixo serão aplicadas. Portanto, se um recurso tiver a mesma tag que uma tag de assinatura, a tag de recurso será aplicada (não permite a substituição de valores de tag de escopo inferior).

TagInheritanceSetting

Definição de configuração de herança de tag.

Name Tipo Description
id

string

ID de recurso totalmente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

kind string:

taginheritance

Especifica o tipo de configurações.

name

string

O nome do recurso

properties

TagInheritanceProperties

As propriedades da configuração de herança de tag.

type

string

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