Referensi AWS Partner Central API direstrukturisasi. Untuk informasi selengkapnya tentang operasi API yang didukung, lihat Referensi AWS Partner Central API.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Bekerja dengan wawasan penyesuaian ukuran kesepakatan

Apa itu Ukuran Kesepakatan?

Deal Sizing adalah kemampuan dalam Peluang Keterlibatan Pelanggan APN (ACE) di AWS Partner Central yang menggunakan AI untuk memberikan perkiraan ukuran transaksi otomatis dan rekomendasi AWS layanan saat Mitra membuat atau memperbarui peluang.

AI memperkirakan perkiraan MRR

Wawasan ukuran kesepakatan memberikan median rentang pendapatan berulang bulanan (MRR) yang diperkirakan berdasarkan AWS peluang historis Mitra, kasus penggunaan, dan deskripsi bisnis. Mitra harus meninjau dan memperbarui total MRR karena Mitra mengumpulkan lebih banyak informasi tentang kesepakatan dan kemajuan melalui siklus penjualan.

AI-Recommended AWS Produk

AI-recommended produk diidentifikasi berdasarkan deskripsi masalah bisnis pelanggan dan rincian peluang. AI merekomendasikan AWS produk yang relevan selaras dengan persyaratan teknis dan kasus penggunaan. Mitra harus meninjau saran ini dan menyesuaikan pemilihan produk agar sesuai dengan kebutuhan spesifik pelanggan.

Wawasan yang Ditingkatkan dengan URL Kalkulator Harga

Mitra juga dapat mengimpor URL Kalkulator AWS Harga untuk secara otomatis mengisi pilihan layanan dan menerima wawasan yang disempurnakan termasuk indikator kelayakan Migration Acceleration Program (MAP), rekomendasi pengoptimalan, dan analisis penghematan biaya potensial.

Memahami Source-Separated Data

Deal Sizing memberikan wawasan dari dua sumber terpisah untuk memberi Anda visibilitas komprehensif ke dalam nilai peluang:

Menangani Varians Antar Sumber

Ketika perkiraan yang diberikan mitra berbeda secara signifikan dari AWS rekomendasi, Mitra harus:

Mengakses Wawasan Ukuran Kesepakatan

Partner mengakses data Deal Sizing melalui tindakan GetAwsOpportunitySummary API, yang mengembalikan AwsOpportunitySummary objek yang diperluas yang berisi perkiraan ukuran kesepakatan, rekomendasi produk, dan wawasan pengoptimalan.

Ketika Data Ukuran Kesepakatan Menjadi Tersedia

Wawasan Ukuran Kesepakatan menjadi tersedia setelah peluang dibuat dengan detail pelanggan dan proyek yang memadai. Sistem menganalisis atribut peluang dan menghasilkan:

Memberikan Masukan Ukuran Kesepakatan

Mitra menyediakan masukan untuk Ukuran Kesepakatan melalui tindakan UpdateOpportunity API CreateOpportunity dan API. Sistem menggunakan atribut peluang untuk menghasilkan rekomendasi.

Memberikan Total Nilai Kontrak (TCV)

Mitra yang memperkirakan Total Nilai Kontrak daripada Pendapatan Berulang Bulanan dapat memberikan nilai transaksi mereka secara langsung. AWS secara otomatis mengonversi TCV ke AWS MRR menggunakan AI-powered model konversi.

Untuk ukuran kesepakatan di TCV, berikan ExpectedContractDuration as Months (nilai yang valid berkisar dari 1 hingga 144 bulan) dan TargetCompany sebagai dan sebagaiSelf. Frequency None

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

AWS memperoleh estimasi AWS MRR dan mengembalikan kedua entri pada: 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"
      }
    ]
  }
}

Dalam contoh di atas, array ExpectedCustomerSpend pertama berisi estimasi AWS MRR (TargetCompany: "AWS",Frequency: "Monthly") dan array kedua adalah Total Contract Value (TargetCompany: "Self",Frequency: "None") mitra.

Aturan Validasi TCV

