Settings - Create Or Update By Scope

Servicio:

Cost Management

Versión de la API:

2024-08-01

Cree o actualice una configuración dentro del ámbito especificado.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
scope	path	True	string	Ámbito asociado a esta configuración. Esto incluye "subscriptions/{subscriptionId}" para el ámbito de la suscripción, "providers/Microsoft.Billing/billingAccounts/{billingAccountId}" para el ámbito de la cuenta de facturación, "providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfileId}" para el ámbito del perfil de facturación.
type	path	True	SettingType	Tipo de configuración.
api-version	query	True	string	Versión de la API que se va a usar para esta operación.

Cuerpo de la solicitud

TagInheritanceSetting

Definición de configuración de herencia de etiquetas.

Nombre	Requerido	Tipo	Description
kind	True	string: taginheritance	Especifica el tipo de configuración.
properties		TagInheritanceProperties	Propiedades de la configuración de herencia de etiquetas.

Respuestas

Nombre	Tipo	Description
200 OK	Setting: TagInheritanceSetting	Configuración actualizada.
201 Created	Setting: TagInheritanceSetting	Configuración creada.
Other Status Codes	ErrorResponse	Respuesta de error que describe por qué se produjo un error en la operación.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

CreateOrUpdateSettingByScope

Solicitud de ejemplo

HTTP

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

Respuesta de muestra

status code:

201

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

status code:

200

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

Definiciones

Nombre	Description
ErrorDetails	Detalles del error.
ErrorResponse	La respuesta de error indica que el servicio no puede procesar la solicitud entrante. El motivo se proporciona en el mensaje de error. Algunas respuestas de error: 429 TooManyRequests: la solicitud está limitada. Vuelva a intentarlo después de esperar el tiempo especificado en el encabezado "x-ms-ratelimit-microsoft.consumption-retry-after". 503 ServiceUnavailable: el servicio no está disponible temporalmente. Vuelva a intentarlo después de esperar el tiempo especificado en el encabezado "Retry-After".
SettingType	Tipo de configuración.
TagInheritanceProperties	Propiedades de la configuración de herencia de etiquetas.
TagInheritanceSetting	Definición de configuración de herencia de etiquetas.

ErrorDetails

Detalles del error.

Nombre	Tipo	Description
code	string	Código de error.
message	string	Mensaje de error que indica por qué se produjo un error en la operación.

ErrorResponse

La respuesta de error indica que el servicio no puede procesar la solicitud entrante. El motivo se proporciona en el mensaje de error.

Algunas respuestas de error:

• 429 TooManyRequests: la solicitud está limitada. Vuelva a intentarlo después de esperar el tiempo especificado en el encabezado "x-ms-ratelimit-microsoft.consumption-retry-after".

• 503 ServiceUnavailable: el servicio no está disponible temporalmente. Vuelva a intentarlo después de esperar el tiempo especificado en el encabezado "Retry-After".

Nombre	Tipo	Description
error	ErrorDetails	Detalles del error.

SettingType

Tipo de configuración.

Nombre	Tipo	Description
taginheritance	string	Esta configuración aplica etiquetas de perfil de facturación, sección de factura, suscripción y grupo de recursos a los datos de uso del mes actual de los recursos secundarios.

TagInheritanceProperties

Propiedades de la configuración de herencia de etiquetas.

Nombre	Tipo	Description
preferContainerTags	boolean	Esta propiedad define el comportamiento cuando una etiqueta heredada que se aplica coincide con una etiqueta de ámbito inferior (por ejemplo, La etiqueta de suscripción coincide con la etiqueta de recurso). Si se establece en true: cuando las etiquetas coinciden, se aplicarán las etiquetas de ámbito más altas. El perfil de facturación es el ámbito más alto, seguido de secciones de factura, suscripciones y grupos de recursos (permite reemplazar los valores de etiqueta de ámbito inferior). Si se establece en false: cuando las etiquetas coinciden, se aplicarán las etiquetas de ámbito más bajas. Por lo tanto, si un recurso tiene la misma etiqueta que una etiqueta de suscripción, se aplicará la etiqueta de recurso (no permite reemplazar los valores de etiqueta de ámbito inferior).

TagInheritanceSetting

Definición de configuración de herencia de etiquetas.

Nombre	Tipo	Description
id	string	Identificador de recurso completo para el recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
kind	string: taginheritance	Especifica el tipo de configuración.
name	string	Nombre del recurso
properties	TagInheritanceProperties	Propiedades de la configuración de herencia de etiquetas.
type	string	Tipo del recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"