View a markdown version of this page

AWS Marketplace Discovery API 사용 - AWS Marketplace
서비스 엔드포인트API 버전데이터 모델Authentication요청하기응답 형식AWS SDK 사용페이지 매김Throttling

AWS Marketplace API 참조가 재구성되었습니다. 지원되는 API 작업에 대한 자세한 내용은 AWS Marketplace API 참조를 참조하세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

AWS Marketplace Discovery API 사용

AWS Marketplace Discovery API는 AWS Marketplace 카탈로그에 대한 프로그래밍 방식의 액세스를 제공합니다. 이를 사용하여 제품 및 요금 정보를 검색하고, 통합 조달 경험을 구축하고, 사용자 지정 매장을 만들 수 있습니다.

서비스 엔드포인트

Discovery API는 다음 엔드포인트 형식을 사용합니다.

https://discovery-marketplace.region.api.aws

예를 들어 미국 동부(버지니아 북부)에서 API를 호출하려면

https://discovery-marketplace.us-east-1.api.aws

API 버전

현재 API 버전은 입니다2026-02-05.

데이터 모델

Discovery API는 AWS Marketplace 카탈로그를 다음 개체로 구성합니다.

  • 목록 - 구매자에게 표시되는 제품 또는 다중 제품 솔루션. 목록에는 설명, 하이라이트, 범주, 배지, 요금 모델, 요금 단위, 리뷰, 프로모션 미디어, 판매자 참여, 이행 옵션 유형, 관련 제품 및 제안에 대한 참조가 포함됩니다. GetListing를 사용하여 목록을 검색하거나 SearchListings를 사용하여 목록 간에 검색합니다.

  • 제품 - 판매 중인 기본 소프트웨어 또는 서비스입니다. 제품에는 구매자가 제품을 배포하거나 액세스하는 방법을 설명하는 설명, 하이라이트, 범주, 프로모션 미디어, 판매자 참여 및 이행 옵션(예: AMI, SaaS, 컨테이너 또는 Helm)이 포함됩니다. GetProduct를 사용하여 제품 세부 정보를 검색하고 ListFulfillmentOptions를 사용하여 제품에 대한 세부 이행 옵션을 검색합니다.

  • 제안 - 요금 모델, 기록 판매자, 가용성 날짜 및 배지를 포함한 제품의 요금 약정입니다. 제안에는 사용량 기반 요금, 고정 선결제 요금, 무료 평가판 기간, 법률 문서, 결제 일정 및 갱신 조건과 같은 상업적 조건이 포함됩니다. ListPurchaseOptions를 사용하여 제품에 사용할 수 있는 모든 제안을 찾고, 제안의 세부 정보를 GetOffer 검색하고, 제안의 특정 조건을 GetOfferTerms 검색합니다.

  • 제안 세트 - 다중 제품 솔루션의 각 제품에 대한 비공개 제안의 그룹화된 모음입니다. 제안 세트를 사용하면 구매자가 모든 제안을 함께 검토하고 단일 작업으로 동시에 수락할 수 있습니다. ListPurchaseOptions를 사용하여 제품에 사용 가능한 모든 제안 세트를 찾고, 제안 세트의 세부 정보를 GetOfferSet 검색하고, 제안의 세부 정보를 GetOffer 검색하고, 제안의 특정 조건을 GetOfferTerms 검색합니다.

Authentication

Discovery API는 표준 AWS 서명 버전 4(SigV4) 인증을 사용합니다. API를 호출하려면 유효한 AWS 자격 증명과 적절한 IAM 권한이 있어야 합니다. 자세한 내용은 AWS Marketplace Discovery API에 대한 액세스 제어을 참조하세요.

요청하기

모든 Discovery API 작업은 JSON 요청 본문과 함께 HTTP POST 메서드를 사용합니다. 작업 이름은 URL 경로에 지정됩니다.

응답 형식

모든 응답은 JSON 형식으로 반환됩니다. 응답이 성공하면 HTTP 상태 코드 200이 반환됩니다. 오류 응답에는 오류 유형과 메시지가 포함됩니다. 자세한 내용은 일반 오류를 참조하세요.

AWS SDK 사용

Discovery API를 호출하는 권장 방법은 AWS SDK를 사용하는 것입니다. SDK는 인증, 요청 서명, 직렬화 및 오류 처리를 자동으로 처리합니다.

# Python (Boto3) example
import boto3

client = boto3.client('marketplace-discovery', region_name='us-east-1')

response = client.get_listing(
    listingId='listing-saas-abc123'
)

print(response['listingName'])
// JavaScript (AWS SDK v3) example
import { MarketplaceDiscoveryClient, GetListingCommand } from "@aws-sdk/client-marketplace-discovery";

const client = new MarketplaceDiscoveryClient({ region: "us-east-1" });
const response = await client.send(new GetListingCommand({
    listingId: "listing-saas-abc123"
}));

console.log(response.listingName);

페이지 매김

목록을 반환하는 작업(예: ListPurchaseOptions 및 SearchFacets)은를 사용하여 페이지 매김을 지원합니다nextToken. 응답에 nextToken 값이 포함된 경우 다음 요청에 전달하여 추가 결과를 검색합니다.

Throttling

Discovery API는 요청 속도 제한을 적용하여 서비스 가용성을 보장합니다. 속도 제한을 초과하면 API가 ThrottlingException (HTTP 429)를 반환합니다. 애플리케이션에서 지수 백오프 및 재시도 로직을 구현합니다.