Dela via


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
}

Se även

Vanliga användargränssnitt