ID で注文を取得するGet an order by ID

適用対象:Applies to:

  • パートナー センターPartner Center
  • 21Vianet が運営するパートナー センターPartner Center operated by 21Vianet
  • Microsoft Cloud ドイツのパートナー センターPartner Center for Microsoft Cloud Germany
  • 米国政府機関向け Microsoft Cloud のパートナー センターPartner Center for Microsoft Cloud for US Government

顧客と注文 ID に一致する 注文 リソースを取得します。Gets an Order resource that matches the customer and order ID.

前提条件Prerequisites

  • パートナー センターの認証に関するページで説明している資格情報。Credentials as described in Partner Center authentication. このシナリオでは、スタンドアロンアプリとアプリ + ユーザー資格情報の両方を使用した認証がサポートされています。This scenario supports authentication with both standalone App and App+User credentials.

  • 顧客 ID です (customer-tenant-id)。A customer ID (customer-tenant-id). お客様の ID がわからない場合は、パートナー センターのダッシュボードで検索できます。If you don't know the customer's ID, you can look it up in the Partner Center dashboard. パートナー センター メニューの [CSP] を選択し、 [顧客] を選択します。Select CSP from the Partner Center menu, followed by Customers. 顧客一覧からお客様を選び、 [アカウント] を選択します。Select the customer from the customer list, then select Account. お客様のアカウント ページで、 [顧客のアカウント情報] セクションの Microsoft ID を探します。On the customer’s Account page, look for the Microsoft ID in the Customer Account Info section. Microsoft ID は、顧客 ID (customer-tenant-id) と同じです。The Microsoft ID is the same as the customer ID (customer-tenant-id).

  • 注文 ID。An order ID.

C#C#

顧客の注文を ID で取得するには、次のようにします。To get a customer's order by ID:

  1. IAggregatePartner.Customers コレクションを使用し、ById() メソッドを呼び出します。Use your IAggregatePartner.Customers collection and call the ById() method.

  2. Ordersプロパティを呼び出し、それに続けてByID ()メソッドを呼び出します。Call the Orders property, followed by the ByID() method once more.

  3. Get ()またはGetAsync ()を呼び出します。Call Get() or GetAsync().

// IAggregatePartner partnerOperations;
// string selectedCustomerId;
// string selectedOrderId;

var order = partnerOperations.Customers.ById(selectedCustomerId).Orders.ById(selectedOrderId).Get();

サンプル: コンソールテストアプリSample: Console test app. プロジェクト: partnersdk. FeatureSample クラス: GetOrder.csProject: PartnerSDK.FeatureSample Class: GetOrder.cs

JavaJava

パートナー センター Java SDK は、パートナーが自分のパートナー センター リソースを管理するために一般的に使用されます。The Partner Center Java SDK is commonly used by partners to manage their Partner Center resources. これはパートナー コミュニティによって管理されているオープン ソース プロジェクトです。It's an open-source project maintained by the partner community. このモジュールはパートナー コミュニティによって管理されているため、Microsoft では公式にサポートしていません。Since this module is maintained by the partner community, it isn't officially supported by Microsoft. 問題が発生した場合は、コミュニティから支援を得るか、GitHub に問題を投稿することができます。You can get help from the community or open an issue on GitHub if you experience a problem.

顧客の注文を ID で取得するには、次のようにします。To get a customer's order by ID:

  1. Iaggregatepartner.customers関数を使用し、 byId () 関数を呼び出します。Use your IAggregatePartner.getCustomers function and call the byId() function.

  2. Getorders関数を呼び出し、その後にbyID () 関数を呼び出します。Call the getOrders function, followed by the byID() function once more.

  3. Get () 関数を呼び出します。Call the get() function.

// IAggregatePartner partnerOperations;
// String selectedCustomerId;
// String selectedOrderId;

Order order = partnerOperations.getCustomers().byId(selectedCustomerId).getOrders().byId(selectedOrderId).get();

PowerShellPowerShell

