Création d'un utilisateur
S’applique à : Windows Azure Pack
Créer un utilisateur.
Requête
Remplacez <ServiceMgmt> par votre adresse de point de terminaison de l’API Gestion des services. . Remplacez <le port> par 30005 pour l’API client ou 30004 pour l’API administrateur.
Méthode |
URI de demande |
Version HTTP |
|---|---|---|
POST |
<https:// ServiceMgmt>:<Port>/users |
HTTP/1.1 |
Paramètres URI
Aucun.
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 |
|---|---|
Utilisateur |
Informations utilisées pour créer l’utilisateur. Pour plus d’informations, consultez User (Common object). |
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 renvoie le code d'état 201 (Créé).
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 |
|---|---|
Utilisateur |
Utilisateur créé. Pour plus d’informations, consultez User (Common object). |
Exemple
L’exemple de code suivant montre une requête Créer un utilisateur .
POST https://<Computer>:30004/users HTTP/1.1
Authorization: Bearer <token>
x-ms-client-request-id: 1557497f-2f4c-45b1-a42d-416fff7641a2-2013-06-27 21:15:30Z
x-ms-client-session-id: 9ff600b4-0c8b-4110-9eab-4228ce92aa4d
x-ms-principal-id: <COMPUTER>\Administrator
Accept-Language: en-US
x-ms-principal-liveid: <COMPUTER>\Administrator
Content-Type: application/json; charset=utf-8
Host: <Computer>:30004
Content-Length: 160
Expect: 100-continue
{
"Name": "aaa@bbb.com",
"Email": "aaa@bbb.com",
"State": 1,
"CreatedTime": "0001-01-01T00:00:00",
"SubscriptionCount": 0,
"ActivationSyncState": 0,
"LastErrorMessage": null
}
L’exemple de code suivant montre une réponse Créer un utilisateur .
{
"Name": "aaa@bbb.com",
"Email": "aaa@bbb.com",
"State": 1,
"CreatedTime": "2013-06-27T21:15:30.787",
"SubscriptionCount": 0,
"ActivationSyncState": 0,
"LastErrorMessage": null
}