Settings - Get

Dienst:

Cost Management

API-Version:

2019-11-01

Ruft den aktuellen Wert für eine bestimmte Einstellung ab.

GET https://management.azure.com/providers/Microsoft.CostManagement/settings/{settingName}?api-version=2019-11-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
settingName	path	True	string maxLength: 32	Name der Einstellung. Zulässige Werte: myscope
api-version	query	True	string	Version der API, die mit der Clientanforderung verwendet werden soll. Die aktuelle Version ist 2019-11-01.

Antworten

Name	Typ	Beschreibung
200 OK	Setting	OKAY. Die Anforderung ist erfolgreich.
Other Status Codes	ErrorResponse	Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

Settings

Beispielanforderung

HTTP

GET https://management.azure.com/providers/Microsoft.CostManagement/settings/myscope?api-version=2019-11-01

Beispiel für eine Antwort

Statuscode:

200

{
  "id": "/providers/Microsoft.CostManagement/settings/myscope",
  "name": "myscope",
  "kind": "user",
  "type": "Microsoft.CostManagement/Settings",
  "properties": {
    "scope": "/subscriptions/00000000-0000-0000-0000-000000000000",
    "startOn": "LastUsed",
    "cache": [
      {
        "id": "/providers/Microsoft.Management/managementGroups/72f988bf-86f1-41af-91ab-2d7cd011db47",
        "name": "72f988bf-86f1-41af-91ab-2d7cd011db47",
        "channel": "Modern",
        "subchannel": "NotApplicable",
        "parent": "/providers/Microsoft.Management/managementGroups/acm",
        "status": "enabled"
      }
    ]
  }
}

Definitionen

Name	Beschreibung
Cache	Array von Bereichen mit zusätzlichen Details, die von Cost Management im Azure-Portal verwendet werden.
ErrorDetails	Die Details des Fehlers.
ErrorResponse	Fehlerantwort gibt an, dass der Dienst die eingehende Anforderung nicht verarbeiten kann. Der Grund wird in der Fehlermeldung angegeben. Einige Fehlerantworten: 429 TooManyRequests – Anforderung wird gedrosselt. Wiederholen Sie den Vorgang nach dem Warten auf die im Header "x-ms-ratelimit-microsoft.consumption-retry-after" angegebene Zeit. 503 ServiceUnavailable – Dienst ist vorübergehend nicht verfügbar. Wiederholen Sie den Vorgang nach dem Warten auf die im Header "Retry-After" angegebene Zeit.
Setting	Status der MyScope-Einstellung.

Cache

Objekt

Array von Bereichen mit zusätzlichen Details, die von Cost Management im Azure-Portal verwendet werden.

Name	Typ	Beschreibung
channel	string	Gibt den Kontotyp an. Zulässige Werte sind: EA, PAYG, Modern, Internal, Unknown.
id	string	Ressourcen-ID, die vom Ressourcen-Manager verwendet wird, um den Bereich eindeutig zu identifizieren.
name	string	Anzeigename für den Bereich.
parent	string	Ressourcen-ID des übergeordneten Bereichs. Beispielsweise die Ressourcen-ID des Abonnements für eine Ressourcengruppe oder eine Verwaltungsgruppenressourcen-ID für ein Abonnement.
status	string	Gibt den Status des Bereichs an. Der Status gilt nur für Abonnements und Abrechnungskonten.
subchannel	string	Gibt den Typ des modernen Kontos an. Zulässige Werte sind: Individual, Enterprise, Partner, Indirect, NotApplicable

ErrorDetails

Objekt

Die Details des Fehlers.

Name	Typ	Beschreibung
code	string	Fehlercode.
message	string	Fehlermeldung, die angibt, warum der Vorgang fehlgeschlagen ist.

ErrorResponse

Objekt

Fehlerantwort gibt an, dass der Dienst die eingehende Anforderung nicht verarbeiten kann. Der Grund wird in der Fehlermeldung angegeben.

Einige Fehlerantworten:

• 429 TooManyRequests – Anforderung wird gedrosselt. Wiederholen Sie den Vorgang nach dem Warten auf die im Header "x-ms-ratelimit-microsoft.consumption-retry-after" angegebene Zeit.

• 503 ServiceUnavailable – Dienst ist vorübergehend nicht verfügbar. Wiederholen Sie den Vorgang nach dem Warten auf die im Header "Retry-After" angegebene Zeit.

Name	Typ	Beschreibung
error	ErrorDetails	Die Details des Fehlers.

Setting

Objekt

Status der MyScope-Einstellung.

Name	Typ	Beschreibung
id	string	Ressourcen-ID.
kind	string maxLength: 10	Ressourcentyp.
name	string	Ressourcenname.
properties.cache	Cache[]	Array von Bereichen mit zusätzlichen Details, die von Cost Management im Azure-Portal verwendet werden.
properties.scope	string	Legt den Standardbereich fest, den der aktuelle Benutzer sehen wird, wenn er sich im Azure-Portal bei Azure Cost Management anmeldet.
properties.startOn	enum: LastUsed ScopePicker SpecificScope	Gibt an, auf welchen Umfang die Kostenverwaltung im Azure-Portal standardmäßig festgelegt werden soll. Zulässige Werte: LastUsed.
type	string	Ressourcentyp.