更新 SelfServePolicy
本文介绍如何更新自助服务策略。
必备条件
- 合作伙伴中心身份验证中所述的凭据。 此方案支持使用 Application+User 凭据进行身份验证。
C#
若要更新自助服务策略,请执行以下操作:
使用实体标识符调用 IAggregatePartner.SelfServePolicies.ById 方法,以检索策略操作的接口。
// IAggregatePartner partnerOperations;
SelfServePolicy policy;
// All the operations executed on this partner operation instance will share the same correlation identifier but will differ in request identifier
IPartner scopedPartnerOperations = partnerOperations.With(RequestContextFactory.Instance.Create(Guid.NewGuid()));
// updates the self-serve policies
partnerOperations.SelfServePolicies.ById(policy.id).Put(policy);
REST 请求
请求语法
方法 | 请求 URI |
---|---|
PUT | {baseURL}/v1/SelfServePolicy HTTP/1.1 |
请求标头
- 请求标识符和相关标识符是必需的。
- 有关详细信息,请参阅合作伙伴中心 REST 标头。
请求正文
下表描述了请求正文中的必需属性。
名称 | 类型 | 说明 |
---|---|---|
SelfServePolicy | object | 自助服务策略信息。 |
SelfServePolicy
下表描述了创建新的自助服务策略所需的 SelfServePolicy 资源中的最小必填字段。
properties | 类型 | 说明 |
---|---|---|
id | string | 成功创建自助服务策略时提供的自助服务策略标识符。 |
SelfServeEntity | SelfServeEntity | 正在被授予访问权限的自助服务实体。 |
授权者 | 授权者 | 授予访问权限的授权者。 |
权限 | 权限的数组 | 权限资源的数组。 |
ETag | string | Etag。 |
请求示例
PUT https://api.partnercenter.microsoft.com/v1/SelfServePolicy HTTP/1.1
Authorization: Bearer <token>
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Connection: Keep-Alive
{
"id": "634f6379-ad54-449b-9821-564f737158ab_0431a72c-7d8a-4393-b25e-ef63f5efb415",
"selfServeEntity": {
"selfServeEntityType": "customer",
"tenantID": "0431a72c-7d8a-4393-b25e-ef63f5efb415"
},
"grantor": {
"grantorType": "billToPartner",
"tenantID": "634f6379-ad54-449b-9821-564f737158ab"
},
"permissions": [
{
"resource": "AzureReservedInstances",
"action": "Purchase"
},
{
"resource": "AzureSavingsPlan",
"action": "Purchase"
}
],
"attributes": {
"etag": "\"933523d1-3f63-4fc3-8789-5e21c02cdaed\"",
"objectType": "SelfServePolicy"
}
}
REST 响应
如果成功,此 API 将返回更新的自助服务策略的 SelfServePolicy 资源。
响应的成功和错误代码
每个响应都带有一个 HTTP 状态代码,用于指示成功或失败以及其他调试信息。 请使用网络跟踪工具来读取此代码、错误类型和其他参数。 如需完整列表,请参阅合作伙伴中心 REST 错误代码。
此方法返回以下错误代码:
HTTP 状态代码 | 错误代码 | 说明 |
---|---|---|
404 | 600039 | 找不到自助服务策略 |
404 | 600040 | 自助服务策略标识符不正确 |
响应示例
HTTP/1.1 200 Ok
Content-Length: 834
Content-Type: application/json; charset=utf-8
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
Date: Tue, 14 Feb 2017 20:06:02 GMT
{
"id": "634f6379-ad54-449b-9821-564f737158ab_0431a72c-7d8a-4393-b25e-ef63f5efb415",
"selfServeEntity": {
"selfServeEntityType": "customer",
"tenantID": "0431a72c-7d8a-4393-b25e-ef63f5efb415"
},
"grantor": {
"grantorType": "billToPartner",
"tenantID": "634f6379-ad54-449b-9821-564f737158ab"
},
"permissions": [
{
"resource": "AzureReservedInstances",
"action": "Purchase"
},
{
"resource": "AzureSavingsPlan",
"action": "Purchase"
}
],
"attributes": {
"etag": "\"1ec98034-a249-46f4-b9dd-9cd464fb5e47\"",
"objectType": "SelfServePolicy"
}
}
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