A referência AWS Partner Central da API foi reestruturada. Para obter mais informações sobre as operações de API suportadas, consulte a Referência AWS Partner Central da API.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Trabalho com insights de dimensionamento de negócios

O que é Deal Sizing?

O dimensionamento de negócios é um recurso das oportunidades de engajamento do cliente (ACE) da APN na Central de AWS parceiros que usa IA para fornecer estimativas automatizadas do tamanho do negócio e recomendações de AWS serviços quando os parceiros criam ou atualizam oportunidades.

Estimativas de MRR previstas pela IA

Os insights de dimensionamento de negócios fornecem a mediana das faixas de receita recorrente mensal (MRR) previstas com base nas AWS oportunidades históricas, nos casos de uso e nas descrições comerciais dos parceiros. Os parceiros devem revisar e atualizar o MRR total à medida que os parceiros coletam mais informações sobre o negócio e o progresso no ciclo de vendas.

AI-Recommended AWS Produtos

AI-recommended os produtos são identificados com base nas descrições dos problemas comerciais do cliente e nos detalhes da oportunidade. A IA recomenda AWS produtos relevantes alinhados aos requisitos técnicos e aos casos de uso. Os parceiros devem analisar essas sugestões e personalizar a seleção de produtos para atender às necessidades específicas do cliente.

Insights aprimorados com URLs da calculadora de preços

Os parceiros também podem importar URLs da Calculadora de AWS Preços para preencher automaticamente as seleções de serviços e receber informações aprimoradas, incluindo indicadores de elegibilidade do Migration Acceleration Program (MAP), recomendações de otimização e análise de possíveis economias de custos.

Entendendo Source-Separated os dados

O Deal Sizing fornece informações de duas fontes distintas para oferecer uma visibilidade abrangente do valor da oportunidade:

Lidando com a variação entre fontes

Quando as estimativas fornecidas pelo parceiro diferem significativamente das AWS recomendações, os parceiros devem:

Acessando insights de dimensionamento de negócios

Os parceiros acessam os dados de dimensionamento de negócios por meio da ação de GetAwsOpportunitySummary API, que retorna um AwsOpportunitySummary objeto estendido contendo previsões de dimensionamento de negócios, recomendações de produtos e insights de otimização.

Quando os dados de dimensionamento de negócios se tornam disponíveis

Os insights de dimensionamento de negócios ficam disponíveis após a criação de uma oportunidade com detalhes suficientes do cliente e do projeto. O sistema analisa os atributos da oportunidade e gera:

Fornecendo insumos de dimensionamento de negócios

Os parceiros fornecem informações para o dimensionamento de negócios por meio de ações CreateOpportunity de UpdateOpportunity API. O sistema usa atributos de oportunidade para gerar recomendações.

Fornecimento do valor total do contrato (TCV)

Os parceiros que estimam o valor total do contrato em vez da receita mensal recorrente podem fornecer o valor do negócio diretamente. A AWS converte automaticamente o TCV em AWS MRR usando AI-powered modelos de conversão.

Para o dimensionamento de negócios no TCV, forneça ExpectedContractDuration como Months (os valores válidos variam de 1 a 144 meses) e TargetCompany como Self e Frequency como. None

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

A AWS deriva a estimativa do AWS MRR e retorna as duas entradas em: 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"
      }
    ]
  }
}

No exemplo acima, a ExpectedCustomerSpend primeira matriz contém a estimativa do AWS MRR (TargetCompany: "AWS",Frequency: "Monthly") e a segunda matriz é o valor total do contrato do parceiro (TargetCompany: "Self",Frequency: "None").

Regras de validação do TCV

Todos os erros de validação do TCV retornam o código de erro INVALID_VALUE comReason: "BUSINESS_VALIDATION_FAILED". O fator distintivo é o FieldName eMessage:

Alternando entre TCV e MRR manual

Para voltar do modo TCV para o MRR manual, ExpectedContractDuration defina explicitamente null e forneça somente uma entrada: AWS

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

URLs da calculadora de preços e TCV

Se um parceiro fornecer uma Self entrada (modo TCV) e umaEstimationUrl, a API retornará um erro de validação. Entrada automática e EstimationUrl não pode coexistir na mesma solicitação.

Fornecendo estimativas manuais de MRR

Os parceiros podem inserir manualmente as estimativas de MRR usando o Project.ExpectedCustomerSpend[].Amount campo:

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

Esse campo está disponível para todos os parceiros e pode ser usado para aceitar previsões de IA definindo o mesmo valor ou Partner-provided substituindo por valores.

Fornecendo URLs da calculadora de preços

Opcionalmente, os parceiros podem fornecer URLs da Calculadora de AWS Preços por meio do Project.ExpectedCustomerSpend[].EstimationUrl campo para importar automaticamente as configurações do serviço e receber informações aprimoradas, incluindo indicadores de elegibilidade do MAP, recomendações de otimização e análise de economia de custos.

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

Quando um URL válido da Calculadora de Preços é fornecido, o sistema calcula automaticamente o valor do MRR a partir da configuração da calculadora e preenche o campo Valor e os dados detalhados de gastos em nível de produto na fonte do Parceiro de. AwsProductsSpendInsightsBySource Os parceiros devem definir o valor como nulo ao fornecer um EstimationUrl - o sistema o calculará automaticamente.

