セルフサービスポリシーの一覧を取得するGet a list of self-serve policies

適用対象:Applies to:

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

この記事では、エンティティのセルフサービスポリシーを表すリソースのコレクションを取得する方法について説明します。This article describes how to get a collection of resources that represents self-serve policies for an entity.

前提条件Prerequisites

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

C#C#

すべてのセルフサービスポリシーの一覧を取得するには、次のようにします。To get a list of all self-serve policies:

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

// All the operations executed on this partner operation instance will share the same correlation Id but will differ in request Id
IPartner scopedPartnerOperations = partnerOperations.With(RequestContextFactory.Instance.Create(Guid.NewGuid()));

// gets the self-serve policies
var SelfServePolicies = scopedPartnerOperations.SelfServePolicies.Get(customerIdAsEntity);

例については、以下を参照してください。For an example, see the following:

REST 要求REST request

要求の構文Request syntax

認証方法Method 要求 URIRequest URI
GETGET {baseURL}/v1/SelfServePolicy? entity_id = {ENTITY_ID} HTTP/1.1{baseURL}/v1/SelfServePolicy?entity_id={entity_id} HTTP/1.1

URI パラメーターURI parameter

次のクエリパラメーターを使用して、顧客の一覧を取得します。Use the following query parameter to get a list of customers.

名前Name TypeType 必須Required 説明Description
entity_identity_id stringstring YY アクセスを要求しているエンティティ識別子。The entity identifier requesting access for. これは顧客のテナント ID になります。This will be the customer's tenant ID.

要求ヘッダーRequest headers

詳細については、「 ヘッダー」を参照してください。For more information, see Headers.

[要求本文]Request body

なし。None.

要求の例Request example

GET https://api.partnercenter.microsoft.com/v1/SelfServePolicy?entity_id=0431a72c-7d8a-4393-b25e-ef63f5efb415 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 3705fc6d-4127-4a87-bdba-9658f73fe019
MS-CorrelationId: b12260fb-82de-4701-a25f-dcd367690645

REST 応答REST response

成功した場合、このメソッドは応答本文で SelfServePolicy リソースのコレクションを返します。If successful, this method returns a collection of SelfServePolicy resources in the response body.

応答の成功とエラーのコード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. 完全な一覧については、「 エラーコード」を参照してください。For a full list, see Error Codes.

応答の例Response example

HTTP/1.1 200 OK
Content-Length: 15650
Content-Type: application/json
MS-CorrelationId: b12260fb-82de-4701-a25f-dcd367690645
MS-RequestId: 3705fc6d-4127-4a87-bdba-9658f73fe019
Date: Fri, 20 Nov 2015 01:08:23 GMT

{
    "totalCount": 1,
    "items": [{
        "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"
        }
    }],
    "attributes": {
        "objectType": "Collection"
    }
}