SelfServePolicy を更新するUpdate a SelfServePolicy

適用対象:Applies to:

  • パートナー センターPartner Center

このトピックでは、セルフサービスポリシーを更新する方法について説明します。This topic explains how to update a self-serve policy.

前提条件Prerequisites

  • パートナー センターの認証に関するページで説明している資格情報。Credentials as described in Partner Center authentication. このシナリオでは、アプリケーション + ユーザー資格情報による認証がサポートされています。This scenario supports authentication with Application+User credentials.

C#C#

セルフサービスポリシーを削除するには:To delete a self-serve policy:

  1. エンティティ識別子を使用して iaggregatepartner.customers メソッドを呼び出し、ポリシーに対する操作へのインターフェイスを取得します。Call the IAggregatePartner.SelfServePolicies.ById method with the entity identifier to retrieve an interface to operations on the policies.

  2. Putまたは putasyncメソッドを呼び出して、セルフサービスポリシーを更新します。Call the Put or PutAsync method to update the self-serve policy.

// 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 要求REST request

要求の構文Request syntax

認証方法Method 要求 URIRequest URI
PUTPUT {baseURL}/v1/SelfServePolicy HTTP/1.1{baseURL}/v1/SelfServePolicy HTTP/1.1

要求ヘッダーRequest headers

[要求本文]Request body

次の表では、要求本文に必要なプロパティについて説明します。This table describes the required properties in the request body.

名前Name TypeType 説明Description
SelfServePolicySelfServePolicy オブジェクトobject セルフサービスポリシー情報。The self-serve policy information.

SelfServePolicySelfServePolicy

次の表では、新しいセルフサービスポリシーを作成するために必要な SelfServePolicy リソースの最小限の必須フィールドについて説明します。This table describes the minimum required fields from the SelfServePolicy resource needed to create a new self-serve policy.

プロパティProperty TypeType 説明Description
idid stringstring セルフサービスポリシーが正常に作成されたときに提供される、セルフサービスポリシー識別子。A self-serve policy identifier that is supplied upon successful creation of the self-serve policy.
SelfServeEntitySelfServeEntity SelfServeEntitySelfServeEntity アクセスが許可されている自己提供のエンティティ。The self-serve entity that is being granted access.
GrantorGrantor GrantorGrantor アクセスを許可している権限の許可。The grantor that is granting access.
アクセス許可Permissions アクセス許可の配列Array of Permission アクセス許可リソースの配列。An Array of Permission resources.
ETagEtag stringstring Etag。The Etag.

要求の例Request example

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"
    }],
    "attributes": {
        "etag": "\"933523d1-3f63-4fc3-8789-5e21c02cdaed\"",
        "objectType": "SelfServePolicy"
    }
}

REST 応答REST response

成功した場合、この API は更新されたセルフサービスポリシーの SelfServePolicy リソースを返します。If successful, this API returns a SelfServePolicy resource for the updated self-serve policy.

応答の成功とエラーのコードResponse success and error codes

各応答には、成功または失敗を示す HTTP ステータス コードと、追加のデバッグ情報が付属しています。Each response comes with an HTTP status code that indicates success or failure and additional debugging information. このコード、エラーの種類、追加のパラメーターを読み取るには、ネットワーク トレース ツールを使用します。Use a network trace tool to read this code, error type, and additional parameters. 完全な一覧については、パートナー センターの REST エラーコードに関する記事を参照してください。For the full list, see Partner Center REST error codes.

このメソッドは、次のエラーコードを返します。This method returns the following error codes:

HTTP 状態コードHTTP Status Code エラー コードError code 説明Description
404404 600039600039 セルフサービスポリシーが見つかりませんでしたSelf-serve policy was not found
404404 600040600040 セルフサービスポリシー識別子が正しくありませんSelf-serve policy identifier is incorrect

応答の例Response example

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"
    }],
    "attributes": {
        "etag": "\"1ec98034-a249-46f4-b9dd-9cd464fb5e47\"",
        "objectType": "SelfServePolicy"
    }
}