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

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

거래 규모 조정 인사이트 활용

거래 규모 조정이란 무엇입니까?

거래 규모 조정은AWS파트너가 기회를 생성하거나 업데이트할 때 AI를 사용하여 자동화된 거래 규모 추정 및AWS서비스 권장 사항을 제공하는 Partner Central의 APN 고객 참여(ACE) 기회 내의 기능입니다.

AI 예상 MRR 추정치

거래 규모 조정 인사이트는 파트너의 과거AWS기회, 사용 사례 및 비즈니스 설명을 기반으로 예측된 월별 반복 수익(MRR) 범위의 중앙값을 제공합니다. 파트너는 거래에 대한 자세한 정보를 수집하고 판매 주기를 진행하므로 총 MRR을 검토하고 업데이트해야 합니다.

AI 권장AWS제품

AI 권장 제품은 고객 비즈니스 문제 설명 및 기회 세부 정보를 기반으로 식별됩니다. AI는 기술 요구 사항 및 사용 사례에 맞는 관련AWS제품을 권장합니다. 파트너는 이러한 제안을 검토하고 고객의 특정 요구 사항에 맞게 제품 선택을 사용자 지정해야 합니다.

요금 계산기 URLs을 사용한 향상된 인사이트

또한 파트너는AWS요금 계산기 URLs 가져와 서비스 선택을 자동으로 채우고 마이그레이션 가속화 프로그램(MAP) 자격 지표, 최적화 권장 사항 및 잠재적 비용 절감 분석을 포함한 향상된 인사이트를 받을 수 있습니다.

소스로 구분된 데이터 이해

거래 크기 조정은 기회 가치에 대한 포괄적인 가시성을 제공하기 위해 두 개의 개별 소스에서 인사이트를 제공합니다.

소스 간 차이 처리

파트너가 제공한 추정치가AWS권장 사항과 크게 다른 경우 파트너는 다음을 수행해야 합니다.

Deal Sizing Insights에 액세스

파트너는 GetAwsOpportunitySummary API 작업을 통해 거래 크기 조정 데이터에 액세스합니다.이 작업은 거래 크기 조정 예측, 제품 권장 사항 및 최적화 인사이트가 포함된 확장 AwsOpportunitySummary 객체를 반환합니다.

거래 크기 조정 데이터를 사용할 수 있게 되는 경우

충분한 고객 및 프로젝트 세부 정보로 기회가 생성된 후 거래 규모 조정 인사이트를 사용할 수 있습니다. 시스템은 기회 속성을 분석하고 다음을 생성합니다.

거래 크기 조정 입력 제공

파트너는 CreateOpportunity 및 UpdateOpportunity API 작업을 통해 거래 규모 조정에 대한 입력을 제공합니다. 시스템은 기회 속성을 사용하여 추천을 생성합니다.

총 계약 금액(TCV) 제공

월별 반복 수익이 아닌 총 계약 가치로 추정하는 파트너는 거래 가치를 직접 제공할 수 있습니다. AWS는 AI 기반 변환 모델을 사용하여 TCV를 AWS MRR로 자동 변환합니다.

TCV에서 거래 규모 조정의 경우 ExpectedContractDuration를 Months (유효 값 범위는 1~144개월)TargetCompany로,를 Self 및 Frequency로 제공합니다None.

{
  "Project": {
    "ExpectedContractDuration": { "Term": "Months", "Value": "36" },
    "ExpectedCustomerSpend": [
      {
        "Amount": "1200000.00",
        "CurrencyCode": "USD",
        "Frequency": "None",
        "TargetCompany": "Self"
      }
    ]
  }
}

AWS는 AWS MRR 추정치를 도출하고에서 두 항목을 모두 반환합니다GetOpportunity.

{
  "Project": {
    "ExpectedContractDuration": { "Term": "Months", "Value": "36" },
    "ExpectedCustomerSpend": [
      {
        "Amount": "5600.00",
        "CurrencyCode": "USD",
        "Frequency": "Monthly",
        "TargetCompany": "AWS"
      },
      {
        "Amount": "1200000.00",
        "CurrencyCode": "USD",
        "Frequency": "None",
        "TargetCompany": "Self"
      }
    ]
  }
}

위의 예에서 ExpectedCustomerSpend 첫 번째 배열에는 AWS MRR 추정치(TargetCompany: "AWS", Frequency: "Monthly")가 포함되어 있으며 두 번째 배열은 파트너의 총 계약 금액(TargetCompany: "Self", )입니다Frequency: "None".

TCV 검증 규칙

