다음을 통해 공유

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

  • 아티클

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

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

필수 조건

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

  • 국가/지역입니다.

C#

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

  1. IAggregatePartner.Products 컬렉션을 사용하여 ByCountry() 메서드를 사용하여 국가/지역을 선택합니다.

  2. ByTargetView() 메서드를 사용하여 카탈로그 뷰를 선택합니다.

  3. (선택 사항) ByReservationScope() 메서드를 사용하여 예약 범위를 선택합니다.

  4. (선택 사항) ByTargetSegment() 메서드를 사용하여 대상 세그먼트를 선택합니다.

  5. 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에서 문제를 열 수 있습니다.

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

  1. IAggregatePartner.getProducts 함수를 사용하여 byCountry() 함수를 사용하여 국가를 선택합니다.

  2. byTargetView() 함수를 사용하여 카탈로그 뷰를 선택합니다.

  3. (선택 사항) byTargetSegment() 함수를 사용하여 대상 세그먼트를 선택합니다.

  4. 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에서 문제를 열 수 있습니다.

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

  1. Get-PartnerProduct 명령을 실행합니다.

  2. 카탈로그 매개 변수를 지정하여 카탈로그를 선택합니다.

  3. (선택 사항) 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: 7c1f6619-c176-4040-a88f-2c71f3ba4533

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: 7c1f6619-c176-4040-a88f-2c71f3ba4533

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: 7c1f6619-c176-4040-a88f-2c71f3ba4533

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

참고 항목

라이선스 기반 서비스에 대한 새로운 상거래 환경에는 많은 새로운 기능이 포함되며 모든 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: 7c1f6619-c176-4040-a88f-2c71f3ba4533

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"
    }
}

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

참고 항목

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

{
  "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"
  }
}