Settings - Get

Servizio:

Cost Management

Versione API:

2019-11-01

Recupera il valore corrente per un'impostazione specifica.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
settingName	path	True	string maxLength: 32	Nome dell'impostazione. Valori consentiti: myscope
api-version	query	True	string	Versione dell'API da usare con la richiesta client. La versione corrente è 2019-11-01.

Risposte

Nome	Tipo	Descrizione
200 OK	Setting	OK. La richiesta ha avuto esito positivo.
Other Status Codes	ErrorResponse	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

Settings

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:

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

Definizioni

Nome	Descrizione
Cache	Matrice di ambiti con dettagli aggiuntivi usati da Gestione costi nel portale di Azure.
ErrorDetails	Dettagli dell'errore.
ErrorResponse	La risposta di errore indica che il servizio non è in grado di elaborare la richiesta in ingresso. Il motivo viene fornito nel messaggio di errore. Alcune risposte di errore: 429 TooManyRequests - La richiesta è limitata. Riprovare dopo aver aspettato il tempo specificato nell'intestazione "x-ms-ratelimit-microsoft.consumption-retry-after". 503 ServiceUnavailable - Il servizio non è temporaneamente disponibile. Riprovare dopo aver aspettato il tempo specificato nell'intestazione "Retry-After".
Setting	Stato dell'impostazione dell'ambito.

Cache

Object

Matrice di ambiti con dettagli aggiuntivi usati da Gestione costi nel portale di Azure.

Nome	Tipo	Descrizione
channel	string	Indica il tipo di account. I valori consentiti includono: EA, PAYG, Modern, Internal, Unknown.
id	string	ID risorsa usato da Resource Manager per identificare in modo univoco l'ambito.
name	string	Nome visualizzato per l'ambito.
parent	string	ID risorsa dell'ambito padre. Ad esempio, l'ID risorsa della sottoscrizione per un gruppo di risorse o un ID risorsa del gruppo di gestione per una sottoscrizione.
status	string	Indica lo stato dell'ambito. Lo stato si applica solo alle sottoscrizioni e agli account di fatturazione.
subchannel	string	Indica il tipo di account moderno. I valori consentiti includono: Individual, Enterprise, Partner, Indirect, NotApplicable

ErrorDetails

Object

Dettagli dell'errore.

Nome	Tipo	Descrizione
code	string	Codice di errore.
message	string	Messaggio di errore che indica il motivo per cui l'operazione non è riuscita.

ErrorResponse

Object

La risposta di errore indica che il servizio non è in grado di elaborare la richiesta in ingresso. Il motivo viene fornito nel messaggio di errore.

Alcune risposte di errore:

• 429 TooManyRequests - La richiesta è limitata. Riprovare dopo aver aspettato il tempo specificato nell'intestazione "x-ms-ratelimit-microsoft.consumption-retry-after".

• 503 ServiceUnavailable - Il servizio non è temporaneamente disponibile. Riprovare dopo aver aspettato il tempo specificato nell'intestazione "Retry-After".

Nome	Tipo	Descrizione
error	ErrorDetails	Dettagli dell'errore.

Setting

Object

Stato dell'impostazione dell'ambito.

Nome	Tipo	Descrizione
id	string	ID risorsa.
kind	string maxLength: 10	Tipo di risorsa.
name	string	Nome risorsa.
properties.cache	Cache[]	Matrice di ambiti con dettagli aggiuntivi usati da Gestione costi nel portale di Azure.
properties.scope	string	Imposta l'ambito predefinito che l'utente corrente vedrà quando accede a Gestione costi di Azure nel portale di Azure.
properties.startOn	enum: LastUsed ScopePicker SpecificScope	Indica l'ambito di Gestione costi nel portale di Azure per impostazione predefinita. Valori consentiti: LastUsed.
type	string	Tipo di risorsa.