Subscriptions - Get

Service:

Resource Management

Version d'API:

2022-12-01

Obtient des détails sur un abonnement spécifié.

GET https://management.azure.com/subscriptions/{subscriptionId}?api-version=2022-12-01

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
subscriptionId	path	True	string (uuid)	ID de l’abonnement cible. La valeur doit être un UUID.
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

Réponses

Nom	Type	Description
200 OK	Subscription	Opération Azure terminée avec succès.
Other Status Codes	CloudError	Réponse d’erreur inattendue.

Sécurité

azure_auth

Azure Active Directory OAuth2 Flow.

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

GetASingleSubscription

Exemple de requête

HTTP

GET https://management.azure.com/subscriptions/291bba3f-e0a5-47bc-a099-3bdcb2a50a05?api-version=2022-12-01

Python

from azure.identity import DefaultAzureCredential

from azure.mgmt.resource.subscriptions import SubscriptionClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-resource-subscriptions
# USAGE
    python get_subscription.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = SubscriptionClient(
        credential=DefaultAzureCredential(),
    )

    response = client.subscriptions.get(
        subscription_id="291bba3f-e0a5-47bc-a099-3bdcb2a50a05",
    )
    print(response)


# x-ms-original-file: specification/resources/resource-manager/Microsoft.Resources/subscriptions/stable/2022-12-01/examples/GetSubscription.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Exemple de réponse

Code d’état:

200

{
  "authorizationSource": "Bypassed",
  "displayName": "Example Subscription",
  "id": "/subscriptions/291bba3f-e0a5-47bc-a099-3bdcb2a50a05",
  "managedByTenants": [
    {
      "tenantId": "8f70baf1-1f6e-46a2-a1ff-238dac1ebfb7"
    }
  ],
  "state": "Enabled",
  "subscriptionId": "291bba3f-e0a5-47bc-a099-3bdcb2a50a05",
  "subscriptionPolicies": {
    "locationPlacementId": "Internal_2014-09-01",
    "quotaId": "Internal_2014-09-01",
    "spendingLimit": "Off"
  },
  "tags": {
    "tagKey1": "tagValue1",
    "tagKey2": "tagValue2"
  },
  "tenantId": "31c75423-32d6-4322-88b7-c478bdde4858"
}

Définitions

Nom	Description
CloudError	Réponse d’erreur pour une demande de gestion des ressources.
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
ManagedByTenant	Informations sur un locataire gérant l’abonnement.
SpendingLimit	Limite de dépense de l’abonnement.
Subscription	Informations sur l’abonnement.
SubscriptionPolicies	Stratégies d’abonnement.
SubscriptionState	État de l’abonnement. Les valeurs possibles sont Enabled, Warned, PastDue, Disabled et Deleted.

CloudError

Objet

Réponse d’erreur pour une demande de gestion des ressources.

Nom	Type	Description
error	ErrorResponse	Réponse d’erreur Réponse d’erreur courante pour toutes les API Azure Resource Manager afin de retourner les détails de l’erreur pour les opérations ayant échoué. (Cela suit également le format de réponse d’erreur OData.).

ErrorAdditionalInfo

Objet

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires.
type	string	Type d’informations supplémentaire.

ErrorDetail

Objet

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d’erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorResponse

Objet

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

ManagedByTenant

Objet

Informations sur un locataire gérant l’abonnement.

Nom	Type	Description
tenantId	string	ID de locataire du locataire gérant. Il s’agit d’un GUID.

SpendingLimit

Énumération

Limite de dépense de l’abonnement.

Valeur	Description
On	Activé
Off	Désactivé
CurrentPeriodOff	CurrentPeriodOff

Subscription

Objet

Informations sur l’abonnement.

Nom	Type	Description
authorizationSource	string	Source d’autorisation de la demande. Les valeurs valides sont une ou plusieurs combinaisons de legacy, RoleBased, Bypassed, Direct and Management. Par exemple, « Legacy, RoleBased ».
displayName	string	Nom complet de l’abonnement.
id	string	ID complet de l’abonnement. Par exemple, /subscriptions/8d65815f-a5b6-402f-9298-045155da7d74
managedByTenants	ManagedByTenant[]	Tableau contenant les locataires gérant l’abonnement.
state	SubscriptionState	État de l’abonnement. Les valeurs possibles sont Enabled, Warned, PastDue, Disabled et Deleted.
subscriptionId	string	ID d’abonnement.
subscriptionPolicies	SubscriptionPolicies	Stratégies d’abonnement.
tags	object	Balises attachées à l’abonnement.
tenantId	string	ID de locataire de l’abonnement.

SubscriptionPolicies

Objet

Stratégies d’abonnement.

Nom	Type	Description
locationPlacementId	string	ID de placement de l’emplacement de l’abonnement. L’ID indique quelles régions sont visibles pour un abonnement. Par exemple, un abonnement avec un ID de placement d’emplacement de Public_2014-09-01 a accès aux régions publiques Azure.
quotaId	string	ID de quota d’abonnement.
spendingLimit	SpendingLimit	Limite de dépense de l’abonnement.

SubscriptionState

Énumération

État de l’abonnement. Les valeurs possibles sont Enabled, Warned, PastDue, Disabled et Deleted.

Valeur	Description
Enabled	Activé
Warned	Averti
PastDue	PastDue
Disabled	Désactivé
Deleted	Supprimé