[comment]: # translation:outdated

[comment]: # ({f912816c-e746444a})
# mfa.update

[comment]: # ({/f912816c-e746444a})

[comment]: # ({1b80078d-ee53ce7f})
### Beschreibung

`object mfa.update(object/array MFA methods)`

Diese Methode ermöglicht die Aktualisierung vorhandener MFA-Methoden.

::: noteclassic
Diese Methode ist nur für den Benutzertyp *Super admin* verfügbar.
Die Berechtigungen zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle entzogen werden.
Weitere Informationen finden Sie unter [Benutzerrollen](/manual/web_interface/frontend_sections/users/user_roles).
:::

[comment]: # ({/1b80078d-ee53ce7f})

[comment]: # ({868e083d-f56c8360})
### Parameter

`(object/array)` Zu aktualisierende Eigenschaften der MFA-Methode.

Die Eigenschaft `mfaid` muss für jedes Element definiert werden, alle anderen Eigenschaften sind optional.
Nur die übergebenen Eigenschaften werden aktualisiert, alle anderen bleiben unverändert.

Die Methode akzeptiert MFA-Methoden mit den [Standard-Eigenschaften der MFA-Methode](/manual/api/reference/mfa/object#mfa).

[comment]: # ({/868e083d-f56c8360})

[comment]: # ({58808643-bef7411b})
### Rückgabewerte

`(object)` Gibt ein Objekt zurück, das die IDs der aktualisierten MFA-Methoden unter der Eigenschaft `mfaids` enthält.

[comment]: # ({/58808643-bef7411b})

[comment]: # ({b41637d2-d2694a5b})
### Beispiele

[comment]: # ({/b41637d2-d2694a5b})

[comment]: # ({67a32e97-293227b3})
#### Eigenschaften der Methode aktualisieren

Aktualisieren Sie die Hash-Funktion zur Generierung von TOTP-Codes sowie die Länge des Verifizierungscodes für die MFA-Methode „Zabbix TOTP“, die zeitbasierte Einmalpasswörter (TOTP) verwendet.

[Anfrage](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "mfa.update",
    "params": {
        "mfaid": "1",
        "hash_function": 3,
        "code_length": 8
    },
    "id": 1
}
```

Antwort:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "mfaids": [
            "1"
        ]
    },
    "id": 1
}
```

[comment]: # ({/67a32e97-293227b3})

[comment]: # ({d257758d-55e7adae})
### Quelle

CMfa::update() in *ui/include/classes/api/services/CMfa.php*.

[comment]: # ({/d257758d-55e7adae})