Product List - List By Subscription
구독할 제품을 나열합니다.
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Marketplace/products?api-version=2025-05-01GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Marketplace/products?api-version=2025-05-01&language={language}&excludePublicOffersAndPublicPlans={excludePublicOffersAndPublicPlans}&$filter={$filter}&$select={$select}&$expand={$expand}&$orderBy={$orderBy}&$search={$search}URI 매개 변수
| Name | In(다음 안에) | 필수 | 형식 | Description |
|---|---|---|---|---|
|
subscription
|
path | True |
string (uuid) |
대상 구독의 ID입니다. 값은 UUID여야 합니다. |
|
api-version
|
query | True |
string minLength: 1 |
이 작업에 사용할 API 버전입니다. |
|
$expand
|
query |
string |
관련 엔터티 인라인 확장 |
|
|
$filter
|
query |
string |
부울 조건에 따라 결과를 필터링합니다. 예: $filter=productType eq 'VirtualMachine'. 필터링할 수 있는 필드는 다음과 같습니다.
|
|
|
$order
|
query |
string |
OData 표기법을 사용하여 결과에 대한 순서 지정 식입니다. 요청의 대기 시간에 영향을 줄 수 있으므로 필수적인 경우가 아니면 orderby를 사용하지 마십시오. 예: $orderby=displayName desc. 이 API는 단일 필드로 정렬만 지원합니다. 순서를 지정할 수 있는 필드는 다음과 같습니다.
|
|
|
$search
|
query |
string |
표시 이름, 게시자 표시 이름 또는 키워드로 선택적으로 검색합니다. 예 $search=Microsoft |
|
|
$select
|
query |
string |
결과에 포함할 속성을 선택합니다. 예: $select=displayName |
|
|
exclude
|
query |
boolean |
응답에서 공개 제안 및 공개 계획을 제외할지 여부입니다. 기본값은 false이며, 이는 공개 제안 및 공개 계획이 응답에 포함됨을 의미합니다. true로 설정하면 개인 계획만 반환됩니다. |
|
|
language
|
query |
string |
검색할 언어, ISO 639-1 두 글자 코드, 가능한 값 - 'en,cs,de,es,fr,hu,it,ja,ko,nl,pl,pt-br,pt-pt,ru,sv,tr,id,zh-hans,zh-hant'. 기본값은 "en"입니다. |
응답
| Name | 형식 | Description |
|---|---|---|
| 200 OK |
요청이 성공했습니다. |
|
| Other Status Codes |
예기치 않은 오류 응답입니다. |
보안
azure_auth
Azure Active Directory OAuth2 흐름.
형식:
oauth2
Flow:
implicit
권한 부여 URL:
https://login.microsoftonline.com/common/oauth2/authorize
범위
| Name | Description |
|---|---|
| user_impersonation | 사용자 계정 가장 |
예제
ProductList_ListBySubscription
샘플 요청
GET https://management.azure.com/subscriptions/f47ac10b-58cc-4372-a567-0e02b2c3d479/providers/Microsoft.Marketplace/products?api-version=2025-05-01&language=en&$filter=productType eq 'SaaS'&$select=displayName,uniqueProductId,productType,publisherDisplayName
샘플 응답
{
"value": [
{
"uniqueProductId": "microsoft.managedinstance_standard",
"displayName": "Azure SQL Managed Instance",
"publisherDisplayName": "Microsoft",
"productType": "SaaS"
}
],
"nextLink": "https://management.azure.com/subscriptions/f47ac10b-58cc-4372-a567-0e02b2c3d479/providers/Microsoft.Marketplace/products?api-version=2025-05-01&language=en&$select=displayName,uniqueProductId,productType,publisherDisplayName&$filter=productType eq 'SaaS'&$skiptoken=W3sid..."
}정의
| Name | Description |
|---|---|
| Attribute |
키와 값으로 구성된 SKU 속성을 나타냅니다. 속성은 다양한 서비스에 따라 다를 수 있습니다. |
|
Discovery |
DiscoveryErrorPayload에서 반환된 오류 세부 정보 |
|
Discovery |
Marketplace 검색 API에서 반환된 오류 페이로드 |
|
Plan |
추가 메타데이터 |
|
Plan |
계획 속성의 하위 집합을 반환합니다. |
|
Product |
Product 속성의 하위 집합을 반환합니다. |
|
Product |
목록 작업의 사용자 지정 응답입니다. |
Attribute
키와 값으로 구성된 SKU 속성을 나타냅니다. 속성은 다양한 서비스에 따라 다를 수 있습니다.
| Name | 형식 | Description |
|---|---|---|
| key |
string |
속성 키 |
| value |
string |
속성 값 |
DiscoveryErrorDetails
DiscoveryErrorPayload에서 반환된 오류 세부 정보
| Name | 형식 | Description |
|---|---|---|
| code |
string |
HTTP 오류 코드 |
| message |
string |
오류 메시지 |
DiscoveryErrorPayload
Marketplace 검색 API에서 반환된 오류 페이로드
| Name | 형식 | Description |
|---|---|---|
| error |
오류 세부 정보 개체 |
PlanMetadata
추가 메타데이터
| Name | 형식 | Description |
|---|---|---|
| altStackReference |
string |
대체 스택 참조를 보유하는 planId를 가리킵니다. |
| generation |
string |
VM 이미지 생성(Virtual Machine 제품에만 적용 가능) |
PlanSummary
계획 속성의 하위 집합을 반환합니다.
| Name | 형식 | Description |
|---|---|---|
| altArchitectureReference |
string |
대체 아키텍처 참조 |
| altStackReference |
string |
대체 스택 참조 |
| categoryIds |
string[] |
CategoryId 계획 |
| cspState |
string |
Microsoft CSP(클라우드 솔루션 공급자) 프로그램 내에서 계획 가용성 및 파트너 액세스를 제어합니다.
|
| description |
string |
플랜/SKU 설명 |
| displayName |
string |
계획/SKU의 표시 이름 |
| displayRank |
string |
계획이 '계획' 테이블에 표시되는 순서 |
| hasProtectedArtifacts |
boolean |
계획에 인증되지 않은 사용자에 대해 숨길 아티팩트가 있는 경우 true로 설정 |
| hasRi |
boolean |
SKU가 예약을 지원하는지 여부 표시 |
| isPrivate |
boolean |
제한된 대상만 계획에 액세스할 수 있음을 나타냅니다. |
| metadata |
확장된 계획/SKU 메타데이터. |
|
| planId |
string |
계획 식별자 |
| planType |
string |
마켓플레이스 제품에 대한 기본 배포 모델 및 호스팅 아키텍처를 지정합니다. 현재 지원되는 값은 다음과 같습니다.
|
| pricingTypes |
string[] |
플랜에 사용할 수 있는 청구 모델 및 비용 구조를 나타냅니다.
|
| skuId |
string |
SKU ID |
| stackType |
string |
스택 유형 : 클래식, Gen1, Gen2 |
| summary |
string |
계획 요약 텍스트 |
| uniquePlanId |
string |
uniqueProductId 및 PlanId를 구분 기호 없이 결합하여 접두사가 붙는 고유 계획 식별자 |
| vmArchitectureType |
string |
가상 시스템 프로세서 아키텍처 및 세대를 지정합니다. 가상 시스템 제품 유형에만 적용됩니다.
|
| vmSecuritytypes |
string[] |
가상 시스템 배포에 대한 보안 향상 수준을 정의합니다. 가상 시스템 제품 유형에만 적용됩니다.
|
ProductSummary
Product 속성의 하위 집합을 반환합니다.
| Name | 형식 | Description |
|---|---|---|
| applicableProducts |
string[] |
제품이 속한 제품 카테고리 |
| attributes |
제품 속성 집합 |
|
| azureBenefit |
string |
제품 구매가 엔터프라이즈 고객을 위한 Azure 소비 약정 혜택에 포함되는지 여부를 나타냅니다.
|
| badges |
string[] |
마켓플레이스 가시성을 위해 제품에서 획득한 인증 및 자격 배지를 표시합니다.
|
| categoryIds |
string[] |
다양한 제품 카테고리 |
| cspLegalTermsUri |
string |
CSP에 대한 제품의 법적 조건 |
| description |
string |
상품 설명 텍스트 |
| displayName |
string |
제품 표시 이름 |
| hasMarketplaceFootprint |
boolean |
제품이 시장에 대표가 있는지 여부 표시 |
| hasRiPlans |
boolean |
제품에 예약이 있는 플랜이 있는지 여부 표시 |
| industryIds |
string[] |
항목이 속한 산업 ID 목록 |
| lastModifiedDateTime |
string |
제품의 최신 업데이트 날짜 |
| locations |
string[] |
SKU에서 사용할 수 있는 위치 목록 |
| longSummary |
string |
제품 요약 |
| operatingSystems |
string[] |
이 제품의 운영 체제 정보 |
| plans |
전체 계획/SKU 속성 집합 |
|
| popularity |
number (double) |
제품의 인기 |
| pricingTypes |
string[] |
플랜에 사용할 수 있는 청구 모델 및 비용 구조를 나타냅니다.
|
| privacyPolicyUri |
string |
제품의 개인 정보 보호 정책 |
| productFamily |
string |
제품군 |
| productId |
string |
제품의 고유 ID |
| productSubType |
string |
제품 하위 유형 |
| productType |
string |
마켓플레이스 카탈로그에 저장된 마켓플레이스 제품에 대한 기본 배포 모델 및 호스팅 아키텍처를 지정합니다.
|
| publisherDisplayName |
string |
게시자 표시 이름 |
| publisherId |
string |
게시자 ID |
| publisherType |
string |
지원 및 파트너십 분류를 위해 Microsoft와의 게시자 관계를 식별합니다.
|
| publishingStage |
string |
Azure Marketplace 내의 제품 가용성 상태 및 고객 액세스 수준을 나타냅니다.
|
| ratingAverage |
number (double) |
제안에 대한 평균 평점 |
| ratingBuckets |
string[] |
마켓플레이스 필터링 및 검색을 위한 고객 평가 임계값별로 제품을 분류합니다.
|
| ratingCount |
integer (int32) |
오퍼에 대한 총 등급 수 |
| service |
string |
제품의 서비스 이름(예: 'Virtual Machines') |
| serviceFamily |
string |
제품의 서비스 제품군(예: 'Compute') |
| smallIconUri |
string |
작은 제품 아이콘에 대한 URI |
| summary |
string |
제품 요약 |
| supportedProducts |
string[] |
호환되는 제품 목록에 매핑 |
| uniqueProductId |
string |
고유 제품 식별자 |
ProductSummaryListResult
목록 작업의 사용자 지정 응답입니다.
| Name | 형식 | Description |
|---|---|---|
| nextLink |
string |
항목의 다음 페이지에 대한 링크 |
| value |
이 페이지의 항목 |