View a markdown version of this page

AWS Marketplace 계약 API 사용 - AWS Marketplace
주요 개념엔드포인트권한

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

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

AWS Marketplace 계약 API 사용

AWS Marketplace 는 고객이 솔루션을 구축하고 비즈니스를 운영하기 위해 타사 소프트웨어, 데이터 및 서비스를 찾고, 구매하고, 배포하고, 관리하는 데 사용할 수 있는 엄선된 디지털 카탈로그입니다. AWS Marketplace 계약 서비스는 구매자와 판매자가 계약 나열, 검색 및 필터링을 포함하여 계약을 관리하는 데 도움이 AWS Marketplace 되는 API 인터페이스를 제공합니다.

주요 개념

다음 표에서는 AWS Marketplace 계약 API에 사용되는 주요 개념을 설명합니다.

개념 설명
수락자 계약에서 제안자가 연장한 약관의 전부 또는 일부를 수락하는 당사자입니다. 대부분의 일반적인 사용 사례에서 수락자는 제품의 구매자입니다.
계약 제안자(일반적으로 판매자/ISV 또는 채널 파트너)와 수락자(일반적으로 구매자)를 포함하여 두 당사자를 바인딩하고 이들 간에 적용되는 이용 약관을 정의하는 문서입니다.
계약 취소 요청 판매자(제안자)가 활성 계약을 취소하기 위해 시작한 요청입니다. 구매자(수락자)는 취소 요청을 수락하거나 거부할 수 있습니다. 수락하면 계약 취소 워크플로가 비동기적으로 실행되고 계약 상태가 취소됨으로 변경됩니다. 거부된 경우 계약은 활성 상태로 유지되며 판매자는 새 취소 요청을 제출할 수 있습니다.
계약 제안 판매자/제안자가 제안한 용어/제안 세트를 참조하는 엔터티입니다.
계약 요청 고객 작업의 결과로 생성된 리소스를 참조하는 엔터티로, 요청 수락 시 계약 생성/수정 파라미터, 요청 수명 주기 및 예상 결과를 간략하게 설명합니다.
청구 가능한 차원 제품 가격 책정 방식과 관련된 요소. 예를 들어 Amazon Machine Image(AMI) 제품의 경우 Amazon Elastic Compute Cloud(Amazon EC2) 인스턴스, 서비스형 소프트웨어(SaaS) 제품의 경우 읽기 전용 사용자와 비교한 프리미엄 인스턴스입니다.
채널 파트너(CP) 제품 소유자(ISV)가 대신 제품을 재판매할 권한을 부여한 조직입니다 AWS Marketplace.
독립 소프트웨어 공급업체(ISVs) 자체 제품을 나열하고 관리하는 판매자 AWS Marketplace.
의도 의도는 계약을 생성하는 동안 구매자가 갖는 동기를 나타냅니다. 현재 지원되는 의도는 계약 생성 흐름 중에 신규, 수정 및 교체입니다.
결제 요청 계약과 관련된 결제에 대해 판매자(제안자)가 시작한 요청입니다. 구매자(수락자)는 결제 요청을 수락하거나 거부할 수 있습니다.
제안자 가장 일반적으로 제안을 사용하여 계약의 초기 조건 집합을 연장하는 당사자입니다.
구매 주문 조직은 구매자에게 구매 주문을 사용하여 승인된 공급업체로부터 구매하고, 구매 대상을 추적하고, 지출이 예측되고, 예산이 책정되고, 승인되고, 책임 있는 비용 센터(들)에 할당되도록 해야 합니다.
Resource 판매자가 판매하려는 단위 또는 리소스로 AWS Marketplace, 종종 기본 제품이라고 합니다. 기본 제품은 제품 정보, 배포 속성 및 결제 정보가 추가될 때까지 구매자 소비를 위해 완료되지 않습니다. 제품은 판매자가 판매하려는 목록의 제품 정보, 소프트웨어 배포 속성 및 결제 메커니즘을 설명합니다. 구매자가 판매하고 사용할 수 있는 거래 가능한 단위가 되려면 제품을 제안과 페어링해야 합니다 AWS Marketplace.
Term 계약 적용 방식(예: 요금)을 관리하는 계약 내 단위입니다.

엔드포인트

다음 엔드포인트를 사용하여 AWS Marketplace 계약 서비스에 액세스할 수 있습니다.

엔드포인트 리전 지원되는 IP 프로토콜
agreement-marketplace.us-east-1.api.aws 미국 동부(버지니아 북부) IPv4, IPv6