모든 TCV 검증 오류는 INVALID_VALUE와 함께 오류 코드를 반환합니다Reason: "BUSINESS_VALIDATION_FAILED". 구별 인자는 FieldName 및 입니다Message.

TCV와 수동 MRR 간 전환

TCV 모드에서 수동 MRR로 다시 전환하려면를 ExpectedContractDuration 로 명시적으로 설정하고 AWS 항목만 null 제공합니다.

{
  "Project": {
    "ExpectedContractDuration": null,
    "ExpectedCustomerSpend": [
      {
        "Amount": "8000.00",
        "CurrencyCode": "USD",
        "Frequency": "Monthly",
        "TargetCompany": "AWS"
      }
    ]
  }
}

TCV 및 요금 계산기 URLs

파트너가 Self 항목(TCV 모드)과를 모두 제공하는 경우 EstimationUrlAPI는 검증 오류를 반환합니다. 자체 항목과 EstimationUrl은 동일한 요청에 공존할 수 없습니다.

수동 MRR 견적 제공

파트너는 Project.ExpectedCustomerSpend[].Amount 필드를 사용하여 MRR 추정치를 수동으로 입력할 수 있습니다.

{
  "Project": {
    "ExpectedCustomerSpend": [
      {
        "Amount": "25000.00",
        "CurrencyCode": "USD",
        "Frequency": "Monthly",
        "TargetCompany": "AWS"
      }
    ]
  }
}

이 필드는 모든 파트너가 사용할 수 있으며 동일한 값을 설정하여 AI 예측을 수락하거나 파트너가 제공한 값으로 재정의하는 데 사용할 수 있습니다.

요금 계산기 URLs 제공

파트너는 선택적으로 Project.ExpectedCustomerSpend[].EstimationUrl 필드를 통해AWS요금 계산기 URLs을 제공하여 서비스 구성을 자동으로 가져오고 MAP 자격 지표, 최적화 권장 사항 및 비용 절감 분석을 포함한 향상된 인사이트를 받을 수 있습니다.

{
  "Project": {
    "ExpectedCustomerSpend": [
      {
        "Amount": null,
        "CurrencyCode": "USD",
        "EstimationUrl": "https://calculator.aws/#/estimate?id=abc123",
        "Frequency": "Monthly",
        "TargetCompany": "AWS"
      }
    ]
  }
}

유효한 요금 계산기 URL이 제공되면 시스템은 계산기 구성에서 MRR 금액을 자동으로 계산하고 금액 필드와의 파트너 소스에 자세한 제품 수준 지출 데이터를 모두 채웁니다AwsProductsSpendInsightsBySource. 파트너는 EstimationUrl을 제공할 때 Amount를 null로 설정해야 합니다. 시스템이 자동으로 계산합니다.

잘못된 형식URLs과 확인할 수 없는 URLs은 로 거부됩니다ValidationException.

Amount와 EstimationUrl이 함께 작동하는 방식

기회에 대한 월별 반복 수익(MRR) 추정치를 제공하는 방법에 유연성이 있습니다. API는 수동 금액과AWS요금 계산기 URLs의 다양한 조합을 지능적으로 처리하여 기회를 항상 성공적으로 생성할 수 있도록 합니다.

수동 양만 사용

Amount 필드만 입력하면 API가 수동 견적을 저장하고 EstimationUrl을 null로 설정합니다. 이 접근 방식은 고객 대화 또는 자체 계산에서 특정 MRR 추정치가 있을 때 유용합니다.

요청 예제:

{
    "Project": {
        "ExpectedCustomerSpend": [{
            "Amount": "25000.00",
            "CurrencyCode": "USD",
            "Frequency": "Monthly",
            "TargetCompany": "AWS"
        }]
    }
}

AWS요금 계산기 URL만 사용

EstimationUrl 필드만 제공하는 경우:

요청 예제:

{
    "Project": {
        "ExpectedCustomerSpend": [{
            "EstimationUrl": "https://calculator.aws/#/estimate?id=abc123",
            "CurrencyCode": "USD",
            "Frequency": "Monthly",
            "TargetCompany": "AWS"
        }]
    }
}

오류 응답의 예(잘못된 URL):

{
    "ErrorList": [{
        "Code": "INVALID_VALUE",
        "FieldName": "project.expectedCustomerSpend.estimationUrl",
        "Message": "Invalid Estimation URL: https://calculator.aws/#/estimate?id=invalid"
    }],
    "Message": "The provided Estimation URL is invalid",
    "Reason": "INVALID_VALUE"
}

