제품 목록 가져오기(국가/지역별)

아티클
09/27/2024

적용 대상: 파트너 센터 | 21Vianet에서 운영되는 파트너 센터 | Microsoft Cloud for US Government 파트너 센터

다음 방법을 사용하여 특정 국가/지역에서 사용할 수 있는 제품 컬렉션을 가져올 수 있습니다.

필수 조건

자격 증명(파트너 센터 인증에서 설명). 이 시나리오는 독립 실행형 앱과 App+사용자 자격 증명을 모두 사용하여 인증을 지원합니다.
국가/지역입니다.

C#

제품 목록을 얻으려면 다음을 수행합니다.

IAggregatePartner.Products 컬렉션을 사용하여 ByCountry() 메서드를 사용하여 국가/지역을 선택합니다.
ByTargetView() 메서드를 사용하여 카탈로그 뷰를 선택합니다.
(선택 사항) ByReservationScope() 메서드를 사용하여 예약 범위를 선택합니다.
(선택 사항) ByTargetSegment() 메서드를 사용하여 대상 세그먼트를 선택합니다.
Get() 또는 GetAsync() 메서드를 호출하여 컬렉션을 반환합니다.

IAggregatePartner partnerOperations;

// Get the products for the specified catalog view.
ResourceCollection<Products> products = partnerOperations.Products.ByCountry("US").ByTargetView("MicrosoftAzure").Get();

// Get the products filtered by target view and target segment.
ResourceCollection<Products> products = partnerOperations.Products.ByCountry("US").ByTargetView("MicrosoftAzure").ByTargetSegment("commercial").Get();

// Get the products for Azure reservations which are applicable to Microsoft Azure (MS-AZR-0145P) subscriptions only.
ResourceCollection<Product> products = partnerOperations.Products.ByCountry("US").ByTargetView("AzureReservations").Get();

// Get the products for Azure reservations which are applicable to Azure plans only.
ResourceCollection<Product> products = partnerOperations.Products.ByCountry("US").ByTargetView("AzureReservations").ByReservationScope("AzurePlan").Get();

Java

파트너 센터 Java SDK를 사용하여 파트너 센터 리소스를 관리할 수 있습니다. 파트너 커뮤니티에서 유지 관리하며 Microsoft에서 공식적으로 지원하지 않는 오픈 소스 프로젝트입니다. 문제가 발생한 경우 커뮤니티에서 도움을 받거나 GitHub에서 문제를 열 수 있습니다.

제품 목록을 얻으려면 다음을 수행합니다.

IAggregatePartner.getProducts 함수를 사용하여 byCountry() 함수를 사용하여 국가를 선택합니다.
byTargetView() 함수를 사용하여 카탈로그 뷰를 선택합니다.
(선택 사항) byTargetSegment() 함수를 사용하여 대상 세그먼트를 선택합니다.
get() 함수를 호출하여 컬렉션을 반환합니다.

// IAggregatePartner partnerOperations;

// Get the products for the specified catalog view.
ResourceCollection<Products> products = partnerOperations.getProducts().byCountry("US").byTargetView("Azure").get();

// Get the products filtered by target view and target segment.
ResourceCollection<Products> products = partnerOperations.getProducts().byCountry("US").byTargetView("Azure").byTargetSegment("commercial").get();

PowerShell

파트너 센터 PowerShell 모듈을 사용하여 파트너 센터 리소스를 관리할 수 있습니다. 파트너 커뮤니티에서 유지 관리하며 Microsoft에서 공식적으로 지원하지 않는 오픈 소스 프로젝트입니다. 문제가 발생한 경우 커뮤니티에서 도움을 받거나 GitHub에서 문제를 열 수 있습니다.

제품 목록을 얻으려면 다음을 수행합니다.

Get-PartnerProduct 명령을 실행합니다.
카탈로그 매개 변수를 지정하여 카탈로그를 선택합니다.
(선택 사항) Segment 매개 변수를 지정하여 대상 세그먼트를 선택합니다.

Get-PartnerProduct -Catalog 'Azure' -Segment 'commercial'

REST 요청

요청 구문

메서드	요청 URI
GET	{baseURL}/v1/products?country={country}&targetView={targetView}&targetSegment={targetSegment} HTTP/1.1

URI 매개 변수

다음 경로 및 쿼리 매개 변수를 사용하여 제품 목록을 가져옵니다.

