Todos los productos
Search
Centro de documentos

Cloud Phone:CreateUsers

Última actualización: Oct 19, 2026

Crea una cuenta de conveniencia para un usuario final.

Descripción de la operación

Una cuenta de conveniencia es un sistema de cuentas dedicado a Wuying Workspace y es adecuado para escenarios sencillos en los que no se desea conectar a un Active Directory (AD) empresarial. La información de la cuenta de conveniencia incluye el nombre de usuario y la dirección de correo electrónico, ambos obligatorios.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

  • Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.

  • API: La API que debe invocarse para llevar a cabo la acción.

  • Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.

  • Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.

    • En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.

    • Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.

  • Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.

  • Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

ecd:CreateUsers

create

*Todos los recursos.

*

Ninguna Ninguna

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

Users

array<object>

Sí

La información de la cuenta de conveniencia.

CreateUsers

object

No

La información de la cuenta de conveniencia.

EndUserId

string

Sí

El nombre de usuario. El nombre de usuario es personalizado y debe tener una longitud de 3 a 24 caracteres. Solo puede contener letras minúsculas, dígitos y guiones bajos (_).

alice

Email

string

No

La dirección de correo electrónico. La dirección de correo electrónico se utiliza para recibir correos relevantes, como notificaciones sobre la asignación de computadoras en la nube. Debe especificar al menos la dirección de correo electrónico o el número de teléfono celular.

username@example.com

Phone

string

No

Los números de teléfono celular no se admiten en el sitio internacional.

1381111****

Password

string

No

La contraseña del usuario.

Nota

La contraseña debe tener al menos 10 caracteres de longitud y debe contener al menos tres de los siguientes tipos de caracteres: letras mayúsculas, letras minúsculas, dígitos y caracteres especiales (excepto espacios).

Wuying1234

OwnerType

string

No

El tipo de activación de la cuenta.

Valores válidos:

  • CreateFromManager :

    activada por el administrador.

  • Normal :

    activada por el usuario.

Normal

OrgId

string

No

La organización a la que pertenece el usuario.

design

Remark

string

No

Los comentarios del usuario.

remark1

RealNickName

string

No

El nombre para mostrar del usuario.

Bean

GroupIdList

array

No

Los ID de los grupos de usuarios a los que se unirá.

string

No

El ID del grupo de usuarios.

ug-2412ojkwtybd****

Password

string

No

La contraseña inicial. Si no especifica este parámetro, se envía un correo electrónico de restablecimiento de contraseña a la dirección de correo electrónico del usuario.

Test123****

AutoLockTime

string

No

La fecha en la que la cuenta se bloquea automáticamente. Especifique la fecha en el formato yyyy-MM-dd HH:mm:ss.

2025-11-28 00:00:00

IsLocalAdmin

boolean

No

Especifica si se debe configurar la cuenta de conveniencia como administrador local.

true

PasswordExpireDays

string

No

El período de validez de la contraseña de la cuenta de usuario. De forma predeterminada, la contraseña es válida permanentemente. Puede establecer este parámetro en un valor de 30 a 365 para especificar un período de validez en días. Una vez que la contraseña caduca, el usuario final debe cambiarla antes de iniciar sesión.

Nota

Esta función se encuentra en versión preliminar por invitación. Para utilizar esta función, envíe un ticket.

30

BusinessChannel

string

No

El canal.

ENTERPRISE

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

La información devuelta.

RequestId

string

El ID de la solicitud.

1CBAFFAB-B697-4049-A9B1-67E1FC5F****

CreateResult

object

El resultado de la operación de creación de la cuenta de conveniencia.

CreatedUsers

array<object>

La información de las cuentas de conveniencia creadas.

object

La información de las cuentas de conveniencia creadas.

EndUserId

string

El nombre de usuario.

test1

Email

string

La dirección de correo electrónico.

username@example.com

Phone

string

El número de teléfono celular.

1381111****

Remark

string

Los comentarios del usuario.

remark1

RealNickName

string

El nombre para mostrar del usuario.

Bean

FailedUsers

array<object>

La información sobre las cuentas de conveniencia que no se crearon correctamente.

object

La información sobre las cuentas de conveniencia que no se crearon correctamente.

EndUserId

string

El nombre de usuario.

test2

Email

string

La dirección de correo electrónico.

username2@example.com

Phone

string

El número de teléfono celular.

1390000****

ErrorCode

string

El código de error.

ExistedEndUserId

ErrorMessage

string

El mensaje de error.

The username test is used by another user.

AllSucceed

boolean

Indica si se crearon todas las cuentas de conveniencia.

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "1CBAFFAB-B697-4049-A9B1-67E1FC5F****",
  "CreateResult": {
    "CreatedUsers": [
      {
        "EndUserId": "test1",
        "Email": "username@example.com",
        "Phone": "1381111****",
        "Remark": "remark1",
        "RealNickName": "Bean"
      }
    ],
    "FailedUsers": [
      {
        "EndUserId": "test2",
        "Email": "username2@example.com",
        "Phone": "1390000****",
        "ErrorCode": "ExistedEndUserId",
        "ErrorMessage": "The username test is used by another user."
      }
    ]
  },
  "AllSucceed": false
}

Códigos de error

Código de estado HTTP

Código de error

Mensaje de error

Descripción

400 INTERNAL_ERROR Internal error.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.