다음을 통해 공유


마켓플레이스 계량 서비스를 사용하는 Azure Containers의 계량 청구

상업용 마켓플레이스 계량 서비스를 사용하면 비표준 단위에 따라 청구되는 Azure 컨테이너 제품을 만들 수 있습니다. 상업용 Marketplace에 제품을 게시하기 전에 대역폭, 분할된 데이터베이스, 로그 파일, 스캔, 처리된 전자 메일 등과 같은 청구 차원을 정의합니다. 그런 다음 고객은 이러한 차원의 소비량에 따라 비용을 지불하며, 애플리케이션은 상업용 Marketplace 계량 서비스 API를 통해 청구 가능한 이벤트의 Microsoft에 알립니다.

요금제 청구를 위한 필수 구성 요소

Azure Container 제품이 요금제 청구를 사용하려면 먼저 azure Container 제품 플랜에 설명된 라이선스 옵션 검토하고 기존의 6가지 미리 정의된 청구 모델 중 하나에서 충족되지 않는 사용자 지정 청구 요구 사항이 있는지 확인해야 합니다.

그런 다음 Azure Container 제품은 상업용 마켓플레이스 계량 서비스 API를 통합함으로써 Microsoft에 청구 가능 이벤트를 알릴 수 있습니다.

중요하다

애플리케이션은 상업용 Marketplace 계량 서비스 API를 호출해야 합니다. 현재 호스팅된 서비스(애플리케이션 외부)가 계량 서비스 API를 호출하도록 하는 옵션은 없습니다.

메모

Marketplace 계량 서비스는 사용자 지정 청구 모델에서만 사용할 수 있으며 사용자당 청구 모델에는 적용되지 않습니다.

요금제 청구가 가격 책정에 적합한 방법

제품 계층 구조를 이해하는 것은 가격 책정 모델과 함께 제품을 정의할 때 중요합니다.

  • 각 제안은 Microsoft를 통해 판매되도록 하거나 그렇지 않도록 구성됩니다. 제안이 게시되면 이 옵션을 변경할 수 없습니다.
  • Microsoft를 통해 판매하도록 구성된 각 제품에는 하나 이상의 플랜이 있을 수 있습니다.
  • 각 플랜에는 사용량 기반 월별 청구 플랜 또는 BYOL(Bring Your Own License)가격 책정 모델이 있습니다. 사용량 기반 월별 청구 플랜의 경우 무료, 미리 정의된 6가지 청구 옵션 중 하나 또는 사용자 지정을 선택할 수 있습니다.
  • 가격 책정 모델 및 가격 입력 옵션은 게시된 후에는 업데이트할 수 없습니다.
  • 각 요금제에는 완전한 가격 책정 계획이 있어야 합니다.
  • 청구 요구 사항을 충족하기 위해 고객에게 요금을 청구하기 위해 사용자 지정 차원을 사용하여 가격을 선택할 수 있습니다. 각 차원은 서비스가 상업용 Marketplace 계량 서비스 API을 사용하여 Microsoft와 통신하는 청구 가능한 단위를 나타냅니다.

중요하다

코드의 사용량을 추적하고 고객에게 청구서를 보낼 사용량에 대해서만 사용 이벤트를 Microsoft로 보내야 합니다.

메모

제안은 제안이 생성될 당시 게시된 현지 시장 가격을 사용하여 고객의 계약 통화로 고객에게 청구됩니다. 고객이 지불하고 ISV가 지급되는 금액은 고객이 제품을 거래할 때의 환율에 따라 달라집니다. "통화를 변환하는 방법"대해 자세히 알아보세요.

샘플 사용자 지정 가격 책정 옵션

