AWS パートナーセントラル API リファレンスが再構築されました。サポートされている API オペレーションの詳細については、 AWS パートナーセントラル API リファレンスを参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

取引規模に関するインサイトの使用

ディールサイジングとは

ディールサイジングは、AWS Partner Central の APN Customer Engagements (ACE) Opportunities 内の機能であり、AI を使用して、パートナーがオポチュニティを作成または更新するときに、自動化されたディールサイズの見積もりとAWSサービスのレコメンデーションを提供します。

AI 予測 MRR の見積もり

ディールサイジングインサイトは、パートナーの過去のAWS機会、ユースケース、ビジネスの説明に基づいて、予測月額経常収益 (MRR) 範囲の中央値を提供します。パートナーは、取引に関する詳細情報を収集し、販売サイクルの進行状況を把握するため、MRR の合計を確認して更新する必要があります。

AI 推奨AWS製品

AI 推奨製品は、顧客のビジネス上の問題の説明と機会の詳細に基づいて特定されます。AI は、技術要件とユースケースに沿った関連AWS製品を推奨します。パートナーはこれらの提案を確認し、顧客の特定のニーズに合わせて製品の選択をカスタマイズする必要があります。

料金計算ツール URLs を使用した拡張インサイト

パートナーは、AWS料金計算ツール URLs をインポートして、サービスの選択を自動的に入力し、移行促進プログラム (MAP) の適格性指標、最適化の推奨事項、潜在的なコスト削減分析などの強化されたインサイトを取得することもできます。

ソース区切りデータについて

ディールサイジングは、2 つの異なるソースからのインサイトを提供し、オポチュニティ価値を包括的に可視化します。

ソース間の差異の処理

パートナーが提供する見積りがAWSレコメンデーションと大きく異なる場合、パートナーは以下を行う必要があります。

ディールサイジングインサイトへのアクセス

パートナーは GetAwsOpportunitySummary API アクションを通じてディールサイジングデータにアクセスします。これにより、ディールサイジング予測、製品レコメンデーション、最適化インサイトを含む拡張AwsOpportunitySummaryオブジェクトが返されます。

ディールサイジングデータがいつ利用可能になるか

ディールサイジングインサイトは、十分な顧客およびプロジェクトの詳細でオポチュニティが作成されると利用可能になります。システムは機会属性を分析し、以下を生成します。

ディールサイジング入力の提供

パートナーは、 CreateOpportunityおよび UpdateOpportunity API アクションを通じて、ディールサイジングの入力を提供します。システムはオポチュニティ属性を使用してレコメンデーションを生成します。

契約総額 (TCV) の提供

毎月の経常収益ではなく合計契約価値を見積もるパートナーは、取引価値を直接提供できます。AWS は、AI を活用した変換モデルを使用して TCV を AWS MRR に自動的に変換します。

TCV でのディールのサイズ設定では、 ExpectedContractDuration を Months (有効な値の範囲は 1～144 か月) Frequencyとして、 を TargetCompanyとして指定Selfします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") が含まれ、2 番目の配列はパートナーの合計契約値 (TargetCompany: "Self"、) ですFrequency: "None"。

TCV 検証ルール

すべての TCV 検証エラーは、 INVALID_VALUEでエラーコードを返しますReason: "BUSINESS_VALIDATION_FAILED"。識別係数は FieldNameと ですMessage。

TCV と手動 MRR の切り替え

TCV モードから手動 MRR に戻すには、 ExpectedContractDuration を明示的に に設定nullし、 AWS エントリのみを指定します。

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

TCV と料金計算ツールURLs

パートナーがSelfエントリ (TCV モード) と の両方を提供する場合EstimationUrl、API は検証エラーを返します。自己入力と 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オポチュニティの作成をブロックしない

このアプローチにより、無効な料金計算ツール URL またはアクセスできないAWS料金計算ツール URLs、オポチュニティの作成または更新が妨げられることはありません。手動で提供された金額は、競合や検証の問題が発生した場合に常に優先され、オポチュニティデータを完全に制御できます。

拡張 AwsOpportunitySummary データモデルについて

このセクションでは、 GetAwsOpportunitySummary API アクションによって返されるレスポンス構造について説明します。

GetAwsOpportunitySummary API アクションは、ソース属性による包括的な支出分析を提供する新しいInsights.AwsProductsSpendInsightsBySource構造を通じて、ディールサイジングのインサイトを返します。

ソース分離:AWSパートナーデータ

ディールサイジングは、透明性を提供し、二重カウントを防ぐために、インサイトをソースごとに分離します。

この分離により、パートナーは次のことが可能になります。

構造の概要

{
  "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 Handling: For AWS-sourced products、Amount、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"
    ]
  }
}

Key Points:AWS source には、カテゴリはあるが製品あたりの金額がない推奨製品が表示されます。経由で利用可能な合計 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"
    ]
  }
}

キーポイント: 両方のソース present:AWS recommendations (合計 28,000 USD) と Partner Calculator (合計 32.5,000 USD)。AWS recommendations には 4 つの製品が表示され、 Partner Calculator には 4 つの製品 (3 つの重複) が表示されます。パートナーは、レAWSコメンデーションと詳細なestimates.AWS total を比較できますProject.ExpectedCustomerSpend[].Amount。

ベストプラクティス

Null 値の処理

最適化に関する推奨事項

更新のモニタリング

API 統合パターン

データの品質と精度