Skapa en användare
Gäller för: Windows Azure Pack
Skapar en användare.
Förfrågan
Ersätt <ServiceMgmt> med din Service Management API-slutpunktsadress. . Ersätt <Port> med antingen 30005 för klient-API:et eller 30004 för administratörs-API:et.
Metod |
URI för förfrågan |
HTTP-version |
---|---|---|
POST |
<https:// ServiceMgmt>:<Port>/users |
HTTP/1.1 |
URI-parametrar
Inga.
Rubriker för begäran
I följande tabell beskrivs obligatoriska och valfria begärandehuvuden.
Begärandehuvud |
Beskrivning |
---|---|
Auktorisering: Ägarna |
Krävs. Ägartoken för auktorisering. |
x-ms-principal-id |
Krävs. Huvudidentifieraren. |
x-ms-client-request-id |
Valfritt. Identifierare för klientbegäran. |
x-ms-client-session-id |
Valfritt. Klientsessionsidentifieraren. |
x-ms-principal-liveid |
Valfritt. Live-huvudidentifieraren. |
Begärandetext
I följande tabell beskrivs elementen i begärandetexten.
Elementnamn |
Beskrivning |
---|---|
Användare |
Den information som används för att skapa användaren. Mer information finns i Användare (vanligt objekt). |
Svarsåtgärder
Svaret innehåller en HTTP-statuskod, en uppsättning svarshuvuden och en svarstext.
Statuskod
En lyckad åtgärd returnerar statuskoden 201 (skapad).
Information om statuskoder finns i Status- och felkoder (Windows Azure Pack Service Management).
Svarsrubriker
Svaret för den här åtgärden innehåller HTTP-standardhuvuden. Alla standardhuvuden överensstämmer med http/1.1-protokollspecifikationen.
Svarstext
I följande tabell beskrivs de viktigaste elementen i svarstexten:
Elementnamn |
Beskrivning |
---|---|
Användare |
Den skapade användaren. Mer information finns i Användare (vanligt objekt). |
Exempel
I följande kodexempel visas en begäran om att skapa användare .
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
}
I följande kodexempel visas svaret Skapa användare .
{
"Name": "aaa@bbb.com",
"Email": "aaa@bbb.com",
"State": 1,
"CreatedTime": "2013-06-27T21:15:30.787",
"SubscriptionCount": 0,
"ActivationSyncState": 0,
"LastErrorMessage": null
}