Semua kesalahan validasi TCV mengembalikan kode INVALID_VALUE kesalahan dengan. Reason: "BUSINESS_VALIDATION_FAILED" Faktor yang membedakan adalah FieldName danMessage:

Beralih Antara TCV dan MRR Manual

Untuk beralih dari mode TCV kembali ke MRR manual, setel secara eksplisit ExpectedContractDuration ke null dan berikan hanya entri: AWS

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

TCV dan URL Kalkulator Harga

Jika mitra menyediakan Self entri (mode TCV) danEstimationUrl, API mengembalikan kesalahan validasi. Masuk sendiri dan EstimationUrl tidak dapat hidup berdampingan dalam permintaan yang sama.

Memberikan Estimasi MRR Manual

Mitra dapat memasukkan perkiraan MRR secara manual menggunakan Project.ExpectedCustomerSpend[].Amount bidang:

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

Bidang ini tersedia untuk semua Mitra dan dapat digunakan untuk menerima perkiraan AI dengan menetapkan nilai yang sama atau untuk mengganti dengan Partner-provided nilai.

Menyediakan URL Kalkulator Harga

Mitra secara opsional dapat menyediakan URL Kalkulator AWS Harga melalui Project.ExpectedCustomerSpend[].EstimationUrl bidang untuk secara otomatis mengimpor konfigurasi layanan dan menerima wawasan yang disempurnakan termasuk indikator kelayakan MAP, rekomendasi pengoptimalan, dan analisis penghematan biaya.

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

Ketika URL Kalkulator Harga yang valid disediakan, sistem secara otomatis menghitung jumlah MRR dari konfigurasi kalkulator dan mengisi bidang Jumlah dan data pengeluaran tingkat produk terperinci di sumber Mitra. AwsProductsSpendInsightsBySource Mitra harus menetapkan Jumlah ke null saat memasok EstimationUrl - sistem akan menghitungnya secara otomatis.

URL dalam format dan URL yang tidak valid yang tidak dapat diselesaikan akan ditolak dengan file. ValidationException

Berapa Jumlah dan EstimationUrl Bekerja Bersama

Anda memiliki fleksibilitas dalam cara Anda memberikan estimasi pendapatan berulang bulanan (MRR) untuk peluang. API secara cerdas menangani berbagai kombinasi jumlah manual dan URL Kalkulator AWS Harga untuk memastikan bahwa peluang Anda selalu dapat dibuat dengan sukses.

Hanya menggunakan jumlah manual

Jika Anda hanya menyediakan bidang Jumlah, API akan menyimpan estimasi manual Anda dan disetel EstimationUrl ke null. Pendekatan ini berguna ketika Anda memiliki perkiraan MRR tertentu dari percakapan pelanggan atau perhitungan Anda sendiri.

Contoh permintaan:

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

Hanya menggunakan sebuah AWS URL Kalkulator Harga

Bila Anda hanya menyediakan EstimationUrl bidang:

Contoh permintaan:

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

Contoh respons kesalahan (URL tidak valid):

{
    "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"
}

Memberikan Jumlah dan EstimationUrl

Saat Anda menyediakan kedua bidang, API memprioritaskan memastikan bahwa peluang Anda berhasil dibuat:

Manfaat utama: URL yang tidak valid tidak pernah memblokir pembuatan peluang

Pendekatan ini memastikan bahwa URL Kalkulator AWS Harga yang tidak valid atau tidak dapat diakses tidak pernah mencegah Anda membuat atau memperbarui peluang. Jumlah yang Anda berikan secara manual selalu diutamakan ketika ada masalah konflik atau validasi, memberi Anda kendali penuh atas data peluang Anda.

Memahami Model AwsOpportunitySummary Data yang Diperluas

Bagian ini menjelaskan struktur respons yang dikembalikan oleh aksi GetAwsOpportunitySummary API.

Tindakan GetAwsOpportunitySummary API mengembalikan wawasan ukuran kesepakatan melalui Insights.AwsProductsSpendInsightsBySource struktur baru yang menyediakan analisis pengeluaran komprehensif dengan atribusi sumber.

