以异步方式更新客户的资格

以异步方式更新客户的资格。

合作伙伴可以将客户的资格异步更新为“教育”或“GovernmentCommunityCloud”。 无法设置其他值“None”和“非盈利”。

必备条件

• 合作伙伴中心身份验证中所述的凭据。 此方案只支持使用应用凭据和用户凭据进行身份验证。

• 客户 ID (customer-tenant-id)。 如果不知道客户的 ID，则可以在合作伙伴中心仪表板中查找它。 从“合作伙伴中心”菜单中选择“CSP” ，然后选择“客户” 。 从客户列表中选择客户，然后选择“帐户” 。 在客户的帐户页上，在“客户帐户信息”部分查找 Microsoft ID。 Microsoft ID 与客户 ID (customer-tenant-id) 相同。

C#

若要创建客户的“教育”资格，请先创建表示资格类型的对象。 然后，使用客户标识符调用 IAggregatePartner.Customers.ById 方法。 然后使用 “限定” 属性检索 ICustomerQualification 接口。 最后，调用 CreateQualifications() 或 CreateQualificationsAsync() 使用限定类型对象作为输入参数。

var qualificationToCreate = "education";    // can also be "StateOwnedEntity" or "GovernmentCommunityCloud". See GCC example below.
var qualificationType = { Qualification = qualificationToCreate };
var eduCustomerQualification = partnerOperations.Customers.ById(existingCustomer.Id).Qualification.CreateQualifications(qualificationType);

示例： 控制台示例应用。 项目：SdkSamples 类：CreateCustomerQualification.cs

若要在没有资格的情况下将客户的资格更新为 现有客户的 GovernmentCommunityCloud ，还需要合作伙伴包含客户的 ValidationCode。 首先，创建表示限定类型的对象。 然后，使用客户标识符调用 IAggregatePartner.Customers.ById 方法。 然后使用 “限定” 属性检索 ICustomerQualification 接口。 最后，调用 CreateQualifications() 或 CreateQualificationsAsync() 使用限定类型对象和验证代码作为输入参数。

// GCC validation is type ValidationCode
var qualificationType = { Qualification = "GovernmentCommunityCloud" };
var gccCustomerQualification = partnerOperations.Customers.ById(existingCustomer.Id).Qualification.CreateQualifications(qualificationType, gccValidation);

示例： 控制台示例应用。 项目：SdkSamples 类：CreateCustomerQualificationWithGCC.cs

REST 请求

请求语法

方法	请求 URI
POST	{baseURL}/v1/customers/{customer_id}/qualifications？code={validationCode} HTTP/1.1

URI 参数

使用以下查询参数更新限定。

名称	类型	必需	说明
customer-tenant-id	GUID	是	该值是一个 GUID 格式 的客户租户 ID ，允许经销商筛选属于经销商的给定客户的结果。
validationCode	int	否	仅适用于政府社区云。

请求标头

有关详细信息，请参阅合作伙伴中心 REST 标头。

请求正文

下表描述了请求正文中的限定对象。

属性	类型	必需	说明
Qualification	string	是	CustomerQualification 枚举中的字符串值。

请求示例

POST https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/qualifications?code=<validation-code> HTTP/1.1
Accept: application/json
Content-Type: application/json
MS-CorrelationId: 7d2456fd-2d79-46d0-9f8e-5d7ecd5f8745
MS-RequestId: 037db222-6d8e-4d7f-ba78-df3dca33fb68

{
    "Qualification": "Education"
}

REST 响应

如果成功，此方法在响应正文中返回限定对象。 下面是对客户 (的 POST 呼叫示例，其前一个资格为 “无 ”) ，具有 教育 资格。

响应的成功和错误代码

每个响应都带有一个 HTTP 状态代码，用于指示成功或失败以及其他调试信息。 请使用网络跟踪工具来读取此代码、错误类型和其他参数。 有关完整列表，请参阅错误代码。

响应示例

HTTP/1.1 201 CREATED
Content-Length: 29
Content-Type: application/json
MS-CorrelationId: 7d2456fd-2d79-46d0-9f8e-5d7ecd5f8745
MS-RequestId: 037db222-6d8e-4d7f-ba78-df3dca33fb68
{
    "qualification": "Education",
    "vettingStatus": "InReview",
    "vettingCreateDate": "2020-12-04T20:54:24Z" // UTC
}

相关文章

• 获取客户的资格
• 获取合作伙伴的验证码