パートナー センター PowerShell モジュールは、パートナーが自分のパートナー センター リソースを管理するために一般的に使用されます。The Partner Center PowerShell module is commonly used by partners to manage their Partner Center resources. これはパートナー コミュニティによって管理されているオープン ソース プロジェクトです。It's an open-source project maintained by the partner community. このモジュールはパートナー コミュニティによって管理されているため、Microsoft では公式にサポートしていません。Since this module is maintained by the partner community, it isn't officially supported by Microsoft. 問題が発生した場合は、コミュニティから支援を得るか、GitHub に問題を投稿することができます。You can get help from the community or open an issue on GitHub if you experience a problem.

顧客の注文を ID で取得するには、 Get partnercustomer order コマンドを実行し、 CustomerId および OrderId パラメーターを指定します。To get a customer's order by ID, execute the Get-PartnerCustomerOrder command, and specify the CustomerId and OrderId parameters.

# $selectedCustomerId
# $selectedOrderId

Get-PartnerCustomerOrder -CustomerId $selectedCustomerId -OrderId $selectedOrderId

REST 要求REST request

要求の構文Request syntax

認証方法Method 要求 URIRequest URI
GETGET {baseURL}/v1/customers/{customer-tenant-id}/orders/{id-for-order} HTTP/1.1{baseURL}/v1/customers/{customer-tenant-id}/orders/{id-for-order} HTTP/1.1

URI パラメーターURI parameters

次の表は、ID で注文を取得するために必要なクエリパラメーターを示しています。This table lists the required query parameters to get an order by ID.

名前Name 種類Type 必須Required 説明Description
customer-tenant-idcustomer-tenant-id stringstring はいYes 顧客に対応する GUID 形式の文字列。A GUID formatted string corresponding to the customer.
id-for-orderid-for-order stringstring はいYes 注文 ID に対応する文字列。A string corresponding to the order ID.

要求ヘッダーRequest headers

詳細については、「パートナー センター REST ヘッダー」を参照してください。For more information, see Partner Center REST headers.

[要求本文]Request body

[なし] :None.

要求の例Request example

GET https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/orders/<id-for-order> HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 0e5fc923-8e3c-4560-9100-ce7283c3e081
MS-CorrelationId: 8a53b025-d5be-4d98-ab20-229d1813de76
Connection: Keep-Alive

REST 応答REST response

成功した場合、このメソッドは応答本文で 注文 リソースを返します。If successful, this method returns an Order resource 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 the full list, see Error Codes.

応答の例Response example

HTTP/1.1 200 OK
Content-Length: 823
Content-Type: application/json
MS-RequestId: 0e5fc923-8e3c-4560-9100-ce7283c3e081
MS-CorrelationId: 8a53b025-d5be-4d98-ab20-229d1813de76
Date: Thu, 15 Mar 2018 22:05:30 GMT

{
    "id": "YxH1q4KScfvfkJQjgRI8QY1DznnUWZTH1",
    "referenceCustomerId": "b0d70a69-4c42-4b27-b17b-91a835d8686a",
    "billingCycle": "one_time",
    "currencyCode": "USD",
    "currencySymbol" : "$",
    "lineItems": [
    {
        "lineItemNumber": 0,
        "offerId": "DZH318Z0BQ4Z:002L:DZH318Z0CMNP",
        "friendlyName": "Reserved_VM_Instance_Standard_NC12_AU_East_1_Year",
        "quantity": 1,
        "links": {
            "sku": {
                "uri": "/products/DZH318Z0BQ4Z/skus/002L?country=US",
                "method": "GET",
                "headers": []
            }
        }
    }
    ],
    "creationDate": "2018-03-13T22:49:54.3396949Z",
    "status": "completed",
    "links": {
        "provisioningStatus": {
            "uri": "/customers/b0d70a69-4c42-4b27-b17b-91a835d8686a/orders/YxH1q4KScfvfkJQjgRI8QY1DznnUWZTH1/provisioningstatus",
            "method": "GET",
            "headers": []
        },
        "self": {
            "uri": "/customers/b0d70a69-4c42-4b27-b17b-91a835d8686a/orders/YxH1q4KScfvfkJQjgRI8QY1DznnUWZTH1",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Order"
    }
}