Amount와 EstimationUrl 모두 제공

두 필드를 모두 제공하면 API는 기회가 성공적으로 생성되도록 우선 순위를 지정합니다.

주요 이점: 잘못된 URLs 기회 생성을 차단하지 않음

이 접근 방식을 사용하면 유효하지 않거나 액세스할 수 없는AWS요금 계산기 URLs 인해 기회를 생성하거나 업데이트할 수 없습니다. 수동으로 제공된 금액이 항상 충돌 또는 검증 문제가 있을 때 우선하므로 기회 데이터를 완전히 제어할 수 있습니다.

확장 AwsOpportunitySummary 데이터 모델 이해

이 섹션에서는 GetAwsOpportunitySummary API 작업에서 반환되는 응답 구조를 설명합니다.

GetAwsOpportunitySummary API 작업은 소스 어트리뷰션으로 포괄적인 지출 분석을 제공하는 새로운 Insights.AwsProductsSpendInsightsBySource 구조를 통해 거래 크기 조정 인사이트를 반환합니다.

소스 분리:AWS vss 파트너 데이터

거래 규모 조정은 소스별로 인사이트를 분리하여 투명성을 제공하고 이중 계산을 방지합니다.

이러한 분리를 통해 파트너는 다음을 수행할 수 있습니다.

구조 개요

{
  "Insights": {
    "AwsProductsSpendInsightsBySource": {
      "<AWS | Partner>": {
        "CurrencyCode": "string",
        "Frequency": "string",
        "TotalAmount": "string",
        "TotalOptimizedAmount": "string",
        "TotalPotentialSavingsAmount": "string",
        "TotalAmountByCategory": { },
        "AwsProducts": [ ]
      }
    }
  },
  "Project": {
    "ExpectedCustomerSpend": [ ]
  },
  "RelatedEntityIds": {
    "AwsProducts": [ ]
  }
}

필드 참조

AwsProductsSpendInsightsBySource 맵

소스로 구분된 지출 인사이트는AWS권장 사항 및 파트너 추정치에 대한 독립적인 분석을 제공합니다.

Insights.AwsProductsSpendInsightsBySource 필드는 최대 2개의 키를 포함하는 맵입니다.

AwsProductInsights 객체

총 금액, 최적화 절감, 프로그램 범주 분석, 자세한 제품 수준 인사이트를 포함하여 단일 소스(AWS또는 파트너)에 대한 포괄적인 지출 분석.

각 소스 객체에는 다음 필드가 포함됩니다.

현재 상태 제한:AWS소스의 경우 제품별 지출 권장 사항을 사용할 수 없는 경우 TotalAmount, TotalOptimizedAmount 및 TotalPotentialSavingsAmount를 생략할 수 있습니다. 파트너는 이러한 경우 총AWS MRR 추정치Project.ExpectedCustomerSpend[].Amount를 참조해야 합니다.

TotalAmountByCategory 객체

지출 금액을AWS프로그램 및 전략적 이니셔티브에 매핑합니다.

AwsProducts 배열

프로그램 자격 지표(MAP, 현대화 경로), 비용 견적 및 최적화 권장 사항이 포함된AWS서비스 목록입니다.

각 제품 객체에는 다음이 포함됩니다.

Null 처리: 제품별 지출 권장 사항을 사용할 수 없는 경우AWS소스 제품, 금액, OptimizedAmount 및 PotentialSavingsAmount 필드가 null일 수 있습니다. 시스템은 Project.ExpectedCustomerSpend[0].Amount 대신를 통해 총 MRR을 제공합니다.

최적화 객체

각 최적화 권장 사항에는 다음이 포함됩니다.

예제

예제 1:AWS권장 사항 전용(현재 상태)

이 예제는 AI 권장 사항만 사용할 수 있고 제품별 지출 금액을 아직 권장할 수 없는 경우의 일반적인 응답을 보여줍니다.

