SKU の可用性の一覧を取得する (国/リージョン別)

[アーティクル]
11/05/2024

この記事では、指定した製品と SKU の特定の国/リージョンで可用性のコレクションを取得する方法について説明します。

前提条件

パートナーセンターの認証に関するページで説明している資格情報。このシナリオでは、スタンドアロンアプリとアプリ + ユーザーの両方の資格情報を使った認証がサポートされています。
製品識別子。
SKU 識別子。
国/地域。

C#

SKU の availabilitiesの一覧を取得するには:

ID で SKU を取得するの手順に従って、特定の SKU の操作のインターフェイスを取得します。
SKU インターフェイスから、 Availabilities プロパティを選択して、可用性の操作を含むインターフェイスを取得します。
(省略可能)ターゲットセグメントで可用性をフィルター処理するには、 ByTargetSegment() メソッドを使用します。含まれていない場合は、非営利団体を除くすべてのセグメントが返されます。非営利団体を利用できるようにするには、特に非営利団体に合格する必要があります。
Get()または GetAsync() を呼び出して、この SKU の可用性のコレクションを取得します。

IAggregatePartner partnerOperations;
string countryCode;
string productId;
string skuId;
string targetSegment;
string productIdForAzureReservation;
string skuIdForAzureReservation;

// Get the availabilities.
var availabilities = partnerOperations.Products.ByCountry(countryCode).ById(productId).Skus.ById(skuId).Availabilities.Get();

// Get the availabilities, filtered by target segment.
var availabilities = partnerOperations.Products.ByCountry(countryCode).ById(productId).Skus.ById(skuId).Availabilities.BySegment(targetSegment).Get();

// Get the availabilities for an Azure reservation product and sku which are applicable to Microsoft Azure (MS-AZR-0145P) subscriptions only.
var availabilities = partnerOperations.Products.ByCountry(countryCode).ById(productIdForAzureReservation).Skus.ById(skuIdForAzureReservation).Availabilities.ByReservationScope("AzurePlan").Get();

// Get the availabilities for an Azure reservation product and sku which are applicable to Azure plans only.
var availabilities = partnerOperations.Products.ByCountry(countryCode).ById(productIdForAzureReservation).Skus.ById(skuIdForAzureReservation).Availabilities.Get();

REST 要求

要求の構文

認証方法	要求 URI
GET	{baseURL}/v1/products/{product-id}/skus/{sku-id}/availabilities?country={country-code}>targetSegment={target-segment} HTTP/1.1

URI パラメーター

SKU の可用性の一覧を取得するには、次のパスとクエリパラメーターを使用します。

名前	タイプ	Required	説明
product-id	string	はい	製品を識別する文字列。
sku-id	string	はい	SKU を識別する文字列。
country-code	string	はい	国/地域 ID。
target-segment	string	いいえ	フィルター処理に使用されるターゲットセグメントを識別する文字列。含まれていない場合は、非営利団体を除くすべてのセグメントが返されます。非営利団体を利用できるようにするには、特に非営利団体に合格する必要があります。
reservationScope	string	いいえ	Azure Reservation SKU の可用性の一覧を照会する場合は、 `reservationScope=AzurePlan` を指定して、AzurePlan に適用できる可用性の一覧を取得します。 Microsoft Azure (MS-AZR-0145P) サブスクリプションに適用できる可用性の一覧を取得するには、このパラメーターを除外します。
IncludeLifeCycleState	string	いいえ	New Commerce ライセンスベースのオファーのライフサイクル状態の値を返すために true に設定できる文字列フラグ。フラグが含まれていない場合、これらの値は返されません。

要求ヘッダー

詳細については、「パートナーセンター REST ヘッダー」を参照してください。

要求本文

なし。

要求の例

国ごとの SKU の可用性

国ごとの特定の SKU の可用性の一覧を取得するには、次の例に従います。

