Settings - Get

Service:

Cost Management

Version d'API:

2019-11-01

Récupère la valeur actuelle d’un paramètre spécifique.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
settingName	path	True	string maxLength: 32	Nom du paramètre. Valeurs autorisées : myscope
api-version	query	True	string	Version de l’API à utiliser avec la demande cliente. La version actuelle est 2019-11-01.

Réponses

Nom	Type	Description
200 OK	Setting	D’ACCORD. La demande a réussi.
Other Status Codes	ErrorResponse	Réponse d’erreur décrivant pourquoi l’opération a échoué.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

Settings

Exemple de requête

HTTP

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

Exemple de réponse

Code d’état:

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

Définitions

Nom	Description
Cache	Tableau d’étendues avec des détails supplémentaires utilisés par Cost Management dans le portail Azure.
ErrorDetails	Détails de l’erreur.
ErrorResponse	La réponse d’erreur indique que le service n’est pas en mesure de traiter la requête entrante. La raison est fournie dans le message d’erreur. Réponses d’erreur : 429 TooManyRequests : la requête est limitée. Réessayez après avoir attendu l’heure spécifiée dans l’en-tête « x-ms-ratelimit-microsoft.consumption-retry-after ». 503 ServiceUnavailable - Le service est temporairement indisponible. Réessayez après avoir attendu l’heure spécifiée dans l’en-tête « Retry-After ».
Setting	État du paramètre myscope.

Cache

Object

Tableau d’étendues avec des détails supplémentaires utilisés par Cost Management dans le portail Azure.

Nom	Type	Description
channel	string	Indique le type de compte. Les valeurs autorisées sont les suivantes : EA, PAYG, Modern, Internal, Unknown.
id	string	ID de ressource utilisé par Resource Manager pour identifier de manière unique l’étendue.
name	string	Nom complet de l’étendue.
parent	string	ID de ressource de l’étendue parente. Par exemple, l’ID de ressource de l’abonnement pour un groupe de ressources ou un ID de ressource de groupe d’administration pour un abonnement.
status	string	Indique l’état de l’étendue. L’état s’applique uniquement aux abonnements et aux comptes de facturation.
subchannel	string	Indique le type de compte moderne. Les valeurs autorisées sont les suivantes : Individual, Enterprise, Partner, Indirect, NotApplicable

ErrorDetails

Object

Détails de l’erreur.

Nom	Type	Description
code	string	Code d’erreur.
message	string	Message d’erreur indiquant pourquoi l’opération a échoué.

ErrorResponse

Object

La réponse d’erreur indique que le service n’est pas en mesure de traiter la requête entrante. La raison est fournie dans le message d’erreur.

Réponses d’erreur :

• 429 TooManyRequests : la requête est limitée. Réessayez après avoir attendu l’heure spécifiée dans l’en-tête « x-ms-ratelimit-microsoft.consumption-retry-after ».

• 503 ServiceUnavailable - Le service est temporairement indisponible. Réessayez après avoir attendu l’heure spécifiée dans l’en-tête « Retry-After ».

Nom	Type	Description
error	ErrorDetails	Détails de l’erreur.

Setting

Object

État du paramètre myscope.

Nom	Type	Description
id	string	ID de ressource.
kind	string maxLength: 10	Type de ressource.
name	string	Nom de la ressource.
properties.cache	Cache[]	Tableau d’étendues avec des détails supplémentaires utilisés par Cost Management dans le portail Azure.
properties.scope	string	Définit l’étendue par défaut que l’utilisateur actuel verra quand il se connecte à Azure Cost Management dans le portail Azure.
properties.startOn	enum: LastUsed ScopePicker SpecificScope	Indique l’étendue de Cost Management dans le portail Azure sur laquelle la valeur par défaut doit être définie. Valeurs autorisées : LastUsed.
type	string	Type de ressource.