Settings - Get By Scope

Servicio:: Cost Management

Versión de la API:: 2025-03-01

Obtenga la configuración del ámbito especificado por nombre.

GET https://management.azure.com/{scope}/providers/Microsoft.CostManagement/settings/taginheritance?api-version=2025-03-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
scope	path	True	string	no definido
type	path	True	SettingType	Tipo de configuración.
api-version	query	True	string minLength: 1	Versión de la API que se va a usar para esta operación.

Respuestas

Nombre	Tipo	Description
200 OK	Setting: TagInheritanceSetting	La operación de Azure se completó correctamente.
Other Status Codes	ErrorResponse	Una respuesta de error inesperada.

Seguridad

azure_auth

Flujo 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

SettingByScope

Solicitud de ejemplo

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/settings/taginheritance?api-version=2025-03-01

Respuesta de muestra

status code:: 200

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

Definiciones

Nombre	Description
createdByType	Tipo de identidad que creó el recurso.
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. \n\nAlgunas respuestas a errores: \n\n * 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". \n\n * 503 ServiceNo disponible - El servicio está temporalmente no disponible. Vuelva a intentarlo después de esperar el tiempo especificado en el encabezado "Retry-After".
SettingsKind	Especifica el tipo de configuración.
SettingType
systemData	Metadatos relativos a la creación y última modificación del recurso.
TagInheritanceProperties	Las propiedades de la configuración de herencia de etiquetas.
TagInheritanceSetting	Definición de configuración de herencia de etiquetas.

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor	Description
User
Application
ManagedIdentity
Key

ErrorDetails

Objeto

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

Objeto

La respuesta de error indica que el servicio no puede procesar la solicitud entrante. El motivo se proporciona en el mensaje de error. \n\nAlgunas respuestas a errores: \n\n * 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". \n\n * 503 ServiceNo disponible - El servicio está temporalmente no disponible. Vuelva a intentarlo después de esperar el tiempo especificado en el encabezado "Retry-After".

Nombre	Tipo	Description
error	ErrorDetails	Detalles del error.

SettingsKind

Enumeración

Especifica el tipo de configuración.

Valor	Description
taginheritance

SettingType

Enumeración

Valor	Description
taginheritance	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.

systemData

Objeto

Metadatos relativos a la creación y última modificación del recurso.

Nombre	Tipo	Description
createdAt	string (date-time)	Marca de tiempo de creación de recursos (UTC).
createdBy	string	Identidad que creó el recurso.
createdByType	createdByType	Tipo de identidad que creó el recurso.
lastModifiedAt	string (date-time)	La marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy	string	Identidad que modificó por última vez el recurso.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.

TagInheritanceProperties

Objeto

Las 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 coincidan, se aplicarán las etiquetas de ámbito más alto. El perfil de facturación es el ámbito más alto, seguido de las secciones de factura, las suscripciones y los grupos de recursos (permite invalidar los valores de etiqueta de ámbito inferiores). Si se establece en false: cuando las etiquetas coincidan, 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 invalidar valores de etiqueta de ámbito inferiores).

TagInheritanceSetting

Objeto

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

Nombre	Tipo	Description
id	string (arm-id)	Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string: taginheritance pattern: ^[-\w\._,$\\$]+$	Metadatos utilizados por portal/herramientas/etc para representar diferentes experiencias de experiencia de usuario para los recursos del mismo tipo; Por ejemplo, ApiApps son un tipo de tipo Microsoft.Web/sites. Si se admite, el proveedor de recursos debe validar y conservar este valor.
name	string	Nombre del recurso
properties	TagInheritanceProperties	Las propiedades de la configuración de herencia de etiquetas.
systemData	systemData	Metadatos de Azure Resource Manager que contienen información createdBy y modifiedBy.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"