{
  "Catalog": "AWS",
  "Insights": {
    "AwsProductsSpendInsightsBySource": {
      "AWS": {
        "CurrencyCode": "USD",
        "Frequency": "Monthly",
        "AwsProducts": [
          {
            "ProductCode": "AmazonEC2",
            "Categories": ["MAP Eligible", "Cost Allocation Tagging"],
            "Amount": null,
            "OptimizedAmount": null,
            "PotentialSavingsAmount": null,
            "Optimizations": []
          },
          {
            "ProductCode": "AWSLambda",
            "Categories": ["Cost Allocation Tagging", "Pathway - Move to Cloud Native"],
            "Amount": null,
            "OptimizedAmount": null,
            "PotentialSavingsAmount": null,
            "Optimizations": []
          },
          {
            "ProductCode": "AmazonRDS",
            "Categories": ["MAP Eligible", "Cost Allocation Tagging", "Pathway - Move to Managed Services"],
            "Amount": null,
            "OptimizedAmount": null,
            "PotentialSavingsAmount": null,
            "Optimizations": []
          }
        ]
      }
    }
  },
  "Project": {
    "ExpectedCustomerSpend": [
      {
        "Amount": "28000.00",
        "CurrencyCode": "USD",
        "EstimationUrl": null,
        "Frequency": "Monthly",
        "TargetCompany": "AWS"
      }
    ]
  },
  "RelatedEntityIds": {
    "AwsProducts": [
      "AmazonEC2",
      "AWSLambda",
      "AmazonRDS"
    ]
  }
}

요점:AWS소스는 범주가 있지만 제품당 금액이 없는 권장 제품을 보여줍니다. 를 통해 사용 가능한 총 MRR 추정치입니다Project.ExpectedCustomerSpend[].Amount.

예제 2: 파트너 요금 계산기 가져오기

이 예제는 파트너가 유효한 요금 계산기 URL을 제공한 경우 향상된 인사이트를 보여줍니다.

{
  "Catalog": "AWS",
  "Insights": {
    "AwsProductsSpendInsightsBySource": {
      "Partner": {
        "CurrencyCode": "USD",
        "Frequency": "Monthly",
        "TotalAmount": "32500.00",
        "TotalOptimizedAmount": "30000.00",
        "TotalPotentialSavingsAmount": "2500.00",
        "TotalAmountByCategory": {
          "MAP Eligible": "22500.00",
          "Cost Allocation Tagging": "32500.00",
          "Pathway - Move to Cloud Native": "5000.00",
          "Pathway - Move to Managed Services": "7500.00"
        },
        "AwsProducts": [
          {
            "ServiceCode": "ec2",
            "Categories": ["MAP Eligible", "Cost Allocation Tagging"],
            "Amount": "15000.00",
            "OptimizedAmount": "13500.00",
            "PotentialSavingsAmount": "1500.00",
            "Optimizations": [
              {
                "Description": "Convert to 3-year reserved instances",
                "SavingsAmount": "1000.00"
              },
              {
                "Description": "Migrate to Graviton-based instances",
                "SavingsAmount": "500.00"
              }
            ]
          },
          {
            "ServiceCode": "lambda",
            "Categories": ["Cost Allocation Tagging", "Pathway - Move to Cloud Native"],
            "Amount": "5000.00",
            "OptimizedAmount": "5000.00",
            "PotentialSavingsAmount": "0.00",
            "Optimizations": []
          },
          {
            "ServiceCode": "AmazonRDS",
            "Categories": ["MAP Eligible", "Cost Allocation Tagging", "Pathway - Move to Managed Services"],
            "Amount": "7500.00",
            "OptimizedAmount": "6500.00",
            "PotentialSavingsAmount": "1000.00",
            "Optimizations": [
              {
                "Description": "Optimize Multi-AZ for dev/test environments",
                "SavingsAmount": "1000.00"
              }
            ]
          },
          {
            "ServiceCode": "AmazonS3",
            "Categories": ["MAP Eligible", "Cost Allocation Tagging"],
            "Amount": "5000.00",
            "OptimizedAmount": "5000.00",
            "PotentialSavingsAmount": "0.00",
            "Optimizations": []
          }
        ]
      }
    }
  },
  "Project": {
    "ExpectedCustomerSpend": [
      {
        "Amount": "32500.00",
        "CurrencyCode": "USD",
        "EstimationUrl": "https://calculator.aws/#/estimate?id=abc123",
        "Frequency": "Monthly",
        "TargetCompany": "AWS"
      }
    ]
  },
  "RelatedEntityIds": {
    "AwsProducts": []
  }
}

요점: 파트너 소스에는 제품별 금액이 포함된 전체 지출 세부 정보가 포함되어 있습니다. 최적화 권장 사항은 실행 가능한 비용 절감 전략을 제공합니다. 범주 분석에는 MAP 자격(총 32,500 USD 중 22,500 USD)이 표시됩니다. 제품에는 요금 계산기 구성에 대한 ServiceCode 연결이 포함됩니다.

예제 3: 두 소스 모두 존재(비교 시나리오)

이 예제에서는AWS권장 사항과 파트너 추정치가 모두 함께 표시되어 비교가 가능한 방법을 보여줍니다.

