Aller au contenu principal

GET / POST – Ensemble pour les comptes

Utilisez la méthode GET / POST pour récupérer les propriétés dans l’ensemble de comptes pour le service Redfish.

URL de demande

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

Corps de la demande

Aucune

Corps de la réponse

Zone

Type

Description

Description

Chaîne

« Comptes d’utilisateurs BMC »

Members

Tableau

Éléments : lien

Nombre d’article(s) : 1~15

 

Members[N]

lien

Liens vers des instances de ressources de comptes d’utilisateur.

  

@odata.id

Chaîne

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

Name

Chaîne

Accounts Collection

Opération REST — POST

OpérationPropriétésCommentaire
POST

UserName

La longueur doit être comprise entre 1 et 16. Caractères autorisés : TBD
  • « ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789._- »

Password

Si le mot de passe ne peut pas être vide, la longueur du mot de passe doit être comprise entre la valeur de PasswordLength dans AccountService et 20. Caractères autorisés : à déterminer
  • « ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz~ !@#$%^&*()-+={}[]| :;\"'<>, ?/._0123456789 »
Remarque
Si le mot de passe dépasse 20 caractères, les informations d’identification ne permettront pas d'accéder à IPMI. Si le mot de passe est défini sur une valeur égale ou inférieure à 20 caractères, les informations d’identification permettront à nouveau d'accéder à IPMI.

RoleId

Il doit s’agir de la propriété RoleId d’une ressource de rôle existante.
Remarque
RoleId ne doit pas être défini sur « Administrator+ ».

PasswordChangeRequired

Remarque
  • Si des sessions Redfish sont créées par POST à partir d’un compte, une fois ce dernier supprimé, les sessions Redfish, avec lesquelles l’utilisateur reçoit un message 403 (interdit) lors de l’accès au service, expireront également immédiatement. Les sessions Redfish, avec lesquelles l’utilisateur est autorisé à accéder au Service, demeureront actives et l’accès leur sera accordé jusqu’à ce que la limite du délai d’expiration de la session soit atteinte.
  • En utilisant POST pour créer un compte, le paramètre d’entrée « Activé » est facultatif et la valeur par défaut est true.

AccountTypes

[« WebUI », « Redfish », « IPMI »]. « WebUI » et « Redfish » doivent être présents en même temps dans ce champ. S’ils ne sont pas définis, les types de compte par défaut sont [« WebUI », « Redfish », « IPMI »]

Pour créer un compte, UserName, le mot de passe et RoleId doivent être spécifiés dans le corps de la demande. PrivacyProtocolPassword est obligatoire si un certain EncryptionProtocol est spécifié (et non « None ») lors de la création d’un compte SNMP.

Si REST présente une erreur ou ne peut pas terminer la demande, le message « Erreur interne du serveur 500 » est renvoyé. Toutefois, les modifications apportées aux propriétés valides ne sont pas annulées.

Remarque
  • Sur la base de la spécification DMTF Redfish DSP0266, l’utilisateur peut fournir la valeur « Etag » lorsqu’il modifie une ressource d’utilisateur. En d’autres termes, le service permet à l’utilisateur de ne pas fournir d’Etag dans l’en-tête d’une requête PATCH. Si l’utilisateur fournit ces renseignements, le service valide la valeur Etag avant la mise à jour.

Code d’état

Code d’état HTTPID de message d’erreur
500Erreur interne