GET http:// api.partnercenter.microsoft.com/v1/products/DZH318Z0BQ3Q/skus/0001/availabilities?country=US HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 70324727-62d8-4195-8f99-70ea25058d02
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

VM 予約の可用性 (Azure プラン)

次の例に従って、Azure VM 予約 SKU の国ごとの可用性の一覧を取得します。この例は、Azure プランに適用される SKU を対象にしています。

GET https://api.partnercenter.microsoft.com/v1/products/DZH318Z0BQ3Q/skus/0001/availabilities?country=US&targetView=AzureReservationsVM&reservationScope=AzurePlan HTTP/1.1
Authorization: Bearer
Accept: application/json
MS-RequestId: 031160b2-b0b0-4d40-b2b1-aaa9bb84211d
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee

Microsoft Azure (MS-AZR-0145P) サブスクリプションの VM 予約の可用性

次の例に従って、Microsoft Azure (MS-AZR-0145P) サブスクリプションに適用される Azure VM 予約の国別の可用性の一覧を取得します。

GET https://api.partnercenter.microsoft.com/v1/products/DZH318Z0BQ3Q/skus/0001/availabilities?country=US&targetView=AzureAzureReservationsVM HTTP/1.1
Authorization: Bearer
Accept: application/json
MS-RequestId: 031160b2-b0b0-4d40-b2b1-aaa9bb84211d
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee

REST 応答

成功した場合、応答本文には Availability リソースのコレクションが含まれます。

応答の成功とエラーのコード

各応答には、成功または失敗とより多くのデバッグ情報を示す HTTP 状態コードが付属しています。ネットワークトレースツールを使用して、このコード、エラーの種類、およびその他のパラメーターを読み取ります。完全な一覧については、「パートナーセンターのエラーコードを参照してください。

このメソッドは、次のエラーコードを返します。

HTTP 状態コード	エラーコード	説明
403	400030	要求された targetSegment へのアクセスは許可されません。

Azure VM 予約の応答の例 (Azure プラン)

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Server: Microsoft-IIS/10.0
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd,aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 70324727-62d8-4195-8f99-70ea25058d02,70324727-62d8-4195-8f99-70ea25058d02
X-Locale: en-US,en-US
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcbWFtZW5kZVxkZXZcZHBzLXJwZVxSUEUuUGFydG5lci5TZXJ2aWNlLkNhdGFsb2dcV2ViQXBpc1xDYXRhbG9nU2VydmljZS5WMi5XZWJcdjFccHJvZHVjdHNcRFpIMzE4WjBCUTNRXHNrdXNcMDAwMVxhdmFpbGFiaWxpdGllcw==?=
X-Powered-By: ASP.NET
Date: Wed, 14 Mar 2018 22:19:37 GMT
Content-Length: 808

