ID で注文を取得する
適用対象: パートナー センター | 21Vianet が運営するパートナー センター | Microsoft Cloud for US Government のパートナー センター
顧客と注文 ID に一致する Order リソースを取得します。
前提条件
パートナー センターの認証に関するページで説明している資格情報。 このシナリオでは、スタンドアロンの App と App+User の両方の資格情報を使用した認証がサポートされています。
顧客 ID です (
customer-tenant-id
)。 顧客の ID がわからない場合は、[顧客] ワークスペースを選択し、顧客の一覧から顧客を選択し、[アカウント] を選択して、パートナー センターで検索できます。 お客様のアカウント ページで、[顧客のアカウント情報] セクションの Microsoft ID を探します。 Microsoft ID は、顧客 ID (customer-tenant-id
) と同じです。注文 ID。
C#
ID で顧客の注文を取得するには:
IAggregatePartner.Customers コレクションを使用し、ById() メソッドを呼び出します。
// IAggregatePartner partnerOperations;
// string selectedCustomerId;
// string selectedOrderId;
var order = partnerOperations.Customers.ById(selectedCustomerId).Orders.ById(selectedOrderId).Get();
サンプル: コンソール テスト アプリ。 プロジェクト: PartnerSDK.FeatureSample クラス: GetOrder.cs
Java
パートナー センター Java SDK を使用して、パートナー センター リソースを管理できます。 これは、パートナー コミュニティによってメインされ、Microsoft によって正式にサポートされていないオープンソース プロジェクトです。 問題が発生した場合は、コミュニティから支援を得るか、GitHub に問題を投稿することができます。
ID で顧客の注文を取得するには:
IAggregatePartner.getCustomers 関数を使用し、byId() 関数を呼び出します。
getOrders 関数を呼び出し、その後に byID() 関数をもう一度呼び出します。
get() 関数を呼び出します。
// IAggregatePartner partnerOperations;
// String selectedCustomerId;
// String selectedOrderId;
Order order = partnerOperations.getCustomers().byId(selectedCustomerId).getOrders().byId(selectedOrderId).get();
PowerShell
パートナー センター PowerShell モジュールを使用して、パートナー センター リソースを管理できます。 これは、パートナー コミュニティによってメインされ、Microsoft によって正式にサポートされていないオープンソース プロジェクトです。 問題が発生した場合は、コミュニティから支援を得るか、GitHub に問題を投稿することができます。
顧客の注文を ID で取得するには、Get-PartnerCustomerOrder コマンドを実行し、CustomerId パラメーターと OrderId パラメーターを指定します。
# $selectedCustomerId
# $selectedOrderId
Get-PartnerCustomerOrder -CustomerId $selectedCustomerId -OrderId $selectedOrderId
REST 要求
要求の構文
認証方法 | 要求 URI |
---|---|
GET | {baseURL}/v1/customers/{customer-tenant-id}/orders/{id-for-order} HTTP/1.1 |
URI パラメーター
次の表に、ID で注文を取得するために必要なクエリ パラメーターを示します。
名前 | タイプ | Required | 説明 |
---|---|---|---|
customer-tenant-id | string | はい | 顧客に対応する GUID 形式の文字列。 |
id-for-order | string | はい | 注文 ID に対応する文字列。 |
要求ヘッダー
詳細については、「パートナー センター REST ヘッダー」を参照してください。
要求本文
なし。
要求の例
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 応答
成功した場合、このメソッドは応答本文で Order リソースを返します。
応答の成功とエラーのコード
各応答には、成功または失敗とその他のデバッグ情報を示す HTTP 状態コードが付属しています。 ネットワーク トレース ツールを使用して、このコード、エラーの種類、およびその他のパラメーターを読み取ります。 完全な一覧については、エラー コードに関するページを参照してください。
応答の例
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"
}
}