为客户更新用户帐户
更新客户现有用户帐户中的详细信息。
先决条件
合作伙伴中心身份验证中所述的凭据。 此方案只支持使用应用凭据和用户凭据进行身份验证。
客户 ID (
customer-tenant-id
)。 如果不知道客户的 ID,可以通过选择“客户”工作区,然后从客户列表中选择客户,然后选择“帐户”,在合作伙伴中心中查找该 ID。 在客户的“帐户”页上,在“客户帐户信息”部分查找 Microsoft ID。 Microsoft ID 与客户 ID (customer-tenant-id
) 相同。
GDAP 角色
至少需要以下 GDAP 角色之一:
- 用户管理员
- 目录编写人员
C#
若要更新指定客户用户的详细信息,请先检索要更新的指定客户 ID 和用户。 然后,在新的 CustomerUser 对象中创建用户的更新版本。 然后,使用 IAggregatePartner.Customers 集合并调用 ById() 方法。 然后调用 Users 属性 ById () 方法,后跟 Patch() 方法。
// string selectedCustomerId;
// customerUser specifiedUser;
// IAggregatePartner partnerOperations;
// Updated information
var userToUpdate = new CustomerUser()
{
PasswordProfile = new PasswordProfile() { ForceChangePassword = true, Password = "testPw@!122B" },
DisplayName = "DisplayNameChange",
FirstName = "FirstNameChange",
LastName = "LastNameChange",
UsageLocation = "US",
UserPrincipalName = Guid.NewGuid().ToString("N") + "@" + selectedCustomer.CompanyProfile.Domain.ToString()
};
// Update customer user information
User updatedCustomerUserInfo = partnerOperations.Customers.ById(selectedCustomerId).Users.ById(specifiedUser.Id).Patch(userToUpdate);
示例
控制台测试应用。 项目:PartnerSDK.FeatureSamples 类:CustomerUserUpdate.cs
REST 请求
请求语法
方法 | 请求 URI |
---|---|
PATCH | {baseURL}/v1/customers/{customer-tenant-id}/users HTTP/1.1 |
URI 参数
使用以下查询参数标识正确的客户。
名称 | 类型 | 必需 | 说明 |
---|---|---|---|
customer-tenant-id | Guid | Y | 该值是 GUID 格式 的客户租户 ID ,允许经销商筛选属于经销商的给定客户的结果。 |
user-id | Guid | Y | 该值是属于单个用户帐户的 GUID 格式 的用户 ID 。 |
请求标头
有关详细信息,请参阅合作伙伴中心 REST 标头。
请求示例
PATCH https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/users/<user-id> HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: b1317092-f087-471e-a637-f66523b2b94c
MS-CorrelationId: 8a53b025-d5be-4d98-ab20-229d1813de76
{
"usageLocation": "new country/region code",
"attributes": {
"objectType": "CustomerUser"
}
}
REST 响应
如果成功,此方法将返回包含更新信息的用户帐户。
响应的成功和错误代码
每个响应都带有一个 HTTP 状态代码,用于指示成功或失败以及其他调试信息。 请使用网络跟踪工具来读取此代码、错误类型和其他参数。 有关完整列表,请参阅错误代码。
响应示例
HTTP/1.1 200 OK
Content-Length: 31942
Content-Type: application/json
MS-CorrelationId: 8a53b025-d5be-4d98-ab20-229d1813de76
MS-RequestId: b1317092-f087-471e-a637-f66523b2b94c
Date: June 24 2016 22:00:25 PST
{
"usageLocation": "new country/region code",
"id": "4b10bf41-ab11-40e3-8c53-cd67849b50de",
"userPrincipalName": "emailidchange@abcdefgh1234.onmicrosoft.com",
"firstName": "FirstNameChange",
"lastName": "LastNameChange",
"displayName": "DisplayNameChange",
"userDomainType": "none",
"state": "active",
"links": {
"self": {
"uri": "/customers/eebd1b55-5360-4438-a11d-5c06918c3014/users/4b10bf41-ab11-40e3-8c53-cd67849b50de",
"method": "GET",
"headers": [
]
}
},
"attributes": {
"objectType": "CustomerUser"
}
}
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