{
  "Catalog": "AWS",
  "Insights": {
    "AwsProductsSpendInsightsBySource": {
      "AWS": {
        "CurrencyCode": "USD",
        "Frequency": "Monthly",
        "AwsProducts": [
          {
            "ProductCode": "AmazonEC2",
            "Categories": ["MAP Eligible", "Cost Allocation Tagging"],
            "Amount": null,
            "OptimizedAmount": null,
            "PotentialSavingsAmount": null,
            "Optimizations": []
          },
          {
            "ProductCode": "AWSLambda",
            "Categories": ["Cost Allocation Tagging", "Pathway - Move to Cloud Native"],
            "Amount": null,
            "OptimizedAmount": null,
            "PotentialSavingsAmount": null,
            "Optimizations": []
          },
          {
            "ProductCode": "EBS",
            "Categories": ["MAP Eligible", "Cost Allocation Tagging"],
            "Amount": null,
            "OptimizedAmount": null,
            "PotentialSavingsAmount": null,
            "Optimizations": []
          },
          {
            "ProductCode": "RDS",
            "Categories": ["MAP Eligible", "Cost Allocation Tagging", "Pathway - Move to Managed Services"],
            "Amount": null,
            "OptimizedAmount": null,
            "PotentialSavingsAmount": null,
            "Optimizations": []
          }
        ]
      },
      "Partner": {
        "CurrencyCode": "USD",
        "Frequency": "Monthly",
        "TotalAmount": "32500.00",
        "TotalOptimizedAmount": "30000.00",
        "TotalPotentialSavingsAmount": "2500.00",
        "TotalAmountByCategory": {
          "MAP Eligible": "22500.00",
          "Cost Allocation Tagging": "32500.00",
          "Pathway - Move to Cloud Native": "5000.00",
          "Pathway - Move to Managed Services": "7500.00"
        },
        "AwsProducts": [
          {
            "ServiceCode": "ec2",
            "Categories": ["MAP Eligible", "Cost Allocation Tagging"],
            "Amount": "15000.00",
            "OptimizedAmount": "13500.00",
            "PotentialSavingsAmount": "1500.00",
            "Optimizations": [
              {
                "Description": "Convert to 3-year reserved instances",
                "SavingsAmount": "1000.00"
              }
            ]
          },
          {
            "ServiceCode": "lambda",
            "Categories": ["Cost Allocation Tagging", "Pathway - Move to Cloud Native"],
            "Amount": "5000.00",
            "OptimizedAmount": "5000.00",
            "PotentialSavingsAmount": "0.00",
            "Optimizations": []
          },
          {
            "ServiceCode": "amazonRDS",
            "Categories": ["MAP Eligible", "Cost Allocation Tagging", "Pathway - Move to Managed Services"],
            "Amount": "7500.00",
            "OptimizedAmount": "6500.00",
            "PotentialSavingsAmount": "1000.00",
            "Optimizations": [
              {
                "Description": "Optimize Multi-AZ for dev/test environments",
                "SavingsAmount": "1000.00"
              }
            ]
          },
          {
            "ServiceCode": "amazonS3",
            "Categories": ["MAP Eligible", "Cost Allocation Tagging"],
            "Amount": "5000.00",
            "OptimizedAmount": "5000.00",
            "PotentialSavingsAmount": "0.00",
            "Optimizations": []
          }
        ]
      }
    }
  },
  "Project": {
    "ExpectedCustomerSpend": [
      {
        "Amount": "28000.00",
        "CurrencyCode": "USD",
        "EstimationUrl": "https://calculator.aws/#/estimate?id=abc123",
        "Frequency": "Monthly",
        "TargetCompany": "AWS"
      }
    ]
  },
  "RelatedEntityIds": {
    "AwsProducts": [
      "AmazonEC2",
      "AWSLambda",
      "EBS",
      "RDS"
    ]
  }
}

요점: 두 소스 모두 있음:AWS권장 사항(총 28,000 USD) 및 파트너 계산기(총 32.5,000 USD).AWS권장 사항에는 4개의 제품이 표시되고 파트너 계산기에는 4개의 제품이 표시됩니다(중첩 3개). 파트너는를 통해 사용 가능한 세부 추정치AWS합계와AWS권장 사항을 비교할 수 있습니다Project.ExpectedCustomerSpend[].Amount.

모범 사례

Null 값 처리

최적화 권장 사항

업데이트 모니터링

API 통합 패턴

데이터 품질 및 정확성