예를 들어 Contoso는 Kubernetes 애플리케이션의 샤딩 논리에 그들의 지적 재산(IP)이 있는 게시자입니다. Contoso는 사용된 분할된 데이터베이스 수에 따라 고객에게 요금을 청구하려고 합니다. 또한 편리하고 경쟁력 있는 다른 청구 옵션을 모색하고 있습니다. Contoso는 상업용 Marketplace 프로그램의 파트너 센터에서 게시자로 등록되며 Azure 고객에게 컨테이너 제품을 게시하려고 합니다. Contoso와 연결된 4개의 계획이 있으며 아래에 설명되어 있습니다.

  • 시간당 사용되는 샤드당 요금(예: $1,000/샤드/시간)

    ko-KR: 사용된 샤드당 시간별 요금을 보여주는 스크린샷

  • 일회성 결제 또는 반복 청구 모델링: Contoso가 애플리케이션에서 최대 100개의 로그 파일을 사용하는 경우 고객에게 $449/mo를 청구하려고 합니다. Contoso의 애플리케이션 논리는 월의 사용 이벤트를 추적하고 100 로그 파일 사용량에 대한 월말에 요금을 트리거합니다.

    일회성 결제 또는 반복 청구 모델링을 보여 주는 스크린샷

  • 계층화된 청구 모델링: Contoso가 최대 100개의 분할된 데이터베이스에 대해 $449/mo를 청구한 다음 초과분에 대해 계층화된 가격을 청구한다고 가정해 보겠습니다. 애플리케이션 논리는 해당 월의 사용량을 추적하고, 그에 따라 사용량을 분할하고, 기간이 끝날 때 아래 계량 API를 사용하여 보고합니다.

    계층화된 청구 모델링을 보여 주는 스크린샷

  • 다차원 청구: Contoso는 사용자 지정 계량 기능을 사용하여 여러 차원을 사용하여 고급 청구에 대한 요구 사항을 충족할 수도 있습니다.

    다차원 청구를 보여 주는 스크린샷

선택한 플랜에 따라 Contoso Container 제품을 가져오는 Azure 고객은 사용량에 따라 요금이 청구됩니다. Contoso는 Microsoft에 사용 이벤트를 보내지 않고 사용량을 계산합니다. 고객이 적절한 금액을 사용하거나 주기적으로 사용하는 경우 Contoso는 사용량을 보고합니다. 고객은 계획을 변경하거나 다른 작업을 수행할 필요가 없습니다. Contoso는 사용량을 측정하고 상업용 Marketplace 계량 서비스 API사용하여 초과분 사용량을 청구하기 위해 Microsoft에 사용량 이벤트를 내보내기 시작합니다. Microsoft는 사용자 지정 차원의 게시자가 지정한 사용량에 대해 고객에게 요금을 청구합니다. 청구는 다음 월별 청구 주기에서 수행됩니다.

청구 기준

각 청구 차원은 ISV가 사용 이벤트를 내보낼 수 있는 사용자 지정 단위를 정의합니다. 청구 차원은 소프트웨어 사용에 대한 요금이 청구되는 방식에 대해 고객과 통신하는 데도 사용됩니다. 다음과 같이 정의됩니다.

  • ID: 사용 이벤트를 내보내는 동안 참조되는 변경할 수 없는 차원 식별자입니다.
  • 표시 이름: 차원과 연결된 표시 이름(예: "보낸 문자 메시지")입니다.
  • 측정 단위: 청구 단위에 대한 설명입니다(예: "문자 메시지당" 또는 "100개 이메일당").
  • USD 단위당가격: 차원의 한 단위에 대한 가격입니다. 0일 수 있습니다.

중요하다

애플리케이션 코드의 사용량을 추적하고 청구 요구 사항에 따라 사용 이벤트를 Microsoft에 보내야 합니다.

청구 차원은 오퍼에 대한 모든 플랜에서 공유됩니다. 일부 특성은 모든 계획에서 차원에 적용되고 다른 특성은 계획별로 적용됩니다.

차원 자체를 정의하는 특성은 제안의 모든 계획에서 공유됩니다. 오퍼를 게시하기 전에, 어떤 계획의 맥락에서 이러한 속성을 변경하면 모든 계획의 차원 정의에 영향을 미칩니다. 제품을 게시하면 이러한 특성을 더 이상 편집할 수 없습니다. 이러한 특성은 다음과 같습니다.

  • 아이디
  • 표시 이름
  • 측정 단위

차원의 다른 특성은 각 계획에 따라 다르며 계획마다 다른 값을 가질 수 있습니다. 계획을 게시하기 전에 이러한 값을 편집할 수 있으며 이 계획만 영향을 받습니다. 계획을 게시하면 이러한 특성을 더 이상 편집할 수 없습니다. 이러한 특성은 다음과 같습니다.

  • 단위당 가격(USD)