속성	Type	필수	설명
country	string	예	국가/지역 ID입니다.
targetView	string	예	카탈로그의 대상 뷰를 식별합니다. 지원되는 값은 다음과 같습니다. 모든 Azure 항목을 포함하는 Azure 모든 Azure 예약 항목을 포함하는 AzureReservations 모든 VM(가상 머신) 예약 항목을 포함하는 AzureReservationsVM 모든 SQL 예약 항목을 포함하는 AzureReservationsSQL 모든 Cosmos 데이터베이스 예약 항목을 포함하는 AzureReservationsCosmosDb Microsoft Azure 구독(MS-AZR-0145P) 및 Azure 플랜에 대한 항목이 포함된 MicrosoftAzure 기존 라이선스 기반 서비스 및 새로운 상거래 라이선스 기반 서비스와 같은 모든 온라인 서비스 항목을 포함하는 OnlineServices입니다. 소프트웨어( 모든 소프트웨어 항목 포함) 모든 소프트웨어 SUSE Linux 항목을 포함하는 SoftwareSUSELinux 모든 영구 소프트웨어 항목을 포함하는 SoftwarePerpetual 모든 소프트웨어 구독 항목을 포함하는 SoftwareSubscriptions 일부 파트너가 사용할 수 있는 특수 제품이 포함된 SpecializedOffers ISV(Independent Software Vendors)에서 게시한 모든 상업용 Marketplace 제품을 포함하는 MarketplaceSaaS
targetSegment	string	아니요	대상 세그먼트를 식별합니다. 다른 대상 그룹에 대한 보기입니다. 지원되는 값은 다음과 같습니다. 광고 방송 education government 비영리
reservationScope	string	아니요	Azure Reservations에 대한 제품 목록을 쿼리할 때 Azure 플랜에 적용할 수 있는 제품 목록을 가져오기 위해 지정 `reservationScope=AzurePlan` 합니다. 이 매개 변수를 제외하여 Microsoft Azure(MS-AZR-0145P) 구독에 적용할 수 있는 Azure 예약 제품 목록을 가져옵니다.

요청 헤더

자세한 내용은 파트너 센터 REST 헤더를 참조하세요.

요청 본문

없음

요청 예제

국가별 제품

이 예제에 따라 Microsoft Azure(MS-AZR-0145P) 구독 및 Azure 플랜에 대한 국가별 제품 목록을 가져옵니다.

GET https://api.partnercenter.microsoft.com/v1/products?country=US&targetView=MicrosoftAzure HTTP/1.1
Authorization: Bearer
Accept: application/json
MS-RequestId: 031160b2-b0b0-4d40-b2b1-aaa9bb84211d
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

Azure VM 예약(Azure 플랜)

이 예제에 따라 Azure 플랜에 적용할 수 있는 Azure VM 예약에 대한 국가별 제품 목록을 가져옵니다.

GET https://api.partnercenter.microsoft.com/v1/products?country=US&targetView=AzureAzureReservationsVM&reservationScope=AzurePlan HTTP/1.1
Authorization: Bearer
Accept: application/json
MS-RequestId: 031160b2-b0b0-4d40-b2b1-aaa9bb84211d
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

Microsoft Azure(MS-AZR-0145P) 구독에 대한 Azure VM 예약

이 예제에 따라 Microsoft Azure(MS-AZR-0145P) 구독에 적용할 수 있는 Azure VM 예약에 대한 국가별 제품 목록을 가져옵니다.

GET https://api.partnercenter.microsoft.com/v1/products?country=US&targetView=AzureReservationsVM HTTP/1.1
Authorization: Bearer
Accept: application/json
MS-RequestId: 031160b2-b0b0-4d40-b2b1-aaa9bb84211d
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

새 상거래 라이선스 기반 서비스

참고 항목

라이선스 기반 서비스에 대한 새로운 상거래 환경에는 많은 새로운 기능이 포함되며 모든 CSP(클라우드 솔루션 공급자)에서 사용할 수 있습니다. 자세한 내용은 새 상거래 환경 개요를 참조하세요.

이 예제에 따라 새 상거래 환경 기술 미리 보기의 일부로 새 상거래 라이선스 기반 서비스에 대한 국가별 제품 목록을 가져옵니다. 새 상거래 라이선스 기반 서비스는 OnlineServicesNCE의 ID 및 displayNames 값으로 식별됩니다. 아래 응답 예제를 참조하세요.

