Creación de un usuario
Se aplica a: Windows Azure Pack
Crea un usuario.
Solicitud
Reemplace <ServiceMgmt> por la dirección del punto de conexión de la API de Service Management. . Reemplace <Port> por 30005 para la API de inquilino o 30004 para la API de administrador.
Método |
URI de solicitud |
Versión HTTP |
|---|---|---|
POST |
<https:// ServiceMgmt>:<Port>/users |
HTTP/1.1 |
Parámetros de identificador URI
Ninguno.
Encabezados de solicitud
En la tabla siguiente se describen los encabezados de solicitud requeridos y opcionales.
Encabezado de solicitud |
Descripción |
|---|---|
Autorización: portador |
Obligatorio. Token de portador de autorización. |
x-ms-principal-id |
Obligatorio. El identificador de la entidad de seguridad. |
x-ms-client-request-id |
Opcional. Identificador de solicitud de cliente. |
x-ms-client-session-id |
Opcional. Identificador de sesión de cliente. |
x-ms-principal-liveid |
Opcional. Identificador activo de la entidad de seguridad. |
Cuerpo de la solicitud
En la tabla siguiente se describen los elementos del cuerpo de la solicitud.
Nombre del elemento |
Descripción |
|---|---|
Usuario |
La información utilizada para crear el usuario. Para obtener más información, vea User (Common object) (Usuario [objeto común]). |
Response
La respuesta incluye un código de estado HTTP, un conjunto de encabezados de respuesta y un cuerpo de respuesta.
Código de estado
Una operación correcta devuelve el código de estado 201 (Creado).
Para obtener información sobre los códigos de estado, consulte Códigos de estado y error (Windows Azure Pack Service Management).
Encabezados de respuesta
La respuesta de esta operación incluye encabezados HTTP estándar. Todos los encabezados estándar se ajustan a la especificación del protocolo HTTP/1.1.
Cuerpo de la respuesta
La tabla siguiente describe los elementos clave del cuerpo de la respuesta:
Nombre del elemento |
Descripción |
|---|---|
Usuario |
El usuario creado. Para obtener más información, vea User (Common object) (Usuario [objeto común]). |
Ejemplo
En el ejemplo de código siguiente se muestra una solicitud Crear usuario .
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
}
En el ejemplo de código siguiente se muestra una respuesta Crear usuario .
{
"Name": "aaa@bbb.com",
"Email": "aaa@bbb.com",
"State": 1,
"CreatedTime": "2013-06-27T21:15:30.787",
"SubscriptionCount": 0,
"ActivationSyncState": 0,
"LastErrorMessage": null
}