Saltar al contenido principal

GET / POST – Recolección para cuentas

Utilice el método GET / POST para recuperar propiedades en la recopilación de cuentas para el servicio Redfish.

URL de la solicitud

https://<SMM_IPADDR>/redfish/v1/AccountService/Accounts

Cuerpo de la solicitud

Ninguno

Cuerpo de la respuesta

Campo

Tipo

Descripción

Description

Cadena

“Cuentas de usuario de BMC”

Members

Matriz

Artículos: enlace

Número de elementos: 1~15

 

Members[N]

enlace

Enlaces a instancias de recursos de cuenta de usuario.

  

@odata.id

Cadena

“/redfish/v1/AccountService/Accounts/{id}”

Name

Cadena

Accounts Collection

Operación REST — POST

OperaciónPropiedadesComentario
POST

UserName

Debe tener entre 1 y 16 de longitud. Caracteres permitidos: TBD
  • “ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789._-”

Password

Si no se permite una contraseña vacía, la longitud de la contraseña debe ser de entre el valor de PasswordLength en AccountService y 20. Caracteres permitidos: TBD
  • “ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz~!@#$%^&*()-+={}[]|:;\"'<>,?/._0123456789”
Nota
Si la contraseña se establece por encima de los 20 caracteres, la credencial no podrá acceder a IPMI. Si la contraseña se vuelve a establecer en un valor igual o inferior a 20 caracteres, la credencial podrá volver a acceder a IPMI.

RoleId

Debe ser la propiedad RoleId de un recurso Rol existente.
Nota
RoleId no se debe establecer con el valor “Administrator+”.

PasswordChangeRequired

Nota
  • Si existen sesiones de Redfish creadas en POST desde una cuenta, al eliminar la cuenta, las sesiones de Redfish con las que el usuario obtiene un error 403 (Prohibido) al acceder al servicio también dejarán de funcionar inmediatamente. Las sesiones de Redfish con las que el usuario puede acceder al servicio seguirán activas, y se les concederá acceso hasta que se alcance el límite de tiempo de espera de la sesión.
  • Al usar POST para crear una cuenta, el parámetro de entrada “Enabled” es opcional y el valor predeterminado es “true”.

AccountTypes

[“WebUI”, “Redfish”, “IPMI”]. “WebUI” y “Redfish” deben existir al mismo tiempo en este campo. Si no se establece, los tipos de cuenta predeterminados son ["WebUI", "Redfish", "IPMI"]

Para crear una cuenta, el UserName, la contraseña y el RoleId se deben especificar en el cuerpo de la solicitud. PrivacyProtocolPassword es obligatorio si se especifica un EncryptionProtocol determinado (que no sea “None”) al crear una cuenta SNMP.

Si REST encuentra un error o no puede completar la solicitud, devolverá “500 Error interno del servidor”, pero los cambios realizados en las propiedades válidas no se revertirán.

Nota
  • Según la especificación DSP0266 de DMTF Redfish, el usuario puede proporcionar el valor Etag al parchear un recurso de usuario. En otras palabras, el servicio permite que el usuario no proporcione un Etag en el encabezado de una solicitud PATCH, pero, si el usuario proporciona, el servicio validará el valor de Etag antes de hacer la actualización.

Código de estado

Código de estado HTTPID del mensaje de error
500Error interno