{
    "totalCount": 1,
    "items": [
        {
            "id": "DZH318XZXVNF",
            "productId": "DZH318Z0BQ3Q",
            "skuId": "0001",
            "catalogItemId": "DZH318Z0BQ3Q:0001:DZH318XZXVNF",
            "defaultCurrency": {
                "code": "USD",
                "symbol": "$"
            },
            "segment": "commercial",
            "country": "US",
            "isPurchasable": true,
            "isRenewable": false,
            "terms": [{
                "duration": "P1Y",
                "description": "1 Year Prepaid"
            }],
            "product": { ... },
            "sku": { ... },
            "links": {
                "self": {
                    "uri": "/products/DZH318Z0BQ3Q/skus/0001/availabilities/DZH318Z0HMKQ?country=US",
                    "method": "GET",
                    "headers": []
                }
            }
        }
    ],
    "links": {
        "self": {
            "uri": "/products/DZH318Z0BQ3Q/skus/0001/availabilities?country=US&targetSegment=commercial",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Collection"
    }
}

新しいコマースライセンスベースのサービスの応答例

Note

ライセンスベースのサービスの新しいコマースエクスペリエンスには、多くの新機能が含まれており、すべてのクラウドソリューションプロバイダー (CSP) で利用できます。詳細については、新しいコマースエクスペリエンスの概要を参照してください。

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Server: Microsoft-IIS/10.0
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd,aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 70324727-62d8-4195-8f99-70ea25058d02,70324727-62d8-4195-8f99-70ea25058d02
X-Locale: en-US,en-US
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcbWFtZW5kZVxkZXZcZHBzLXJwZVxSUEUuUGFydG5lci5TZXJ2aWNlLkNhdGFsb2dcV2ViQXBpc1xDYXRhbG9nU2VydmljZS5WMi5XZWJcdjFccHJvZHVjdHNcRFpIMzE4WjBCUTNRXHNrdXNcMDAwMVxhdmFpbGFiaWxpdGllcw==?=
X-Powered-By: ASP.NET
Date: Wed, 14 Mar 2018 22:19:37 GMT
Content-Length: 808

{
    "id": "CFQ7TTC0K971",
    "productId": "CFQ7TTC0LH18",
    "skuId": "0001",
    "catalogItemId": "CFQ7TTC0LH18:0001:CFQ7TTC0K971",
    "defaultCurrency": {
        "code": "USD",
        "symbol": "$"
    },
    "segment": "commercial",
    "country": "US",
    "isPurchasable": true,
    "isRenewable": true, 
    "renewalInstructions": [
        {
            "applicableTermIds": [
                "5aeco6mffyxo"
            ],
            "renewalOptions": [
                {
                    "renewToId": "CFQ7TTC0LH18:0001",
                    "isAutoRenewable": true
                }
            ]
        },
	 …
    ],
    "terms": [
        {
            "id": "5aeco6mffyxo",
            "duration": "P1Y",
            "description": "One-Year commitment for monthly/yearly billing",
            "billingCycle": "Annual",
            "cancellationPolicies": [
                {
                    "refundOptions": [
                        {
                            "sequenceId": 0,
                            "type": "Full",
                            "expiresAfter": "P1D"
                        }
                    ]
                }
            ]
        },
       …
    ],
    "links": {
        "self": {
            "uri": "/products/CFQ7TTC0LH18/skus/0001/availabilities/CFQ7TTC0K971?country=US",
            "method": "GET",
            "headers": []
        }
    },
        "links": {
            "availabilities": {
                "uri": "/products/CFQ7TTC0LH18/skus/0001/availabilities?country=US",
                "method": "GET",
                "headers": []
            },
            "self": {
                "uri": "/products/CFQ7TTC0LH18/skus/0001?country=US",
                "method": "GET",
                "headers": []
            }
        }
    }
}

次の方法で共有

SKU の可用性の一覧を取得する (国/リージョン別)

前提条件

C#

REST 要求

要求の構文

URI パラメーター

要求ヘッダー

要求本文

要求の例

国ごとの SKU の可用性

VM 予約の可用性 (Azure プラン)

Microsoft Azure (MS-AZR-0145P) サブスクリプションの VM 予約の可用性

REST 応答

応答の成功とエラーのコード

Azure VM 予約の応答の例 (Azure プラン)

新しいコマースライセンスベースのサービスの応答例

フィードバック

その他のリソース

次の方法で共有

SKU の可用性の一覧を取得する (国/リージョン別)

前提条件

C#

REST 要求

要求の構文

URI パラメーター

要求ヘッダー

要求本文

要求の例

国ごとの SKU の可用性

VM 予約の可用性 (Azure プラン)

Microsoft Azure (MS-AZR-0145P) サブスクリプションの VM 予約の可用性

REST 応答

応答の成功とエラーのコード

Azure VM 予約の応答の例 (Azure プラン)

新しいコマース ライセンス ベースのサービスの応答例

フィードバック

その他のリソース

新しいコマースライセンスベースのサービスの応答例