[Aperçu] Mettre à jour le mot de passe de l'utilisateur

Référence d’API pour la mise à jour du mot de passe d’un compte utilisateur spécifié

Modifie le mot de passe de l’utilisateur IAM spécifié.

Point de terminaison de l’API

POST https://{yourDomain}/identity/api/User/{userId}/changepassword

Étendues

Nécessite les étendues suivantes :

• PM.User
• PM.User.Write

En-têtes de requête.

--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json'

Remarque :

Pour obtenir le {access_token}, assurez-vous de vous authentifier via l'une des méthodes décrites ici.

Paramètres de chemin d'accès

Paramètre du chemin d'accès	Type de données	Description
userId (requis)	Chaîne de caractères (string)	L'ID de l'utilisateur pour lequel vous souhaitez mettre à jour le mot de passe.

Corps de la requête

Le corps de la demande contient l'ID de l'organisation à laquelle ajouter l'utilisateur et, éventuellement, les groupes que vous souhaitez attribuer pour ajouter votre utilisateur.

{
  "oldPassword": "string",
  "newPassword": "string"
}

Réponses

200 OK

L'utilisateur est créé dans l'organisation indiquée et obtient un ID.

400 Requête incorrecte

Impossible de créer le défaut.

{
    "errors": {
        "bypassBasicAuthRestriction": [
            "Unexpected character encountered while parsing value: h. Path 'bypassBasicAuthRestriction', line 17, position 35.",
            "Unexpected character encountered while parsing value: a. Path 'bypassBasicAuthRestriction', line 17, position 35."
        ]
    },
    "type": "https://tools.ietf.org/html/rfc7231#section-6.5.1",
    "title": "One or more validation errors occurred.",
    "status": 400,
    "traceId": "00-aec3de9099a9934e9c31e26c19f5e0dd-8c0d3d5f476c7742-00"
}

Exemple de requête

Supposons que vous ayez rassemblé toutes les informations nécessaires pour créer l'appel d'API.

• Votre {baseURL} est : https://{yourDomain}/{organizationName}/{tenantName}/
• Votre {access_token} est : 1234 (pour des considérations de longueur).
• Le {userId} est : har-3107

L’appel devrait ressembler à l'exemple ci-dessous (cURL) :

curl --location --request POST 'https://{yourDomain}/{organizationName}/{tenantName}/identity_/api/User/har-3107/changepassword' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'
--data-raw '{
  "oldPassword": "al0h0m0ra-account",
  "newPassword": "patr0nu5"
}'

Voici la réponse pour un appel réussi :

{
    "succeeded": true,
    "errors": []
}