Zum Hauptinhalt springen

GET/POST – Sammlung für Konten

Verwenden Sie die GET/POST-Methode, um Eigenschaften in der Kontosammlung für den Redfish-Dienst abzurufen.

Anforderungs-URL​

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

Anforderungstext​

Keine

Antworttext​

Feld

Typ

Beschreibung

Description

Zeichenkette

„BMC-Benutzeraccounts“

Members

Array

Elemente: Link

Anzahl der Elemente: 1~15

 

Members[N]

Link

Links zu Instanzen von Benutzeraccountressourcen.

  

@odata.id

Zeichenkette

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

Name

Zeichenkette

Accounts Collection

REST-Vorgang – POST​

VorgangEigenschaftenKommentar
POST

UserName

Die Länge sollte zwischen 1 und 16 liegen. Zulässige Zeichen: noch festzulegen
  • „ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789._-“

Password

Wenn ein leeres Kennwort nicht zulässig ist, sollte die Kennwortlänge zwischen dem Wert von PasswordLength in AccountService und 20 liegen. Zulässige Zeichen: noch festzulegen
  • „ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz~!@#$%^&*()-+={}[]|:;\”’<>,?/._0123456789“
Anmerkung
Wenn das Kennwort länger als 20 Zeichen ist, können die Anmeldeinformationen nicht auf IPMI zugreifen. Wenn das Kennwort auf 20 Zeichen oder weniger als 20 Zeichen zurückgesetzt wird, können die Anmeldeinformationen wieder auf IPMI zugreifen.

RoleId

Muss die RoleId-Eigenschaft einer vorhandenen Rollenressource sein.
Anmerkung
RoleId darf nicht auf „Administrator+“ festgelegt werden.

PasswordChangeRequired

Anmerkung
  • Wenn es Redfish-Sitzungen gibt, die von einem Konto mit POST erstellt wurden, laufen die Redfish-Sitzungen, bei denen der Benutzer beim Zugriff auf den Dienst den Fehler „403 (Verboten)“ erhält, ebenfalls sofort ab, wenn das Konto gelöscht wird. Redfish-Sitzungen, bei denen der Benutzer Zugriff auf den Dienst hat, bleiben jedoch aktiv und der Zugriff wird gewährt, bis das Sitzungszeitlimit erreicht ist.
  • Wenn Sie POST zum Erstellen eines Kontos verwenden, ist der Eingabeparameter „Aktiviert“ optional und der Standardwert ist true.

AccountTypes

[„WebUI“, „Redfish“, „IPMI“]. „WebUI“ und „Redfish“ sollten gleichzeitig in diesem Feld vorhanden sein. Wenn diese nicht festgelegt sind, lauten die Standardkontotypen [„WebUI“, „Redfish“, „IPMI“]

Um ein Konto zu erstellen, müssen UserName, Password und RoleId im Anforderungstext angegeben werden. PrivacyProtocolPassword ist obligatorisch, wenn beim Erstellen eines SNMP-Kontos ein bestimmtes EncryptionProtocol (nicht „None“) angegeben wird.

Wenn bei REST ein Fehler auftritt oder die Anforderung nicht abgeschlossen werden kann, wird „500 Interner Serverfehler“ zurückgegeben, Änderungen an den gültigen Eigenschaften werden jedoch nicht rückgängig gemacht.

Anmerkung

  • Basierend auf der DMTF Redfish-Spezifikation DSP0266 kann der Benutzer beim Patchen einer Benutzerressource den Etag-Wert angeben. Mit anderen Worten, der Dienst erlaubt es dem Benutzer, Etag nicht in der Kopfzeile einer PATCH-Anforderung anzugeben, aber wenn der Benutzer Etag angibt, wird der Dienst den Etag-Wert vor der Aktualisierung validieren.

Statuscode​

HTTP-StatuscodeFehlernachrichten-ID
500Interner Fehler