Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
s’applique à: Espace partenaires | Espace partenaires géré par 21Vianet | Espace partenaires pour Microsoft Cloud pour le gouvernement des États-Unis
Un abonnement permet à un client d’utiliser un service pendant une certaine période. Tous les champs ne s’appliquent pas à tous les abonnements. De nombreux champs s’appliquent uniquement à certains points du cycle de vie, par exemple si un abonnement est suspendu ou annulé.
Abonnement
Remarque
La ressource d’abonnement a une limite de 500 requêtes par minute par identificateur de locataire.
La ressource Abonnement représente le cycle de vie d’un abonnement et inclut les propriétés qui définissent les états tout au long du cycle de vie de l’abonnement.
| Propriété | Catégorie | Descriptif |
|---|---|---|
| ID | ficelle | Identificateur de l’abonnement. |
| offerId | ficelle | Identificateur de l’offre. |
| entitlementId | ficelle | Identificateur de droit d'accès (identifiant d'abonnement Azure). |
| nommOffre | ficelle | Nom de l’offre. |
| nom convivial | ficelle | Nom convivial de l’abonnement défini par le partenaire pour aider à désambiguer. |
| quantité | nombre | Quantité. Cette propriété est définie sur le nombre de licences pour la facturation par licence. |
| type d'unité | ficelle | Unités définissant la quantité pour l’abonnement : « Licences », « Basée sur l’utilisation » ou « Avantage ». |
| IdentifiantAbonnementParent | ficelle | Obtient ou définit l’identificateur d’abonnement parent. |
| date de création | ficelle | Obtient ou définit la date de création, au format date-heure. |
| date de début effective | chaîne au format date et heure UTC | Obtient ou définit la date de début effective de cet abonnement, au format date-heure. Cette propriété est utilisée pour dater un abonnement migré ou l’aligner avec un autre. |
| date de fin d'engagement | chaîne au format date et heure UTC | Date de fin de l’engagement pour cet abonnement, au format date-heure. Pour les abonnements qui ne sont pas renouvelables automatiquement, cette propriété représente une date dans un futur lointain. Les nouvelles dates de fin de commerce sont inclusives, ce qui signifie que la fin du terme est à la fin de la journée complète. Les dates de fin des anciennes versions ne sont pas incluses. |
| commitmentEndDateTime | chaîne au format date et heure UTC | Date et heure de fin de l’engagement pour cet abonnement, au format date-heure. Pour les abonnements qui ne sont pas renouvelables automatiquement, cette propriété représente une date dans un futur lointain. |
| statut | ficelle | État de l’abonnement : « aucun », « actif », « en attente », « suspendu », « expiré », « désactivé » ou « supprimé ». |
| activationRenouvellementAutomatique | booléen | Obtient une valeur indiquant si l’abonnement est renouvelé automatiquement. |
| type de facturation | ficelle | Spécifie la façon dont l’abonnement est facturé : « none », « usage », « license » ou « benefit ». |
| cycle de facturation | ficelle | Indique la fréquence à laquelle le partenaire est facturé pour cette commande. Les valeurs prises en charge sont les noms de membres trouvés dans BillingCycleType. |
| aDesModulesComplémentairesPayables | booléen | Obtient ou définit une valeur indiquant si l’abonnement a des modules complémentaires pouvant être purchassables. |
| isTrial | booléen | Valeur indiquant si l’abonnement est un essai. |
| estProduitMicrosoft | booléen | Valeur indiquant si l’abonnement est un produit Microsoft. |
| Nom de l'éditeur | ficelle | Nom de l’éditeur. |
| Actions | tableau de chaînes | Obtient ou définit les actions autorisées. Valeurs possibles : « edit », « cancel » |
| partnerId | ficelle | PartnerID du revendeur d’enregistrement, utilisé dans le modèle partenaire indirect. |
| additionalPartnerIds | tableau de chaînes | Collection des PartnerID utilisés uniquement par les distributeurs dans les marchés de l’UE/AELE. |
| raisons de suspension | tableau de chaînes | Lecture seule. Si l’abonnement a été suspendu, indique pourquoi. |
| type de contrat | ficelle | Lecture seule. Type de contrat : « subscription », « productKey » ou « redemptionCode ». |
| options de remboursement | tableau de ressources RefundOption | En lecture seule. Ensemble d’options de remboursement disponibles pour cet abonnement. |
| Instructions pour le prochain terme prévu | scheduledNextTermInstructions | Obtient ou définit les instructions planifiées exécutées au début de la période suivante. |
| Instructions suivantes de charge | nextChargeInstructions | Obtient les détails des instructions de facturation à terme suivantes pour les modifications du cycle de facturation en attente à la fin de la période actuelle. |
| Liens | SubscriptionLinks | Obtient ou définit les liens d’abonnement. |
| ID de commande | ficelle | ID de la commande qui a été passée pour commencer l’abonnement. |
| termDurée | ficelle | Une représentation ISO 8601 de la durée du terme. Les valeurs actuellement prises en charge sont P1M (1 mois), P1Y (1 an) et P3Y (3 ans). |
| termLifeCycleState | ficelle | Représentation de l'état du cycle de vie du terme de l'abonnement. Les valeurs prises en charge actuelles sont ga (généralement disponibles), EndOfSale et EndOfSaleWithConversions (peuvent être inversées). |
| Attributs | ResourceAttributes | Attributs de métadonnées correspondant à l’abonnement. |
| durée du terme de renouvellement | ficelle | Une représentation ISO 8601 de la durée du terme. Les valeurs prises en charge actuelles sont P1M (1 mois) et P1Y (1 an). |
| Type de produit | Type d’article | Lecture seule. Le type de produit pour lequel l’abonnement est utilisé. |
| typeDeConsommation | tableau de ressources excédentaires | Obtient ou définit un dépassement pour un client donné. |
| promotionId | ficelle | Identificateur de promotion s’il est appliqué à l’abonnement. Exemple de format : « 39NFJQT1PJQB :0001:39NFJQT1Q5KN » |
| AnnulationPermiseJusqu'àDate | Date et heure | Date de la dernière annulation. |
| BillingCycleEndDate | Date et heure | Obtient ou définit la date de fin du cycle de facturation pour cet abonnement, au format date-heure. |
| BillingCycleEndDateTime | Date et heure | Obtient l’heure de fin du cycle de facturation pour cet abonnement, au format date-heure. |
| productOrderId | ficelle | Identificateur d’un achat de produit spécifique (par exemple, réservations ou plan d’épargne Azure). |
| lineItems | SubscriptionLineItem | Un élément de ligne contient les détails de l’achat d’un abonnement particulier. |
AbonnementLiens.
La ressource SubscriptionLinks décrit la collection de liens attachés à une ressource d’abonnement.
| Propriété | Catégorie | Descriptif |
|---|---|---|
| offre | Lien | Obtient ou définit l’offre. |
| abonnement parent | Lien | Obtient ou définit l’abonnement parent. |
| produit | Lien | Obtient le produit associé à l’abonnement. |
| Sku | Lien | Obtient la référence SKU du produit associée à l’abonnement. |
| disponibilité | Lien | Obtient la disponibilité de la référence SKU du produit associée à l’abonnement. |
| activationLinks | Lien | Obtient la liste des liens d’activation associés à l’abonnement. |
| même | Lien | L’auto-URI. |
| Suivant | Lien | Page suivante des éléments. |
| précédent | Lien | Page précédente des éléments. |
StatutDeProvisionnementD'Abonnement
La ressource SubscriptionProvisioningStatus fournit des informations sur l’état d’approvisionnement d’un abonnement.
| Propriété | Catégorie | Descriptif |
|---|---|---|
| skuId | ficelle | Chaîne qui identifie la référence SKU du produit. |
| statut | ficelle | Indique l’état d’approvisionnement : « réussite », « en attente » ou « échec ». |
| quantité | nombre | Fournit la quantité d’abonnement après l’approvisionnement. |
| date de fin | chaîne au format date et heure UTC | Date de fin de l’abonnement. |
| Attributs | ResourceAttributes | Les attributs de métadonnées. |
Instructions pour le prochain terme prévu
La ressource scheduledNextTermInstructions définit les instructions à appliquer au début du terme suivant de l’abonnement. Présente uniquement si des changements programmés sont définis ou pour tous les abonnements d'essai.
| Propriété | Catégorie | Descriptif |
|---|---|---|
| produit | produit | Chaîne au format GUID qui identifie la référence SKU du produit. |
| quantité | nombre | Fournit la quantité d’abonnement après l’approvisionnement. |
| customTermEndDate | chaîne au format date et heure UTC | Date de fin personnalisée de l’abonnement lorsqu’elle est alignée sur la date de fin d’un autre abonnement |
Produit
La ressource scheduledNextTermInstructions.product et les attributs d’une modification planifiée s’appliquent au prochain terme.
| Propriété | Catégorie | Descriptif |
|---|---|---|
| ID de produit | Chaîne | ID d’un produit. |
| skuId | Chaîne | Fournit la quantité d’abonnement après l’approvisionnement. |
| Identifiant de disponibilité | Chaîne | Identifiant de cette disponibilité. Cet ID est unique uniquement dans le contexte de son produit parent et de sa référence SKU. Note Les ID de disponibilité peuvent changer au fil du temps. Les partenaires ne doivent compter que sur cette valeur dans un court intervalle de temps après sa récupération. |
| cycle de facturation | Chaîne | Indique la fréquence à laquelle le partenaire est facturé pour cette commande. Les valeurs prises en charge sont les noms de membres trouvés dans BillingCycleType. |
| termDurée | Chaîne | Une représentation ISO 8601 de la durée du terme. Les valeurs prises en charge actuelles sont P1M (1 mois) et P1Y (1 an). |
| promotionId | Chaîne | Identificateur de promotion à appliquer pour la période planifiée suivante. Exemple de format : « 39NFJQT1PJQB :0001:39NFJQT1Q5KN ». |
Instructions suivantes de charge
La ressource nextChargeInstructions définit les instructions de cycle de facturation appliquées au début du prochain terme de l’abonnement. Seulement présente lorsque des modifications du cycle de facturation sont en attente.
| Propriété | Catégorie | Descriptif |
|---|---|---|
| produit | produit | Chaîne au format GUID qui identifie la référence SKU du produit. |
| quantité | nombre | Fournit la quantité d’abonnement après l’approvisionnement. |
SubscriptionRegistrationStatus
La ressource SubscriptionRegistrationStatus décrit la collection de liens attachés à une ressource d’abonnement.
| Propriété | Catégorie | Descriptif |
|---|---|---|
| ID d'abonnement | ficelle | Identificateur de l’abonnement. |
| statut | ficelle | Indique l’état d’inscription : « inscrit », « en cours d'inscription » ou « non inscrit ». |
Contact du support
La ressource SupportContact représente un contact de support pour l’abonnement d’un client.
| Propriété | Catégorie | Descriptif |
|---|---|---|
| supportTenantId | ficelle | Chaîne au format GUID indiquant l’identificateur de locataire pour le contact de support. |
| supportMpnId | ficelle | Identificateur du partenaire du contact. |
| nom | ficelle | Nom du contact de support. |
| Liens | ResourceLinks | Les liens liés au contact de support. |
| Attributs | ResourceAttributes | Les attributs de métadonnées. Contient « objectType » : « SupportContact ». |
Dépassement
La ressource de dépassement représente le dépassement de l’abonnement de consommation auquel il pourrait être affecté, qu'il le soit ou au revendeur affecté.
| Propriété | Catégorie | Descriptif |
|---|---|---|
| azureEntitlementId | ficelle | Chaîne au format GUID qui indique l’identificateur de l’abonnement de consommation. |
| partnerId | ficelle | Identificateur partenaire du revendeur associé à l’abonnement. |
| type | ficelle | Le type de dépassement peut être « ServicesTéléphoniques » |
| Excédent | booléen | Valeur indiquant si le dépassement est activé. |
| Liens | ResourceLinks | Liens relatifs aux dépassements. |
| Attributs | ResourceAttributes | Les attributs de métadonnées. Contient « objectType » : « Overage ». |
S’inscrireAbonnement
La ressource RegisterSubscription retourne un lien qui peut être utilisé pour interroger l’état d’inscription d’un abonnement. L’état d’inscription est retourné dans le corps de la réponse d’une demande acceptée avec succès pour inscrire un abonnement Azure.
| Propriété | Catégorie | Descriptif |
|---|---|---|
| httpResponseMessage | objet | Renvoie le code d’état HTTP 202 « Accepté », avec un en-tête Location contenant un lien pour interroger l’état de l’inscription. Par exemple, "/customers/{customer-id}/subscriptions/{subscription-id}/registrationstatus" |
Option de remboursement
La ressource RefundOption représente une option de remboursement possible pour l’abonnement.
| Propriété | Catégorie | Descriptif |
|---|---|---|
| type | ficelle | Type de remboursement. Les valeurs prises en charge sont « Partiel » et « Complet » |
| expire après | chaîne au format date et heure UTC | L'horodatage où cette option expire. Si la valeur est Null, l’opération de remboursement n’a pas d’expiration. |
AzureEntitlement
La ressource AzureEntitlement représente les droits Azure de l’abonnement.
| Propriété | Catégorie | Descriptif |
|---|---|---|
| ID | ficelle | Identificateur du droit d’utilisation |
| nom convivial | ficelle | Nom convivial du droit d’utilisation. |
| statut | ficelle | Statut des droits. |
| ID d'abonnement | ficelle | Identificateur d’abonnement auquel est associé le droit d'utilisation. |
ÉlémentDeLigneD'Abonnement
Un élément de ligne contient les détails de l’achat d’un abonnement particulier.
| Propriété | Type | Description |
|---|---|---|
| ID | ficelle | Identificateur de l’élément de ligne d’abonnement. |
| nom convivial | ficelle | Nom convivial de l’élément de ligne d’abonnement défini par le partenaire pour aider à lever l’ambiguïté. |
| portée | Étendue | L’étendue indique l’endroit où les avantages s’appliquent. |
| activationRenouvellementAutomatique | Booléen | Obtient une valeur indiquant si l’abonnement est renouvelé automatiquement. |
| statut | ficelle | État de l’abonnement : « aucun », « actif », « en attente », « suspendu », « expiré », « désactivé » ou « supprimé ». |
| engagement d'achat | Engagement d’achat | Montant fixe engagé sur les services de calcul. |
Étendue
L’étendue indique l’endroit où les avantages s’appliquent.
| Propriété | Type | Description |
|---|---|---|
| type | ficelle | Type d’étendue pour un achat : « Unique », « Partagé », « Groupe de ressources » ou « Groupe d’administration ». |
| ID d'abonnement | ficelle | ID du plan Azure qui serait utilisé pour un achat. Obligatoire pour l’étendue partagée. |
| entitlementId | ficelle | ID de l’abonnement Azure qui serait utilisé pour un achat. Obligatoire pour une portée unique. |
| managementGroupId | ficelle | Identifiant du groupe d’administration qui serait utilisé pour un achat. Cette étendue ne peut être sélectionnée qu’aujourd’hui via le portail Azure, mais les mises à jour apparaissent sur le PC. |
| identifiantGroupeDeRessources | ficelle | L'ID du groupe de ressources qui pourrait être utilisé pour un achat. Cette étendue ne peut être sélectionnée qu’aujourd’hui via le portail Azure, mais les mises à jour apparaissent sur le PC. |
Engagement d’achat
Montant fixe engagé sur les services de calcul.
| Propriété | Type | Description |
|---|---|---|
| quantité | ficelle | Engagement de montant fixe. |
| grain | ficelle | Période de l’engagement. |
| monnaie | ficelle | Valeur de l'engagement. |