Пространство имен: microsoft.graph
Важно!
API версии /beta
в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Обновите пароль пользователя , выполнившего вход. Любой пользователь может обновить свой пароль без принадлежности к роли администратора.
Этот API доступен в следующих национальных облачных развертываниях.
Глобальная служба |
Правительство США L4 |
Правительство США L5 (DOD) |
Китай управляется 21Vianet |
✅ |
✅ |
✅ |
✅ |
Разрешения
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
Тип разрешения |
Разрешения с наименьшими привилегиями |
Более высокие привилегированные разрешения |
Делегированные (рабочая или учебная учетная запись) |
Directory.AccessAsUser.All |
Недоступно. |
Делегированные (личная учетная запись Майкрософт) |
Не поддерживается. |
Не поддерживается. |
Для приложений |
Не поддерживается. |
Не поддерживается. |
HTTP-запрос
POST /me/changePassword
Примечание.
Для вызова конечной точки /me
требуется вход пользователя и, следовательно, делегированное разрешение. Разрешения приложений не поддерживаются при использовании конечной /me
точки.
Текст запроса
В тексте запроса предоставьте JSON-объект с указанными ниже параметрами.
Параметр |
Тип |
Описание |
currentPassword |
String |
Ваш текущий пароль. |
newPassword |
String |
Новый пароль. |
Отклик
В случае успешного выполнения этот метод возвращает код отклика 204 No Content
.
Пример
В следующем примере показан запрос на обновление собственного пароля.
Запрос
POST https://graph.microsoft.com/beta/me/changePassword
Content-type: application/json
{
"currentPassword": "xWwvJ]6NMw+bWH-d",
"newPassword": "0eM85N54wFxWwvJ]"
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.Me.ChangePassword;
var requestBody = new ChangePasswordPostRequestBody
{
CurrentPassword = "xWwvJ]6NMw+bWH-d",
NewPassword = "0eM85N54wFxWwvJ]",
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Me.ChangePassword.PostAsync(requestBody);
mgc-beta users change-password post --user-id {user-id} --body '{\
"currentPassword": "xWwvJ]6NMw+bWH-d",\
"newPassword": "0eM85N54wFxWwvJ]"\
}\
'
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
graphusers "github.com/microsoftgraph/msgraph-beta-sdk-go/users"
//other-imports
)
requestBody := graphusers.NewItemChangePasswordPostRequestBody()
currentPassword := "xWwvJ]6NMw+bWH-d"
requestBody.SetCurrentPassword(¤tPassword)
newPassword := "0eM85N54wFxWwvJ]"
requestBody.SetNewPassword(&newPassword)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
graphClient.Me().ChangePassword().Post(context.Background(), requestBody, nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
com.microsoft.graph.beta.users.item.changepassword.ChangePasswordPostRequestBody changePasswordPostRequestBody = new com.microsoft.graph.beta.users.item.changepassword.ChangePasswordPostRequestBody();
changePasswordPostRequestBody.setCurrentPassword("xWwvJ]6NMw+bWH-d");
changePasswordPostRequestBody.setNewPassword("0eM85N54wFxWwvJ]");
graphClient.me().changePassword().post(changePasswordPostRequestBody);
const options = {
authProvider,
};
const client = Client.init(options);
const changePassword = {
currentPassword: 'xWwvJ]6NMw+bWH-d',
newPassword: '0eM85N54wFxWwvJ]'
};
await client.api('/me/changePassword')
.version('beta')
.post(changePassword);
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Users\Item\ChangePassword\ChangePasswordPostRequestBody;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new ChangePasswordPostRequestBody();
$requestBody->setCurrentPassword('xWwvJ]6NMw+bWH-d');
$requestBody->setNewPassword('0eM85N54wFxWwvJ]');
$graphServiceClient->me()->changePassword()->post($requestBody)->wait();
Import-Module Microsoft.Graph.Beta.Users.Actions
$params = @{
currentPassword = "xWwvJ]6NMw+bWH-d"
newPassword = "0eM85N54wFxWwvJ]"
}
# A UPN can also be used as -UserId.
Update-MgBetaUserPassword -UserId $userId -BodyParameter $params
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.users.item.change_password.change_password_post_request_body import ChangePasswordPostRequestBody
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = ChangePasswordPostRequestBody(
current_password = "xWwvJ]6NMw+bWH-d",
new_password = "0eM85N54wFxWwvJ]",
)
await graph_client.me.change_password.post(request_body)
Отклик
HTTP/1.1 204 No Content
Связанные материалы