取得 SKU 可用性清單（依國家/地區）

發行項
11/05/2024

本文說明如何取得特定國家/地區指定產品和 SKU 可用性集合。

必要條件

認證，如合作夥伴中心驗證所述。此案例支援使用獨立應用程式和 App+使用者認證進行驗證。
產品標識碼。
SKU 標識碼。
國家/地區。

C#

若要取得 SKU 可用性清單：

請依照標識碼取得 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 可用性清單。

名稱	類型	必要	描述
product-id	字串	Yes	識別產品的字串。
sku-id	字串	Yes	識別 SKU 的字串。
country-code	字串	Yes	國家/地區標識碼。
target-segment	字串	No	字串，識別用於篩選的目標區段。除了非營利組織以外的所有區段，如果未包含，則會傳回。非營利組織需要特別傳遞，才能獲得非營利組織可用性。
reservationScope	字串	No	查詢 Azure 保留 SKU 可用性清單時，請指定 `reservationScope=AzurePlan` 以取得適用於 AzurePlan 之可用性的清單。排除此參數以取得適用於 Microsoft Azure （MS-AZR-0145P）訂用帳戶之可用性清單。
IncludeLifeCycleState	字串	No	字串旗標，可設定為 true 以傳回 New Commerce 授權型供應專案的生命周期狀態值。如果未包含旗標，則不會傳回這些值。

要求標頭

如需詳細資訊，請參閱合作夥伴中心 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 的 VM 保留可用性（MS-AZR-0145P）訂用帳戶

請遵循此範例，依國家/地區取得適用於 Azure Microsoft Azure（MS-AZR-0145P）訂用帳戶的國家/地區可用性清單。

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 回應

如果成功，回應本文會包含可用性資源的集合。

回應成功和錯誤碼

每個回應都有一個 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"
    }
}

新商務授權型服務的回應範例

注意

授權型服務的新商務體驗包含許多新功能，並可供所有雲端解決方案提供者（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 的 VM 保留可用性（MS-AZR-0145P）訂用帳戶

REST 回應

回應成功和錯誤碼

Azure VM 保留的回應範例（Azure 方案）

新商務授權型服務的回應範例

意見反應

其他資源

共用方式為

取得 SKU 可用性清單（依國家/地區）

必要條件

C#

REST 要求

要求語法

URI 參數

要求標頭

要求本文

要求範例

依國家/地區提供 SKU 可用性

VM 保留可用性 （Azure 方案）

Microsoft Azure 的 VM 保留可用性 （MS-AZR-0145P） 訂用帳戶

REST 回應

回應成功和錯誤碼

Azure VM 保留的回應範例 （Azure 方案）

新商務授權型服務的回應範例

意見反應

其他資源

VM 保留可用性（Azure 方案）

Microsoft Azure 的 VM 保留可用性（MS-AZR-0145P）訂用帳戶

Azure VM 保留的回應範例（Azure 方案）