URLs em formatos inválidos e URLs que não puderem ser resolvidos serão rejeitados com um. ValidationException

Como quantidade e EstimationUrl trabalho em conjunto

Você tem flexibilidade na forma como fornece estimativas mensais de receita recorrente (MRR) para oportunidades. A API lida de forma inteligente com várias combinações de valores manuais e URLs da Calculadora de AWS Preços para garantir que suas oportunidades sempre possam ser criadas com sucesso.

Usando apenas uma quantidade manual

Quando você fornece somente o campo Valor, a API salva sua estimativa manual e define EstimationUrl como nula. Essa abordagem é útil quando você tem uma estimativa de MRR específica a partir de conversas com clientes ou de seus próprios cálculos.

Exemplo de solicitação:

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

Usando apenas um AWS URL da calculadora de preços

Quando você fornece somente o EstimationUrl campo:

Exemplo de solicitação:

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

Exemplo de resposta de erro (URL inválido):

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

Fornecendo tanto o valor quanto EstimationUrl

Quando você fornece os dois campos, a API prioriza a garantia de que sua oportunidade seja criada com sucesso:

Principal benefício: URLs inválidos nunca bloqueiam a criação de oportunidades

Essa abordagem garante que URLs inválidos ou inacessíveis da Calculadora de AWS Preços nunca impeçam você de criar ou atualizar oportunidades. Seu valor fornecido manualmente sempre tem precedência quando há um problema de conflito ou validação, dando a você controle total sobre os dados da oportunidade.

Entendendo o modelo AwsOpportunitySummary de dados estendido

Esta seção descreve a estrutura de resposta retornada pela ação GetAwsOpportunitySummary da API.

A ação da GetAwsOpportunitySummary API retorna insights de dimensionamento de negócios por meio da nova Insights.AwsProductsSpendInsightsBySource estrutura que fornece uma análise abrangente de gastos com atribuição de origem.

Separação de fontes:AWS versus dados de parceiros

O Deal Sizing separa os insights por fonte para fornecer transparência e evitar a dupla contagem:

Essa separação permite que os parceiros:

Visão geral da estrutura

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

Referência de campo

AwsProductsSpendInsightsBySource Mapa

Source-separated gaste insights que forneçam análises independentes para AWS recomendações e estimativas de parceiros.

O Insights.AwsProductsSpendInsightsBySource campo é um mapa contendo até duas chaves:

AwsProductInsights Objeto

Análise abrangente de gastos para uma única fonte (AWS ou parceiro), incluindo valores totais, economias de otimização, detalhamentos de categorias de programas e insights detalhados em nível de produto.

Cada objeto de origem contém os seguintes campos:

Limitação do estado atual: Para a AWS fonte, TotalAmount, TotalOptimizedAmount, e TotalPotentialSavingsAmount pode ser omitida quando as recomendações de gastos por produto não estão disponíveis. Os parceiros devem consultar Project.ExpectedCustomerSpend[].Amount a estimativa total de AWS MRR nesses casos.

TotalAmountByCategory Objeto

Os gastos do Maps são equivalentes a AWS programas e iniciativas estratégicas:

AwsProducts Matriz

Lista de AWS serviços com indicadores de elegibilidade do programa (MAP, caminhos de modernização), estimativas de custo e recomendações de otimização.

Cada objeto do produto contém:

Tratamento nulo: para produtos AWS de origem, o valor e os PotentialSavingsAmount campos podem ser nulos quando as recomendações de gastos por produto não estão disponíveis. OptimizedAmount Em Project.ExpectedCustomerSpend[0].Amount vez disso, o sistema fornece MRR total por meio de.

Objeto de otimização

Cada recomendação de otimização contém:

Exemplos

Exemplo 1:AWS Somente recomendações (estado atual)

Este exemplo mostra a resposta típica quando somente recomendações de IA estão disponíveis e os valores de gastos por produto ainda não podem ser recomendados.

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

Pontos-chave: a AWS fonte mostra produtos recomendados com categorias, mas sem quantidades por produto. Estimativa total de MRR disponível viaProject.ExpectedCustomerSpend[].Amount.

Exemplo 2: Importação da calculadora de preços de parceiros

Este exemplo mostra insights aprimorados quando um parceiro fornece um URL válido da Calculadora de Preços.

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

Pontos principais: a fonte do parceiro contém detalhes completos dos gastos com valores por produto. As recomendações de otimização fornecem estratégias práticas de redução de custos. Os detalhamentos das categorias mostram a elegibilidade para o MAP ($22.500 de um total de $32.500). Os produtos incluem ServiceCode links para a configuração da Calculadora de Preços.

Exemplo 3: Ambas as fontes presentes (cenário de comparação)

Este exemplo demonstra como as AWS recomendações e as estimativas dos parceiros aparecem juntas, permitindo a comparação.

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

Pontos-chave: Ambas as fontes apresentam:AWS recomendações (total de 28 mil dólares) e calculadora de parceiros (total de 32,5 mil dólares).AWS as recomendações mostram 4 produtos; a calculadora de parceiros mostra 4 produtos (3 sobrepostos). Os parceiros podem comparar AWS as recomendações com suas estimativas detalhadas.AWS total disponível viaProject.ExpectedCustomerSpend[].Amount.

Práticas recomendadas

Tratamento de valores nulos

Recomendações de otimização

Monitoramento de atualizações

Padrões de integração de API

Qualidade e precisão dos dados