차원에는 "활성화됨"이라는 특별한 개념도 있습니다.

  • 활성화됨 이 계획이 이 차원에 참여하고 있음을 나타냅니다. 이 차원에 따라 사용 이벤트를 보내지 않는 새 계획을 만드는 경우 이 옵션을 선택 취소한 상태로 두는 것이 좋습니다. 또한 계획을 처음 게시한 후 추가된 새 차원은 이미 게시된 계획에 "사용 안 함"으로 표시됩니다. 비활성화된 차원은 고객이 볼 수 있는 플랜의 차원 목록에 표시되지 않습니다.

메모

다음 시나리오는 명시적으로 지원됩니다.

  • 새 계획에 새 차원을 추가할 수 있습니다. 이미 게시된 계획에는 새 차원이 활성화되지 않습니다.

지원되는 시장별 단위 차원 가격 설정

다른 사용량 기반 가격 책정과 마찬가지로 청구 차원 가격은 지원되는 국가 또는 지역에 따라 설정할 수 있습니다. 다음과 같이 파트너 센터에서 가격 책정 데이터 가져오기 및 내보내기 기능을 사용해야 합니다.

  1. 원하는 차원을 정의하고 지원되는 시장을 표시합니다.
  2. 이 데이터를 파일로 내보냅니다.
  3. 국가/지역당 올바른 가격을 추가하고 파트너 센터에서 파일을 가져옵니다.

미터기의 사용자 인터페이스는 치수의 가격이 파일에서만 볼 수 있도록 변경됩니다.

측정기의 사용자 인터페이스를 보여 주는 스크린샷

프라이빗 플랜

미리 정의된 사용량 기반 청구 계획과 마찬가지로 사용자 지정 차원이 있는 플랜은 계획의 정의된 대상만 액세스할 수 있는 프라이빗 플랜으로 설정할 수 있습니다.

제약 조건

잠금 동작

상업용 Marketplace 계량 서비스와 함께 사용되는 차원은 고객이 서비스에 대해 지불하는 방식을 이해하므로 차원에 대한 모든 세부 정보는 게시한 후에 더 이상 편집할 수 없습니다. 계획을 게시하기 전에 차원을 완전히 정의하는 것이 중요합니다.

차원이 포함된 제안이 게시된 후에는 해당 차원의 제안 수준 세부 정보를 더 이상 변경할 수 없습니다.

  • 아이디
  • 표시 이름
  • 측정 단위

계획이 게시되면 이 계획 수준 세부 정보를 더 이상 변경할 수 없습니다.

  • 계획에 차원을 사용할 수 있는지 여부

최대 한계

단일 제품에 대해 구성할 수 있는 최대 차원 수는 30개의 고유한 차원입니다.

Azure Container 사용량 기준 청구

요금제 청구 API는 게시자가 파트너 센터에 게시할 제품에 대한 사용자 지정 계량 차원을 만들 때 사용해야 합니다. 미터링 청구 API와의 통합은 사용자 지정 차원을 가진 하나 이상의 플랜이 포함된 구매한 오퍼의 사용 이벤트를 발생시키기 위해 필요합니다.

중요하다

Kubernetes Apps에 대한 사용자 지정 계량 차원을 만드는 방법에 대한 자세한 내용은 Azure Container Offer만들기를 참조하세요.

TLS 1.2 강제 적용 안내

TLS 버전 1.2 버전은 HTTPS 통신을 위한 최소 버전으로 적용됩니다. 코드에서 이 TLS 버전을 사용해야 합니다. TLS 버전 1.0 및 1.1은 더 이상 사용되지 않으며 연결 시도가 거부됩니다.

계량 청구 단일 사용 기록

특정 고객이 구매한 플랜에 대한 활성 리소스(구독)에 대해 사용 이벤트를 내보내려면 게시자가 사용 이벤트 API를 호출해야 합니다. 사용 이벤트는 제품을 게시할 때 게시자가 정의한 계획의 각 사용자 지정 차원에 대해 별도로 내보내집니다.