GET https://api.partnercenter.microsoft.com/v1/products?country=US&targetView=OnlineServices HTTP/1.1
Authorization: Bearer
Accept: application/json
MS-RequestId: 031160b2-b0b0-4d40-b2b1-aaa9bb84211d
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

REST 응답

성공하면 응답 본문에 Product 리소스 컬렉션이 포함됩니다.

응답 성공 및 오류 코드

각 응답에는 성공 또는 실패와 추가 디버깅 정보를 나타내는 HTTP 상태 코드가 함께 제공됩니다. 네트워크 추적 도구를 사용하여 이 코드, 오류 유형 및 추가 매개 변수를 읽을 수 있습니다. 전체 목록은 파트너 센터 오류 코드를 참조 하세요.

이 메서드는 다음 오류 코드를 반환합니다.

HTTP 상태 코드	오류 코드	설명
403	400030	요청된 targetSegment에 대한 액세스는 허용되지 않습니다.
403	400036	요청된 targetView에 대한 액세스는 허용되지 않습니다.

Azure VM 예약에 대한 응답 예제(Azure 플랜)

{
    "totalCount": 19,
    "items": [
        {
            "id": "DZH318Z0BQ3Q",
            "title": "Virtual Machines DSv2 Series",
            "description": "Dsv2-series instances are the latest generation of D-series instances that will carry more powerful CPUs which are on average about 35% faster than D-series instances, and carry the same memory and disk configurations as the D-series. Dsv2-series instances are based on the latest generation 2.4 GHz Intel Xeon® E5-2673 v3 (Haswell) processor, and with Intel Turbo Boost Technology 2.0 can go to 3.2 GHz.",
            "productType": {
                "id": "Azure",
                "displayName": "Azure",
                "subType": {
                "id": "VirtualMachines",
                "displayName": "VirtualMachines"
                }
            },
            "isMicrosoftProduct": true,
            "publisherName": "Microsoft",
            "links": {
                "skus": {
                    "uri": "/products/DZH318Z0BQ3Q/skus?country=US",
                    "method": "GET",
                    "headers": []
                },
                "self": {
                    "uri": "/products/DZH318Z0BQ3Q?country=US",
                    "method": "GET",
                    "headers": []
                }
            }
        },
        ...
    ],
    "links": {
        "self": {
            "uri": "/products?country=US&targetView=Azure",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Collection"
    }
}

새 상거래 라이선스 기반 서비스에 대한 응답 예제

참고 항목

{
  "totalCount": 19,
  "items": [{
      "id": "CFQ7TTC0LH18",
      "title": "Microsoft 365 Business Basic",
      "description": "Best for businesses that need professional email, cloud file storage, and online meetings & chat. Desktop versions of Office apps like Excel, Word, and PowerPoint not included. For businesses with up to 300 employees.",
      "productType": {
        "id": "OnlineServicesNCE",
        "displayName": "OnlineServicesNCE"
      },
      "isMicrosoftProduct": true,
      "publisherName": "Microsoft Corporation",
      "links": {
        "skus": {
          "uri": "/products/CFQ7TTC0LH18/skus?country=US",
          "method": "GET",
          "headers": []
        },
        "self": {
          "uri": "/products/CFQ7TTC0LH18?country=US",
          "method": "GET",
          "headers": []
        }
      }
    },
    ...
  ],
  "links": {
    "self": {
      "uri": "/products?country=US&targetView=OnlineServices",
      "method": "GET",
      "headers": []
    }
  },
  "attributes": {
    "objectType": "Collection"
  }
}

다음을 통해 공유

제품 목록 가져오기(국가/지역별)

필수 조건

C#

Java

PowerShell

REST 요청

요청 구문

URI 매개 변수

요청 헤더

요청 본문

요청 예제

국가별 제품

Azure VM 예약(Azure 플랜)

Microsoft Azure(MS-AZR-0145P) 구독에 대한 Azure VM 예약

새 상거래 라이선스 기반 서비스

REST 응답

응답 성공 및 오류 코드

Azure VM 예약에 대한 응답 예제(Azure 플랜)

새 상거래 라이선스 기반 서비스에 대한 응답 예제

피드백

추가 리소스