권한

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

오류 코드

다음 오류 코드는 AWS Marketplace 계약 서비스 작업에 적용됩니다. 여러 사용 사례에 대해 단일 오류 코드가 반환될 수 있습니다. 각 오류 코드가 발생하는 특정 시나리오를 식별하려면 아래 설명을 참조하세요. 이 목록은 전체 목록이 아니며 새 기능이 릴리스될 때 업데이트될 수 있습니다.

ValidationException

오류 코드 설명
INVALID_SOURCE_AGREEMENT_IDENTIFIER 소스 계약 식별자가 예상 형식과 일치하지 않거나 소스 계약 식별자가 필요하지 않은 의도에 대해 제공된 경우(예: 신규) 반환됩니다.
MISSING_SOURCE_AGREEMENT_IDENTIFIER 소스 계약 식별자가 필요한 의도(예: REPLACE 또는 AMEND)에 대해 제공되지 않은 경우 반환됩니다.
INVALID_REQUESTED_TERM_CONFIGURATION

요청된 용어 구성이 유효하지 않을 때 반환됩니다. 가능한 시나리오:

  • 구성은 수락하지 않는 용어에 대해 제공됩니다.

  • 필수 구성이 누락되었습니다.

  • 선택기 값은 계약 제안에 속하지 않습니다.

  • 여러 차원 선택이 허용되지 않는 경우 차원에는 하나의 차원만 포함될 수 있습니다.

  • 차원 키는 계약 제안 또는 수락된 조건에서 인식되지 않습니다.

  • 차원에 수량 구성이 활성화되지 않은 경우 차원 값은 1일 수 있습니다.

  • 구성에는 중복 차원 키가 포함되어 있습니다.

  • 구성은 소스 계약과 다르지 않습니다.
INVALID_AGREEMENT_PROPOSAL_IDENTIFIER 계약 제안 식별자가 예상 형식과 일치하지 않거나 계약 제안 식별자가 필요하지 않은 의도(예: AMEND)에 대해 제공된 경우 반환됩니다.
MISSING_AGREEMENT_PROPOSAL_IDENTIFIER 계약 제안 식별자가 필요한 의도(예: NEW 또는 REPLACE)에 대해 제공되지 않은 경우 반환됩니다.
INVALID_FILTER_NAME 제공된 필터 이름이 인식된 필터가 아니거나 요청에 중복 필터 이름이 포함된 경우에 반환됩니다.
INVALID_FILTER_VALUES 필터 값이 유효하지 않거나, 중복되거나, 비어 있거나, 허용되는 최대 개수를 초과하거나, 날짜 범위 필터가 BeforeEndTime 값 앞에 값을 지정할 때 반환됩니다AfterEndTime.
INVALID_NEXT_TOKEN 페이지 매김 토큰의 형식이 잘못되었거나, 만료되었거나, 해독할 수 없거나, 페이지 매김된 호출 간에 요청 파라미터가 변경된 경우에 반환됩니다.
DUPLICATE_CHARGES 요청에 중복된 요금 식별자가 포함되어 있거나 동일한 요금 식별자에 대해 다른 구매 주문 값이 제공되는 경우 반환됩니다.
UNSUPPORTED_FILTERS 제공된 필터 조합이 지원되지 않을 때 반환됩니다. 지원되는 필터 조합은 당사자 유형에 따라 다릅니다. 퍼블릭 설명서에서 지원되는 조합을 확인합니다.
INVALID_PURCHASE_ORDER_REFERENCE 구매 주문 참조가 형식 요구 사항을 충족하지 않거나 계정 관리자가 구성한 대로 필수 구매 주문이 제공되지 않은 경우 반환됩니다.
INVALID_CHARGE_AMOUNT

청구 금액이 유효하지 않을 때 반환됩니다. 가능한 시나리오:

  • 청구 금액이 해당 기간의 최대 총 청구 금액을 초과합니다.

  • 요금 금액 형식이 통화 요구 사항(예: 소수 자릿수가 너무 많음)과 일치하지 않습니다.

  • 계약이 최대 총 청구 금액에 도달했기 때문에 남은 금액이 없습니다.
UNSUPPORTED_ACTION

