Settings - Get

Service:

Cost Management

API-versie:

2019-11-01

Haalt de huidige waarde voor een specifieke instelling op.

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

URI-parameters

Name	In	Vereist	Type	Description
settingName	path	True	string maxLength: 32	Naam van de instelling. Toegestane waarden: myscope
api-version	query	True	string	Versie van de API die moet worden gebruikt met de clientaanvraag. De huidige versie is 2019-11-01.

Antwoorden

Name	Type	Description
200 OK	Setting	OK. De aanvraag is voltooid.
Other Status Codes	ErrorResponse	Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

Settings

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

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

Definities

Name	Description
Cache	Matrix van bereiken met aanvullende details die worden gebruikt door Cost Management in Azure Portal.
ErrorDetails	De details van de fout.
ErrorResponse	Foutreactie geeft aan dat de service de binnenkomende aanvraag niet kan verwerken. De reden is opgegeven in het foutbericht. Enkele foutberichten: 429 TooManyRequests - Aanvraag wordt beperkt. Probeer het opnieuw nadat u hebt gewacht op de tijd die is opgegeven in de header x-ms-ratelimit-microsoft.consumption-retry-after. 503 ServiceUnavailable - Service is tijdelijk niet beschikbaar. Probeer het opnieuw nadat u hebt gewacht op de tijd die is opgegeven in de header 'Opnieuw proberen-na'.
Setting	Status van de myscope-instelling.

Cache

Object

Matrix van bereiken met aanvullende details die worden gebruikt door Cost Management in Azure Portal.

Name	Type	Description
channel	string	Geeft het accounttype aan. Toegestane waarden zijn: EA, PAYG, Modern, Intern, Onbekend.
id	string	Resource-id die door Resource Manager wordt gebruikt om het bereik uniek te identificeren.
name	string	Weergavenaam voor het bereik.
parent	string	Resource-id van het bovenliggende bereik. Bijvoorbeeld de resource-id van het abonnement voor een resourcegroep of een resource-id van een beheergroep voor een abonnement.
status	string	Geeft de status van het bereik aan. De status is alleen van toepassing op abonnementen en factureringsaccounts.
subchannel	string	Geeft het type modern account aan. Toegestane waarden zijn: Individual, Enterprise, Partner, Indirect, NotApplicable

ErrorDetails

Object

De details van de fout.

Name	Type	Description
code	string	Foutcode.
message	string	Foutbericht dat aangeeft waarom de bewerking is mislukt.

ErrorResponse

Object

Foutreactie geeft aan dat de service de binnenkomende aanvraag niet kan verwerken. De reden is opgegeven in het foutbericht.

Enkele foutberichten:

• 429 TooManyRequests - Aanvraag wordt beperkt. Probeer het opnieuw nadat u hebt gewacht op de tijd die is opgegeven in de header x-ms-ratelimit-microsoft.consumption-retry-after.

• 503 ServiceUnavailable - Service is tijdelijk niet beschikbaar. Probeer het opnieuw nadat u hebt gewacht op de tijd die is opgegeven in de header 'Opnieuw proberen-na'.

Name	Type	Description
error	ErrorDetails	De details van de fout.

Setting

Object

Status van de myscope-instelling.

Name	Type	Description
id	string	Resource-id.
kind	string maxLength: 10	Resourcetype.
name	string	Resourcenaam.
properties.cache	Cache[]	Matrix van bereiken met aanvullende details die worden gebruikt door Cost Management in Azure Portal.
properties.scope	string	Hiermee stelt u het standaardbereik in dat de huidige gebruiker ziet wanneer deze zich aanmeldt bij Azure Cost Management in Azure Portal.
properties.startOn	enum: LastUsed ScopePicker SpecificScope	Hiermee wordt aangegeven welk bereik Cost Management in Azure Portal standaard moet zijn. Toegestane waarden: LastUsed.
type	string	Resourcetype.