자원 및 차원당 달력 일의 각 시간에 대해 하나의 사용 이벤트만 내보낼 수 있습니다. 한 시간에 둘 이상의 단위를 사용하는 경우 해당 시간에 사용된 모든 단위를 누적한 다음 단일 이벤트에서 내보낸다. 사용량 이벤트는 지난 24시간 동안만 내보낼 수 있습니다. 8:00에서 8:59:59 사이에 언제든지 사용 이벤트를 내보내고 같은 날 8:00에서 8:59:59 사이에 다른 이벤트를 보내면 중복으로 거부됩니다.

POST: https://marketplaceapi.microsoft.com/api/usageEvent?api-version=<ApiVersion>

쿼리 매개 변수:

매개 변수 추천
ApiVersion 2018-08-31을 사용합니다.

요청 헤더:

콘텐츠 유형(Content-type) application/json 사용
x-ms-requestid 클라이언트에서 요청을 추적하기 위한 고유 문자열 값(GUID)입니다. 이 값이 제공되지 않으면 응답 헤더에 값이 생성되고 제공됩니다.
x-ms-correlationid 클라이언트에서 작업에 대한 고유 문자열 값입니다. 이 매개 변수는 클라이언트 작업의 모든 이벤트와 서버 쪽의 이벤트 상관 관계를 지정합니다. 이 값이 제공되지 않으면 응답 헤더에 값이 생성되고 제공됩니다.
authorization 이 API 호출을 만드는 ISV를 식별하는 고유한 액세스 토큰입니다. 게시자가 토큰 값을 검색할 때 그 형식은 "Bearer <access_token>"이며, 이는 Kubernetes 애플리케이션의 인증 전략에서 설명된 것입니다.

요청 본문 예제:

{
  "resourceUri": "<ARM resource URI of the Kubernetes app instance>", // unique identifier of the resource against which usage is emitted. 
  "quantity": 5.0, // how many units were consumed for the date and hour specified in effectiveStartTime, must be greater than 0 or a double integer
  "dimension": "dim1", // custom dimension identifier
  "effectiveStartTime": "2018-12-01T08:30:14", // time in UTC when the usage event occurred, from now and until 24 hours back
  "planId": "plan1", // id of the plan purchased for the offer
}

메모

Kubernetes 앱의 경우 resourceUri Kubernetes 앱 인스턴스의 ARM 리소스 URI입니다.

응답

코드: 200
그래. 사용량 배출은 추가 처리 및 청구를 위해 Microsoft 쪽에 허용 및 기록되었습니다.

응답 페이로드 예제:

{
  "usageEventId": <guid>, // unique identifier associated with the usage event in Microsoft records
  "status": "Accepted" // this is the only value in case of single usage event
  "messageTime": "2020-01-12T13:19:35.3458658Z", // time in UTC this event was accepted
  "resourceUri": "<ARM resource URI of the Kubernetes app instance>", // unique identifier of the resource against which usage is emitted. For SaaS it's the subscriptionId.
  "quantity": 5.0, // amount of emitted units as recorded by Microsoft
  "dimension": "dim1", // custom dimension identifier
  "effectiveStartTime": "2018-12-01T08:30:14", // time in UTC when the usage event occurred, as sent by the ISV
  "planId": "plan1", // id of the plan purchased for the offer
}

코드: 400
잘못된 요청입니다.

  • 제공된 요청 데이터가 없거나 잘못되었습니다.
  • effectiveStartTime은 24시간 이상 지났습니다. 이벤트가 만료되었습니다.

응답 페이로드 예제:

{
  "message": "One or more errors have occurred.",
  "target": "usageEventRequest",
  "details": [
    {
      "message": "The resourceUri is required.",
      "target": "ResourceUri",
      "code": "BadArgument"
    }
  ],
  "code": "BadArgument"
}

코드: 400
잘못된 요청입니다.

  • 리소스 URI는 이미 이전에 등록되어 있습니다. 사용량을 제출하기 전에 24시간 동안 기다려야 합니다.

응답 페이로드 예제:

{
  "message": "One or more errors have occurred.",
  "target": "usageEventRequest",
  "details": [
    {
      "message": "Invalid usage state.",
      "target": "ResourceUri",
      "code": "BadArgument"
    }
  ],
  "code": "BadArgument"
}

코드: 403

금지된. 권한 부여 토큰이 제공되지 않았거나, 잘못되었거나, 만료되었습니다.

코드: 409
충돌. 지정된 리소스 ID, 유효 사용 날짜 및 시간에 대한 사용 이벤트가 이미 보고되었습니다.