Pemisahan Sumber:AWS vs Data Mitra

Ukuran Kesepakatan memisahkan wawasan berdasarkan sumber untuk memberikan transparansi dan mencegah penghitungan ganda:

Pemisahan ini memungkinkan Mitra untuk:

Ikhtisar Struktur

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

Referensi Lapangan

AwsProductsSpendInsightsBySource Peta

Source-separated menghabiskan wawasan yang memberikan analisis independen untuk AWS rekomendasi dan perkiraan mitra.

Insights.AwsProductsSpendInsightsBySourceBidang adalah peta yang berisi hingga dua kunci:

AwsProductInsights Objek

Analisis pengeluaran komprehensif untuk satu sumber (AWS atau Mitra) termasuk jumlah total, penghematan pengoptimalan, perincian kategori program, dan wawasan tingkat produk terperinci.

Setiap objek sumber berisi bidang-bidang berikut:

Batasan Status Saat Ini: Untuk AWS sumber TotalAmount, TotalOptimizedAmount,, dan TotalPotentialSavingsAmount dapat dihilangkan ketika rekomendasi pengeluaran per produk tidak tersedia. Mitra harus referensi Project.ExpectedCustomerSpend[].Amount untuk perkiraan AWS MRR total dalam kasus ini.

TotalAmountByCategory Objek

Peta menghabiskan jumlah untuk AWS program dan inisiatif strategis:

AwsProducts Array

Daftar AWS layanan dengan indikator kelayakan program (MAP, jalur modernisasi), perkiraan biaya, dan rekomendasi pengoptimalan.

Setiap objek produk berisi:

Penanganan Null: Untuk produk yang AWS bersumber, Jumlah OptimizedAmount, dan PotentialSavingsAmount bidang mungkin nol jika rekomendasi pembelanjaan per produk tidak tersedia. Sistem menyediakan MRR total melalui Project.ExpectedCustomerSpend[0].Amount sebagai gantinya.

Objek Optimasi

Setiap rekomendasi pengoptimalan berisi:

Contoh

Contoh 1:AWS rekomendasi Saja (Keadaan Saat Ini)

Contoh ini menunjukkan respons khas ketika hanya rekomendasi AI yang tersedia dan jumlah pengeluaran per produk belum dapat direkomendasikan.

{
  "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"
    ]
  }
}

Poin Utama:AWS sumber menunjukkan produk yang direkomendasikan dengan kategori tetapi tidak ada jumlah per produk. Total estimasi MRR tersedia melaluiProject.ExpectedCustomerSpend[].Amount.

Contoh 2: Impor Kalkulator Harga Mitra

Contoh ini menunjukkan wawasan yang disempurnakan saat mitra telah menyediakan URL Kalkulator Harga yang valid.

{
  "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": []
  }
}

Poin Utama: Sumber mitra berisi detail pengeluaran lengkap dengan jumlah per produk. Rekomendasi optimasi memberikan strategi pengurangan biaya yang dapat ditindaklanjuti. Rincian kategori menunjukkan kelayakan MAP ($22.500 dari total $32,500). Produk termasuk ServiceCode menautkan kembali ke konfigurasi Kalkulator Harga.

Contoh 3: Kedua Sumber Hadir (Skenario Perbandingan)

Contoh ini menunjukkan bagaimana AWS rekomendasi dan perkiraan mitra muncul bersama, memungkinkan perbandingan.

{
  "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"
    ]
  }
}

Poin Utama: Kedua sumber hadir:AWS rekomendasi (total $28K) dan kalkulator Mitra (total $32.5K).AWS rekomendasi menunjukkan 4 produk; Kalkulator mitra menunjukkan 4 produk (3 tumpang tindih). Mitra dapat membandingkan AWS rekomendasi dengan perkiraan terperinci mereka.AWS total tersedia melaluiProject.ExpectedCustomerSpend[].Amount.

Praktik Terbaik

Menangani Nilai Null

Rekomendasi Optimasi

Pemantauan untuk Pembaruan

Pola Integrasi API

Kualitas dan Akurasi Data