Provisionner un nouvel abonnement

Article
08/24/2015

S’applique à : Windows Azure Pack

Provisionne un nouvel abonnement.

Requête

Remplacez <ServiceMgmt> par votre adresse de point de terminaison de l’API Gestion des services.

Méthode	URI de demande	Version HTTP
POST	<https:// ServiceMgmt>:30004/subscriptions	HTTP/1.1

En-têtes de requête

Le tableau suivant décrit les en-têtes de demande obligatoires ou facultatifs.

En-tête de requête	Description
Autorisation : porteur	Obligatoire. Jeton du porteur d’autorisation.
x-ms-principal-id	Obligatoire. Identificateur du principal.
x-ms-client-request-id	facultatif. Identificateur de demande client.
x-ms-client-session-id	facultatif. Identificateur de session client.
x-ms-principal-liveid	facultatif. Identificateur live du principal.

Corps de la demande

Le tableau suivant décrit les éléments du corps de la demande.

Nom de l'élément	Description
AccountAdminLiveId	Identificateur de compte Microsoft de l’administrateur de compte. Non requis pour l’approvisionnement d’abonnements. Utilisez null.
AccountAdminLivePuid	Identificateur de compte Passport de l’administrateur de compte. Il doit s’agir d’un compte d’utilisateur existant. Vous pouvez utiliser Récupérer un utilisateur pour déterminer si le compte existe.
AccountId	Identificateur du compte. Utilisez Guid.Empty.
FriendlyName	Nom convivial de l’abonnement.
OfferCategory	Catégorie d’offre. Utilisez null.
OfferInfo	Informations sur l’offre. Utilisez null.
OfferType	Type d’offre. Utilisez 0.
ReasonCode	Code de raison. Utilisez null.
ServiceAdminLiveEmailId	Identificateur de compte Microsoft de l’administrateur de service. Cette valeur n’est pas utilisée par Windows Azure Pack et est requise uniquement à des fins de cohérence. Utilisez null.
ServiceAdminLivePuid	Identificateur du compte Passport de l’administrateur de service. Non requis pour l’approvisionnement d’abonnements. Utilisez null.
SubscriptionId	Identificateur d’abonnement. Il est exprimé sous la forme d’une chaîne GUID. Utilisez Guid.NewGuid(). ToString() pour créer une valeur de chaîne GUID appropriée.
Statut	État de l'abonnement. Utilisez null.
PlanId	Identificateur du plan auquel le plan est abonné. Il s’agit de la propriété Plan (objet Administrator)Id .
CoAdminNames	Liste des coadministrateurs. Utilisez null si aucun coadministrateur n’existe. Les coadministrateurs n’ont pas besoin d’être connus du système. Lorsque le compte coadministrateur est créé par la suite, l’abonnement est automatiquement appliqué au coadministrateur.

response

La réponse inclut un code d'état HTTP, un ensemble d'en-têtes de réponse et un corps de réponse.

Code d’état

Une opération réussie envoie le code d'état 200 (OK).

Pour plus d’informations sur les codes d’état, consultez Status and Error Codes (Windows Azure Pack Service Management).

En-têtes de réponse

La réponse de cette opération inclut des en-têtes HTTP standard. Tous les en-têtes standard sont conformes à la spécification du protocole HTTP/1.1.

Corps de la réponse

Le tableau suivant décrit les éléments clés du corps de la réponse.

Nom de l'élément	Description
AdminSubscription	Abonnement provisionné. Pour plus d’informations, consultez AdminSubscription (objet Administrator).

Exemple

L’exemple de code suivant montre une demande d’abonnement d’approvisionnement .

POST https://<Computer>:30004/subscriptions HTTP/1.1
Authorization: Bearer 
x-ms-client-request-id: cf5bca16-e945-42ab-a934-af462fd70aca-2014-04-15 20:37:33Z
x-ms-client-session-id: b5488aa5-137e-443e-be88-407ab0db068d
x-ms-principal-id: <COMPUTER>Administrator
Accept-Language: en-US
Content-Type: application/json; charset=utf-8
Host: <COMPUTER>:30004
Content-Length: 428
Expect: 100-continue
{
  "AccountAdminLiveEmailId": "User@Contoso.com",
  "AccountAdminLivePuid": "user@contoso.com",
  "AccountId": "00000000-0000-0000-0000-000000000000",
  "FriendlyName": "c23",
  "OfferCategory": null,
  "OfferInfo": null,
  "OfferType": 0,
  "ReasonCode": null,
  "ServiceAdminLiveEmailId": "User@Contoso.com",
  "ServiceAdminLivePuid": "user@contoso.com",
  "SubscriptionId": "2ad337ed-c99f-40d1-9645-670b4bdb5016",
  "Status": null,
  "PlanId": "chtm4uwen",
  "CoAdminNames": null
}

L’exemple suivant montre un corps de réponse Provision Subscription.

{
  "SubscriptionID": "2ad337ed-c99f-40d1-9645-670b4bdb5016",
  "SubscriptionName": "c23",
  "AccountAdminLiveEmailId": "user@contoso.com",
  "ServiceAdminLiveEmailId": null,
  "CoAdminNames": [

  ],
  "AddOnReferences": [

  ],
  "AddOns": [

  ],
  "State": 1,
  "QuotaSyncState": 0,
  "ActivationSyncState": 1,
  "PlanId": "chtm4uwen",
  "Services": [
    {
      "Type": "sqlservers",
      "State": "registered",
      "QuotaSyncState": 0,
      "ActivationSyncState": 1,
      "BaseQuotaSettings": [
        {
          "Key": "Editions",
          "Value": "[{\"displayName\":\"Default\",\"groupName\":\"Default\",\"resourceCount\":\"10\",\"resourceSize\":\"1024\",\"resourceSizeLimit\":\"1024\",\"offerEditionId\":\"032814080310\",\"groupType\":null}]"
        }
      ]
    }
  ],
  "LastErrorMessage": null,
  "Features": null,
  "OfferFriendlyName": "c23",
  "OfferCategory": null,
  "Created": "2014-04-15T20:37:39.223"
}

Remarques

Lorsqu’un utilisateur est créé dans le Windows Azure Pack pour Windows portail de gestion de l’administrateur de serveur, un abonnement à un plan est provisionné. La procédure est la suivante.

Collectez les informations utilisateur et le plan souhaité. Pour l’utilisateur, une adresse e-mail et un mot de passe sont requis. L’utilisateur est abonné à un plan initialement. Une liste des plans disponibles est obtenue en appelant Récupérer les plans disponibles. La propriété ID du plan souhaité (objet Administrateur) sera nécessaire pour appeler Provisionner un nouvel abonnement.
Appelez Récupérer un utilisateur pour déterminer si l’utilisateur demandé existe déjà.
Provisionnez l’abonnement à l’aide de Provisionner un nouvel abonnement.

Voir aussi

Interfaces d’abonnement administrateur

Partager via