응답 페이로드 예제:

{
  "additionalInfo": {
    "acceptedMessage": {
      "usageEventId": "<guid>", //unique identifier associated with the usage event in Microsoft records
      "status": "Duplicate",
      "messageTime": "2020-01-12T13:19:35.3458658Z",
      "resourceUri": "<ARM resource URI of the Kubernetes app instance>", //unique identifier of the resource against which usage is emitted.
      "quantity": 1.0,
      "dimension": "dim1",
      "effectiveStartTime": "2020-01-12T11:03:28.14Z",
      "planId": "plan1"
    }
  },
  "message": "This usage event already exist.",
  "code": "Conflict"
}

계량 청구 일괄 사용 이벤트

일괄 처리 사용 이벤트 API를 사용하면 둘 이상의 구매한 리소스에 대한 사용 이벤트를 한 번에 내보냅니다. 또한 동일한 리소스에 대해 다른 일정 시간에 여러 사용 이벤트를 발생시킬 수 있습니다. 단일 일괄 처리의 최대 이벤트 수는 25개입니다.

POST:https://marketplaceapi.microsoft.com/api/batchUsageEvent?api-version=<ApiVersion>

쿼리 매개 변수:

매개 변수 추천
ApiVersion 2018-08-31을 사용합니다.

요청 헤더:

콘텐츠 유형(Content-type) application/json 사용
x-ms-requestid 클라이언트에서 요청을 추적하기 위한 고유 문자열 값(GUID)입니다. 이 값이 제공되지 않으면 응답 헤더에 값이 생성되고 제공됩니다.
x-ms-correlationid 클라이언트에서 작업에 대한 고유 문자열 값입니다. 이 매개 변수는 클라이언트 작업의 모든 이벤트와 서버 쪽의 이벤트 상관 관계를 지정합니다. 이 값이 제공되지 않으면 생성되고 응답 헤더에 제공됩니다.
authorization 이 API 호출을 만드는 ISV를 식별하는 고유한 액세스 토큰입니다. 게시자가 토큰 값을 검색할 때 형식은 Bearer <access_token>이며, 이는 Kubernetes 애플리케이션의 인증 전략에서 설명된 대로입니다.

메모

요청 본문에서 Kubernetes 앱의 리소스 식별자는 resourceUri.

kubernetes 앱에 대한 요청 본문 예제:

{
  "request": [ // list of usage events for the same or different resources of the publisher
    { // first event
      "resourceUri": "<ARM resource URI of the Kubernetes app instance>", // Unique identifier of the resource against which usage is emitted. 
      "quantity": 5.0, // how many units were consumed for the date and hour specified in effectiveStartTime, must be greater than 0 or a double integer
      "dimension": "dim1", //Custom dimension identifier
      "effectiveStartTime": "2018-12-01T08:30:14",//Time in UTC when the usage event occurred, from now and until 24 hours back
      "planId": "plan1", // id of the plan purchased for the offer
    },
    { // next event
      "resourceUri": "<ARM resource URI of the Kubernetes app instance>", 
      "quantity": 39.0, 
      "dimension": "email", 
      "effectiveStartTime": "2018-11-01T23:33:10
      "planId": "gold", // id of the plan purchased for the offer
    }
  ]
}

응답

코드: 200
그래. 추가 처리 및 청구를 위해 일괄 처리 사용량 배출이 허용되고 Microsoft 쪽에 기록되었습니다. 응답 목록은 일괄 처리의 각 개별 이벤트에 대한 상태와 함께 반환됩니다. 응답 페이로드를 반복하여 일괄 처리 이벤트의 일부로 전송된 각 개별 사용 이벤트에 대한 응답을 이해해야 합니다.

응답 페이로드 예제:

{
  "count": 2, // number of records in the response
  "result": [
    { // first response
      "usageEventId": "<guid>", // unique identifier associated with the usage event in Microsoft records
      "status": "Accepted" // see list of possible statuses below,
      "messageTime": "2020-01-12T13:19:35.3458658Z", // Time in UTC this event was accepted by Microsoft,
      "resourceUri": "<ARM resource URI of the Kubernetes app instance>", // unique identifier of the resource against which usage is emitted.
      "quantity": 5.0, // amount of emitted units as recorded by Microsoft 
      "dimension": "dim1", // custom dimension identifier
      "effectiveStartTime": "2018-12-01T08:30:14",// time in UTC when the usage event occurred, as sent by the ISV
      "planId": "plan1", // id of the plan purchased for the offer
    },
    { // second response
      "status": "Duplicate",
      "messageTime": "0001-01-01T00:00:00",
      "error": {
        "additionalInfo": {
          "acceptedMessage": {
            "usageEventId": "<guid>",
            "status": "Duplicate",
            "messageTime": "2020-01-12T13:19:35.3458658Z",
            "resourceUri": "<ARM resource URI of the Kubernetes app instance>",
            "quantity": 1.0,
            "dimension": "email",
            "effectiveStartTime": "2020-01-12T11:03:28.14Z",
            "planId": "gold"
          }
        },
        "message": "This usage event already exist.",
        "code": "Conflict"
      },
      "resourceId": "<guid2>",
      "quantity": 1.0,
      "dimension": "email",
      "effectiveStartTime": "2020-01-12T11:03:28.14Z",
      "planId": "gold"
    }
  ]
}

BatchUsageEvent API 응답에서 참조되는 상태 코드에 대한 설명:

상태 코드 설명
Accepted 허용.
Expired 사용이 만료되었습니다.
Duplicate 중복 사용이 제공되었습니다.
Error 오류 코드입니다.
ResourceNotFound 제공된 사용량 리소스가 잘못되었습니다.
ResourceNotAuthorized 이 리소스에 대한 사용 권한을 제공할 권한이 없습니다.
ResourceNotActive 리소스가 일시 중단되었거나 활성화되지 않았습니다.
InvalidDimension 사용량이 전달되는 차원이 이 제품/플랜에 유효하지 않습니다.
InvalidQuantity 전달된 수량이 0보다 작거나 같습니다.
BadArgument 입력이 없거나 형식이 잘못되었습니다.

코드: 400
잘못된 요청입니다. 일괄 처리에는 25개 이상의 사용 이벤트가 포함되었습니다.

코드: 403
금지된. 권한 부여 토큰이 제공되지 않았거나, 잘못되었거나, 만료되었습니다.

계량 청구 사용량 이벤트 가져오기

사용 이벤트 API를 호출하여 사용 이벤트 목록을 가져올 수 있습니다. ISV는 이 API를 사용하여 구성 가능한 특정 기간 동안 게시된 사용 이벤트와 이러한 이벤트가 API 호출 시점에 있는 상태를 확인할 수 있습니다.

GET: https://marketplaceapi.microsoft.com/api/usageEvents

쿼리 매개 변수:

매개 변수 추천
ApiVersion 2018-08-31을 사용합니다.
사용시작날짜 ISO8601 형식의 DateTime입니다. 예를 들어 2020-12-03T15:00 또는 2020-12-03
UsageEndDate(선택 사항) ISO8601 형식의 DateTime입니다. 기본값 = 현재 날짜
offerId(선택 사항) 기본값 = 가능한 모든 항목
planId(선택 사항) 기본값 = 사용 가능한 모든 항목
차원(선택 가능) 기본값 = 사용 가능한 모든 옵션
azureSubscriptionId(선택 사항) 기본값 = 모두 사용 가능함
reconStatus(선택 사항) 기본값 = 사용 가능한 모든 항목

reconStatus가능한 값은 다음과 같습니다.

ReconStatus 설명
제출 PC 분석에서 아직 처리되지 않음
허용 PC 분석과 일치
거부됨 파이프라인에서 거부되었습니다. 원인을 조사하려면 Microsoft 지원에 문의하세요.
불일치 MarketplaceAPI 및 파트너 센터 분석 수량은 모두 0이 아니지만 일치하지 않습니다.
테스트 헤더들 테스트 헤더와 함께 나열되어 PC Analytics에는 포함되지 않은 구독
DryRun SessionMode=DryRun을 사용하여 제출되었으므로 PC에 없습니다.

요청 헤더:

콘텐츠 형식 애플리케이션/json 사용
x-ms-requestid 클라이언트의 요청을 추적하기 위한 고유 문자열 값(GUID)입니다. 이 값이 제공되지 않으면 응답 헤더에 값이 생성되고 제공됩니다.
x-ms-correlationid 클라이언트에서 작업에 대한 고유 문자열 값입니다. 이 매개 변수는 클라이언트 작업의 모든 이벤트와 서버 쪽의 이벤트 상관 관계를 지정합니다. 이 값이 제공되지 않으면 응답 헤더에 값이 생성되고 제공됩니다.
권한 부여 이 API 호출을 만드는 ISV를 식별하는 고유한 액세스 토큰입니다. 형식은 게시자가 토큰 값을 검색할 때 Bearer <access_token>입니다.
- Kubernetes 애플리케이션의 인증 전략

응답

응답 페이로드 예제:

수락된

[
  {
    "usageDate": "2020-11-30T00:00:00Z",
    "usageResourceId": "11111111-2222-3333-4444-555555555555",
    "dimension": "tokens",
    "planId": "silver",
    "planName": "Silver",
    "offerId": "mycooloffer",
    "offerName": "My Cool Offer",
    "offerType": "SaaS",
    "azureSubscriptionId": "12345678-9012-3456-7890-123456789012",
    "reconStatus": "Accepted",
    "submittedQuantity": 17.0,
    "processedQuantity": 17.0,
    "submittedCount": 17
  }
]

제출됨

[
  {
    "usageDate": "2020-11-30T00:00:00Z",
    "usageResourceId": "11111111-2222-3333-4444-555555555555",
    "dimension": "tokens",
    "planId": "silver",
    "planName": "",
    "offerId": "mycooloffer",
    "offerName": "",
    "offerType": "SaaS",
    "azureSubscriptionId": "12345678-9012-3456-7890-123456789012",
    "reconStatus": "Submitted",
    "submittedQuantity": 17.0,
    "processedQuantity": 0.0,
    "submittedCount": 17
  }
]

불일치

[
  {
    "usageDate": "2020-11-30T00:00:00Z",
    "usageResourceId": "11111111-2222-3333-4444-555555555555",
    "dimension": "tokens",
    "planId": "silver",
    "planName": "Silver",
    "offerId": "mycooloffer",
    "offerName": "My Cool Offer",
    "offerType": "SaaS",
    "azureSubscriptionId": "12345678-9012-3456-7890-123456789012",
    "reconStatus": "Mismatch",
    "submittedQuantity": 17.0,
    "processedQuantity": 16.0,
    "submittedCount": 17
  }
]

거부된

[
  {
    "usageDate": "2020-11-30T00:00:00Z",
    "usageResourceId": "11111111-2222-3333-4444-555555555555",
    "dimension": "tokens",
    "planId": "silver",
    "planName": "",
    "offerId": "mycooloffer",
    "offerName": "",
    "offerType": "SaaS",
    "azureSubscriptionId": "12345678-9012-3456-7890-123456789012",
    "reconStatus": "Rejected",
    "submittedQuantity": 17.0,
    "processedQuantity": 0.0,
    "submittedCount": 17
  }
]

상태 코드

코드: 403 사용할 수 없습니다. 권한 부여 토큰이 제공되지 않았거나, 잘못되었거나, 만료되었습니다.

개발 및 테스트 모범 사례

사용자 지정 미터 배출을 테스트하려면 계량 API와의 통합을 구현하고, 단위당 가격이 0인 사용자 지정 차원이 정의된 게시된 Kubernetes Apps 제품에 대한 계획을 만듭니다. 또한 제한된 사용자만 통합에 액세스하고 테스트할 수 있도록 이 제품을 미리 보기로 게시합니다.

또한 기존 라이브 제품에 대한 프라이빗 플랜을 사용하여 테스트하는 동안 이 계획에 대한 액세스를 제한된 대상으로 제한할 수 있습니다.

지원 받기

다음 문제 중 하나가 있는 경우 지원 티켓을 열 수 있습니다.

  • 마켓플레이스 계량 서비스 API의 기술 문제
  • 오류 또는 버그(예: 잘못된 사용 이벤트)로 인해 에스컬레이션해야 하는 문제입니다.
  • 요금 청구와 관련된 기타 문제

게시자 지원 옵션을 이해하고 Microsoft에서 지원 티켓을 열려면 파트너 센터 상업용 Marketplace 프로그램에 대한지원의 지침을 따릅니다.