요청된 작업이 리소스의 현재 상태에 대해 지원되지 않을 때 반환됩니다. 특정 시나리오는 API에 따라 다릅니다.

  • UpdatePurchaseOrders - 청구 날짜가 과거이고 자동 갱신이 비활성화되었거나, 청구 날짜가 3시간 이내이거나, 청구가 환불 요금이거나, 청구 수정이 최신이 아니거나, 구매 주문이 모두 동일한 계약에 속하지 않거나, 계약이 활성 상태가 아닙니다.

  • CreateAgreementRequest - 장래 날짜 계약 수정이 지원되지 않거나, 리소스 유형 및 기간 유형 조합이 요청된 의도를 지원하지 않거나, 활성 계약을 장래 날짜 계약으로 대체할 수 없거나, 수정 중에 계약 기간을 변경할 수 없거나, 현재 계약을 업데이트할 수 없거나(예: 보류 중인 권한 있음), 계약 제안이 소스 계약과 동일한 리소스를 참조하거나, 계약 제안이 소스 계약과 달라야 하거나, 계약 유형이이 작업을 지원하지 않습니다.

  • AcceptAgreementRequest - 리소스 유형 및 기간 유형 조합이이 작업을 지원하지 않거나, 계약 유형이이 작업을 지원하지 않거나, 활성 계약이 이미 동일한 리소스에 있거나, 현재 계약을 업데이트할 수 없습니다.

  • CancelAgreement - 계약에 보류 중인 권한이 있거나, 계약 유형이 취소를 지원하지 않거나, 와의 계약이 동일한 리소스에서 활성 상태ConfigurableUpfrontPricingTermPaymentScheduleTerm인 동안 계약을 취소할 UsageBasedPricingTerm 수 없거나, 리소스 유형과 기간 유형 조합이 취소를 지원하지 않습니다.

  • GetBillingAdjustmentRequest - 계약이 비구매 계약 유형이거나 호출자가 계약의 수락자입니다.

  • SendAgreementCancellationRequest - 계약 유형은이 작업을 지원하지 않습니다.

  • AcceptAgreementCancellationRequest - 계약 유형은이 작업을 지원하지 않습니다.

  • RejectAgreementCancellationRequest - 계약 유형은이 작업을 지원하지 않습니다.

  • CancelAgreementCancellationRequest - 계약 유형은이 작업을 지원하지 않습니다.

  • GetAgreementCancellationRequest - 계약은 비구매 계약 유형입니다.

ResourceNotFoundException

에는 찾을 수 없는 리소스를 식별하는 resourceType 및 resourceId 필드가 ResourceNotFoundException 포함되어 있습니다. 다음 표에서는 각 리소스 유형에 대해이 예외를 일으킬 수 있는 시나리오를 설명합니다.

참고

보안상의 이유로 리소스가 없거나 호출자가 리소스에 액세스할 수 없는 경우에도 동일한 오류가 반환됩니다. 이렇게 하면 유효한 리소스 식별자가 열거되지 않습니다.

리소스 유형 가능한 시나리오
AgreementProposal

  • 지정된 식별자에 대한 계약 제안을 찾을 수 없습니다.

  • 제안은 수락자를 대상으로 하지 않습니다.

  • 수락자의 국가에서는 제안을 사용할 수 없습니다.
Agreement

  • 지정된 식별자에 대한 계약을 찾을 수 없습니다.

  • 호출자는 계약의 수락자도 제안자도 아닙니다.
AgreementRequest

  • 지정된 식별자에 대한 계약 요청을 찾을 수 없습니다.

  • 계약 요청은 다른 호출자에게 속합니다.

  • 계약 요청이 만료되었습니다.

  • 계약 요청이 동일한 제품 또는 제안에 대해 이후에 수락된 요청으로 대체되었습니다.

  • 재게시 제안 또는 제안 만료로 인해 CreateAgreementRequest 및 AcceptAgreementRequest 호출 간에 계약 제안이 비활성화되었습니다.
Charge

  • 지정된 식별자에 대한 요금이 없습니다.

  • 요금은 지정된 계약에 속하지 않습니다.
BillingAdjustmentRequest

  • 지정된 식별자에 대한 결제 조정 요청을 찾을 수 없습니다.

  • 호출자는 조정과 관련된 계약의 수락자도 제안자도 아닙니다.
AgreementCancellationRequest

  • 지정된 식별자에 대한 계약 취소 요청을 찾을 수 없습니다.

  • 호출자는 취소 요청과 관련된 계약의 수락자도 제안자도 아닙니다.
PaymentRequest

  • 지정된 식별자에 대한 결제 요청을 찾을 수 없습니다.

  • 호출자는 결제 요청과 관련된 계약의 수락자도 제안자도 아닙니다.