ID で SKU を取得するGet a SKU by ID

適用対象Applies To

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

指定された SKU ID を使用して、指定された製品の SKU を取得します。Gets a SKU for the specified product using the specified SKU ID.

前提条件Prerequisites

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

  • 製品 ID。A product ID.

  • SKU ID。A SKU ID.

C#C#

特定の SKU の詳細を取得するには、まず「 ID で製品を取得する」の手順に従って、特定の製品の操作のインターフェイスを取得します。To get the details of a specific SKU, start by following the steps in Get a product by ID to get the interface for a specific product's operations. 生成されたインターフェイスからskuプロパティを選択して、sku で使用可能な操作を含むインターフェイスを取得します。From the resulting interface, select the Skus property to obtain an interface with the available operations for SKUs. SKU ID をById () メソッドに渡し、 Get () またはGetAsync () を呼び出して sku の詳細を取得します。Pass the SKU ID to the ById() method, and call Get() or GetAsync() to retrieve the SKU details.

IAggregatePartner partnerOperations;
string countryCode;
string productId;
string skuId;

// Get the SKU details.
var sku = partnerOperations.Products.ByCountry(countryCode).ById(productId).Skus.ById(skuId).Get();

REST 要求REST request

要求の構文Request syntax

認証方法Method 要求 URIRequest URI
GETGET {baseURL}/v1/products/{product-id}/skus/{sku-id}? country = {country-CODE} HTTP/1.1{baseURL}/v1/products/{product-id}/skus/{sku-id}?country={country-code} HTTP/1.1

URI パラメーターURI parameter

指定された SKU ID を使用して、指定された製品の SKU を取得するには、次のパスとクエリパラメーターを使用します。Use the following path and query parameters to get a SKU for the specified product using the specified SKU ID.

名前Name TypeType 必須Required DescriptionDescription
製品 idproduct-id stringstring はいYes 製品を識別する文字列。A string that identifies the product.
sku-idsku-id stringstring はいYes SKU を識別する文字列。A string that identifies the SKU.
国-コードcountry-code stringstring はいYes 国/地域 ID。A country/region ID.

要求ヘッダーRequest headers

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

[要求本文]Request body

[なし] :None.

要求の例Request example

GET http://api.partnercenter.microsoft.com/v1/products/DZH318Z0BQ3V/skus/00G1?country=US HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e0ae69a5-6322-4d7e-809d-59e02b51d71f
MS-CorrelationId: 956eae17-7650-4470-94d2-4f61b9b02a23
X-Locale: en-US
MS-PartnerCenter-Client: Partner Center .NET SDK
MS-PartnerCenter-Application: Partner Center .NET SDK Samples
Host: api.partnercenter.microsoft.com

REST 応答REST response

成功した場合、応答本文にはSKUリソースが含まれます。If successful, the response body contains a SKU resource.

応答の成功とエラーのコード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 Partner Center error codes.

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

HTTP 状態コードHTTP Status Code エラー コードError code 説明Description
404404 400013400013 製品が見つかりませんでした。Product was not found.
404404 400018400018 Sku が見つかりませんでした。Sku was not found.

応答の例Response example

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Server: Microsoft-IIS/10.0
MS-CorrelationId: 956eae17-7650-4470-94d2-4f61b9b02a23,956eae17-7650-4470-94d2-4f61b9b02a23
MS-RequestId: e0ae69a5-6322-4d7e-809d-59e02b51d71f,e0ae69a5-6322-4d7e-809d-59e02b51d71f
X-Locale: en-US,en-US
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcbWFtZW5kZVxkZXZcZHBzLXJwZVxSUEUuUGFydG5lci5TZXJ2aWNlLkNhdGFsb2dcV2ViQXBpc1xDYXRhbG9nU2VydmljZS5WMi5XZWJcdjFccHJvZHVjdHNcRFpIMzE4WjBCUTNWXHNrdXNcMDBHMQ==?=
X-Powered-By: ASP.NET
Date: Thu, 15 Mar 2018 17:43:25 GMT
Content-Length: 1108

{
    "id": "00G1",
    "productId": "DZH318Z0BQ3V",
    "title": "Reserved VM Instance, Standard_D32s_v3, US West 2, 3 Years",
    "description": "Reserved Virtual Machines Instance, Standard_D32s_v3, US West 2, 3 Years",
    "minimumQuantity": 1,
    "maximumQuantity": 999999999,
    "isTrial": false,
    "supportedBillingCycles": [
        "one_time"
    ],
    "purchasePrerequisites": [
        "AzureSubscriptionRegistration",
        "InventoryCheck"
    ],
    "inventoryVariables": [
        "CustomerId",
        "AzureSubscriptionId"
    ],
    "provisioningVariables": [
        "Scope",
        "SubscriptionId"
    ],
    "dynamicAttributes": {
        "armSkuName": "Standard_D32s_v3",
        "cores": "32",
        "ram": "128",
        "skuDisplayName": "D32s v3",
        "category": "General purpose",
        "armRegionName": "westus2",
        "duration": "3Years",
        "region": "US West 2",
        "diskType": "Ssd"
    },
    "links": {
        "availabilities": {
            "uri": "/products/DZH318Z0BQ3V/skus/00G1/availabilities?country=us",
            "method": "GET",
            "headers": []
        },
        "self": {
            "uri": "/products/DZH318Z0BQ3V/skus/00G1?country=us",
            "method": "GET",
            "headers": []
        }
    }
}