SKU에 대한 가용성 목록 가져오기(국가/지역별)
이 문서에서는 지정된 제품 및 SKU에 대한 특정 국가/지역의 가용성 컬렉션을 가져오는 방법을 설명합니다.
필수 조건
자격 증명(파트너 센터 인증에서 설명). 이 시나리오는 독립 실행형 앱과 App+사용자 자격 증명을 모두 사용하여 인증을 지원합니다.
제품 식별자입니다.
SKU 식별자입니다.
국가/지역입니다.
C#
SKU에 대한 가용성 목록을 얻으려면 다음을 수행합니다.
ID로 SKU 가져오기의 단계에 따라 특정 SKU 작업에 대한 인터페이스를 가져옵니다.
SKU 인터페이스에서 가용성 속성을 선택하여 가용성 작업에 대한 인터페이스를 가져옵니다.
(선택 사항) 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에 대한 가용성 목록을 가져옵니다.
| 속성 | Type | 필수 | 설명 |
|---|---|---|---|
| product-id | string | 예 | 제품을 식별하는 문자열입니다. |
| sku-id | string | 예 | SKU를 식별하는 문자열입니다. |
| 국가 코드 | string | 예 | 국가/지역 ID입니다. |
| target-segment | string | 아니요 | 필터링에 사용되는 대상 세그먼트를 식별하는 문자열입니다. 비영리 단체를 제외한 모든 세그먼트는 포함되지 않은 경우 반환됩니다. 비영리 단체는 비영리 가용성을 얻기 위해 특별히 전달되어야 합니다. |
| reservationScope | string | 아니요 | Azure Reservation SKU에 대한 가용성 목록을 쿼리할 때 AzurePlan에 적용할 수 있는 가용성 목록을 가져오기 위해 지정 reservationScope=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 응답
성공하면 응답 본문에 가용성 리소스 컬렉션이 포함됩니다.
응답 성공 및 오류 코드
각 응답에는 성공 또는 실패 및 더 많은 디버깅 정보를 나타내는 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": []
}
}
}
}