AWS Marketplace 측정 서비스를 사용하여 시간당 측정 구성 - AWS Marketplace
시간당 측정을 위한 사전 조건시간당 측정용 제품 로드 양식RegisterUsage의 통합 및 미리 보기 모드 테스트RegisterUsage의 오류 처리

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

AWS Marketplace 측정 서비스를 사용하여 시간당 측정 구성

컨테이너 제품이 사용자 지정 측정 요금 차원 대신 시간당 작업별 또는 포드별 요금을 사용하는 경우 사용자 지정 측정 차원을 정의할 필요가 없습니다. 에서 컨테이너 제품을 사용한 시간당 측정에 AWS Marketplace 측정 서비스를 사용할 수 있습니다 AWS Marketplace. 다음 섹션에서는 AWS Marketplace 측정 서비스를 사용하여 시간당 측정을 구성하는 방법을 보여줍니다.

RegisterUsage API Amazon Elastic Container Service(Amazon ECS) 작업당 또는 Amazon Elastic Kubernetes Service(Amazon EKS) 포드당 시간당 소프트웨어 사용량을 측정하며 사용량은 초 단위로 비례 배분됩니다. 실행 시간이 짧은 작업 또는 포드에 대해서는 최소 1분의 사용량이 적용됩니다. 소프트웨어 사용을 위한 연속 측정은 에서 자동으로 처리됩니다. AWS Marketplace Metering Control Plane. 소프트웨어 사용에 대한 측정이 시작되기 위해 를 RegisterUsage 한 번 호출하는 경우를 제외하고 소프트웨어는 측정별 작업을 수행할 필요가 없습니다.

컨테이너를 시작할 때 RegisterUsage를 즉시 호출해야 합니다. 컨테이너 시작 후 처음 6시간 내에 컨테이너를 등록하지 않으면 AWS Marketplace 측정 서비스는 이전 달에 대한 측정 보증을 제공하지 않습니다. 하지만 이번 달 이후에도 컨테이너가 종료될 때까지 측정이 계속됩니다.

는 AWS Marketplace Metering Control Plane 는 고객의 구독 상태와 관계없이 Amazon ECS 작업 및 Amazon EKS 포드 실행에 대해 고객에게 계속 요금을 청구합니다. 따라서 작업 또는 포드가 성공적으로 시작된 후에는 소프트웨어에서 권한 검사를 수행할 필요가 없습니다.

주제

시간당 측정을 위한 사전 조건

제품을 게시하기 전에 다음을 수행해야 합니다.

  1. 에서 새 컨테이너 제품을 생성하고 해당 제품 코드를 기록 AWS Marketplace Management Portal해 둡니다.

    자세한 내용은 개요: 컨테이너 제품 생성 단원을 참조하십시오.

  2. 를 호출하는 데 필요한 IAM 권한을 사용하여 애플리케이션을 실행하는 태스크 또는 포드에 AWS Identity and Access Management (IAM) 역할을 사용합니다RegisterUsage. IAM 관리형 정책에AWSMarketplaceMeteringRegisterUsage는 이러한 권한이 있습니다.

  3. (선택 사항) 로깅을 보려면 태스크 또는 포드 정의에서 AWS CloudTrail 로깅을 활성화하는 것이 좋습니다.

  4. 정의한 모든 요금 차원에 대한 레코드를 사용하여 RegisterUsage API 작업에 대한 테스트 호출을 수행합니다.

시간당 측정용 제품 로드 양식

시간당 측정용 제품 로드 양식을 작성할 때는 제품을 정의하는 다른 필수 및 선택 사항 필드 외에 제품에 대한 다음 필드를 작성합니다.

  • 시간당 요금 - 제품의 시간당 요금입니다.

  • 차원 장기 요금 - 구매자가 요금을 선결제하는 경우 장기 계약 기간의 총 소프트웨어 요금입니다.

  • 장기 기간(일) - 장기 계약의 기간(일)입니다.

RegisterUsage의 통합 및 미리 보기 모드 테스트

게시를 AWS Marketplace 위해 이미지를 에 제출하기 전에 RegisterUsage API 작업을 사용하여 통합을 테스트합니다.

미리보기 모드는 프로덕션 모드와 동일한 방식으로 작동합니다. 단, 미리보기 모드에는 제품 사용에 대한 권한 부여를 확인하는 기능이 없습니다. 미리 보기 모드에서 를 호출하려면 Amazon ECS 또는 Amazon RegisterUsage 에서 제품을 실행하여 컨테이너 이미지RegisterUsage에서 를 호출합니다EKS. 사용 중인 AWS 계정 를 사용하여 에 제품을 나열합니다 AWS Marketplace. 측정 통합은 하드코딩 AWS 리전이 아닌 를 동적으로 설정해야 합니다. 그러나 테스트할 때는 미국 동부(버지니아 북부) 리전에서 유료 컨테이너가 포함된 Amazon ECS 작업 또는 Amazon EKS 포드를 하나 이상 시작합니다. 이렇게 하면 AWS Marketplace 운영 팀이 해당 리전의 로그로 작업을 확인할 수 있습니다.

참고

제품이 Amazon ECS 및 Amazon 를 모두 지원하는 경우 통합을 검증하려면 Amazon EKS for Amazon 에서 EKS를 시작하면 됩니다.

제품과 함께 필요한 모든 메타데이터 및 요금 정보가 게시될 때까지는 통합에 대한 완전한 테스트가 어렵습니다. 요청 시 AWS Marketplace 카탈로그 운영 팀은 미리 보기 모드에서 측정 레코드의 수신을 확인할 수 있습니다.

RegisterUsage의 오류 처리

컨테이너 이미지가 와 통합 AWS Marketplace Metering Service 되고 컨테이너 시작 ThrottlingException 시 이외의 예외를 받는 경우 무단 사용을 방지하기 위해 컨테이너를 종료해야 합니다.

이외의 예외ThrottlingException는 RegisterUsage API 작업에 대한 초기 호출에서만 발생합니다. 동일한 Amazon ECS 작업 또는 Amazon EKS 포드의 후속 호출은 고객이 작업 또는 포드가 여전히 실행되는 동안 구독을 취소CustomerNotSubscribedException하더라도 발생하지 않습니다. 이러한 고객은 구독을 취소한 후에도 사용량을 추적하여 컨테이너 실행에 대한 요금이 계속 청구됩니다.

다음 표에서는 RegisterUsage API 작업에서 발생할 수 있는 오류를 설명합니다. 각 AWS SDK 프로그래밍 언어에는 추가 정보를 위해 참조할 수 있는 오류 처리 지침 세트가 있습니다.

오류 설명
InternalServiceErrorException RegisterUsage를 사용할 수 없습니다.
CustomerNotEntitledException 고객에게 유효한 제품 구독이 없습니다.
InvalidProductCodeException 요청과 함께 전달된 ProductCode 값이 존재하지 않습니다.
InvalidPublicKeyException 요청과 함께 전달된 PublicKeyVersion 값이 존재하지 않습니다.
PlatformNotSupportedException AWS Marketplace 는 기본 플랫폼에서의 측정 사용량을 지원하지 않습니다. Amazon ECS, Amazon EKS및 만 지원 AWS Fargate 됩니다.
ThrottlingException RegisterUsage 호출에 병목 현상이 발생했습니다.
InvalidRegionException RegisterUsage 는 Amazon ECS 작업 또는 Amazon 포드가 시작된 AWS 리전 것과 동일한 EKS 에서 호출되어야 합니다. 그래야만 RegisterUsage 호출 시 컨테이너가 리전(예: withRegion(“us-east-1”))을 선택하지 않습니다.