Se reestructuró la referencia de la AWS Partner Central API. Para obtener más información sobre las operaciones de API compatibles, consulta la referencia de la AWS Partner Central API.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Uso de información sobre el tamaño del negocio

¿Qué es Deal Sizing?

El dimensionamiento de las ofertas es una función incluida en las oportunidades de participación de los clientes (ACE) de APN en AWS Partner Central que utiliza la inteligencia artificial para proporcionar estimaciones automatizadas del tamaño de las ofertas y recomendaciones de AWS servicio cuando los socios crean o actualizan oportunidades.

AI pronosticó estimaciones de MRR

La información sobre el tamaño de las operaciones proporciona la mediana de los rangos de ingresos recurrentes mensuales (MRR) previstos en función del historial de AWS oportunidades, los casos de uso y las descripciones comerciales de los socios. Los socios deben revisar y actualizar el MRR total a medida que recopilan más información sobre la operación y avanzan en el ciclo de ventas.

AI-Recommended AWS Productos

AI-recommended los productos se identifican en función de las descripciones de los problemas comerciales de los clientes y de los detalles de las oportunidades. La IA recomienda los AWS productos pertinentes que se ajusten a los requisitos técnicos y a los casos de uso. Los socios deben revisar estas sugerencias y personalizar la selección de productos para que se adapte a las necesidades específicas del cliente.

Información mejorada con las URL de las calculadoras de precios

Los socios también pueden importar las URL de las calculadoras de AWS precios para completar automáticamente las selecciones de servicios y recibir información mejorada, incluidos los indicadores de elegibilidad del Migration Acceleration Program (MAP), las recomendaciones de optimización y los posibles análisis de ahorros de costos.

Comprensión de los datos Source-Separated

Deal Sizing proporciona información de dos fuentes distintas para ofrecerte una visibilidad completa del valor de la oportunidad:

Manejo de la varianza entre fuentes

Cuando las estimaciones proporcionadas por los socios difieran significativamente de AWS las recomendaciones, los socios deberían:

Acceder a Deal Sizing Insights

Los socios acceden a los datos sobre el tamaño de las ofertas a través de la acción de la GetAwsOpportunitySummary API, que devuelve un AwsOpportunitySummary objeto ampliado que contiene previsiones sobre el tamaño de las ofertas, recomendaciones de productos e información de optimización.

Cuando estén disponibles los datos sobre el tamaño de las ofertas

La información sobre el tamaño de las ofertas está disponible una vez que se ha creado una oportunidad con suficientes detalles sobre el cliente y el proyecto. El sistema analiza los atributos de la oportunidad y genera:

Proporcionamos información sobre el tamaño de las ofertas

Los socios proporcionan información sobre el tamaño de las ofertas a través de las acciones de la UpdateOpportunity API CreateOpportunity y de la API. El sistema utiliza los atributos de oportunidad para generar recomendaciones.

Proporciona el valor total del contrato (TCV)

Los socios que calculen el valor total del contrato en lugar de los ingresos recurrentes mensuales pueden proporcionar el valor de la operación directamente. AWS convierte automáticamente TCV en AWS MRR mediante modelos de AI-powered conversión.

Para calcular el tamaño de las ofertas en TCV, indique ExpectedContractDuration como Months (los valores válidos oscilan entre 1 y 144 meses) y como y TargetCompany como. Self Frequency None

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

AWS obtiene la estimación del MRR de AWS y devuelve ambas entradas el día: 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"
      }
    ]
  }
}

En el ejemplo anterior, la ExpectedCustomerSpend primera matriz contiene la estimación del MRR de AWS (TargetCompany: "AWS",Frequency: "Monthly") y la segunda matriz es el valor total del contrato del socio (TargetCompany: "Self",Frequency: "None").

Reglas de validación del TCV

Todos los errores de validación del TCV devuelven el código INVALID_VALUE de error con. Reason: "BUSINESS_VALIDATION_FAILED" El factor distintivo es el FieldName y: Message

Cambio entre TCV y MRR manual

Para volver del modo TCV al MRR manual, configúrelo explícitamente null y proporcione ExpectedContractDuration solo una entrada: AWS

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

URL del TCV y de la calculadora de precios

Si un socio proporciona una Self entrada (modo TCV) y unaEstimationUrl, la API devuelve un error de validación. Se introduce automáticamente y EstimationUrl no puede coexistir en la misma solicitud.

Proporcionando estimaciones manuales de MRR

Los socios pueden introducir manualmente las estimaciones de MRR mediante el Project.ExpectedCustomerSpend[].Amount campo:

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

Este campo está disponible para todos los socios y se puede usar para aceptar pronósticos de IA estableciendo el mismo valor o anulándolos con Partner-provided valores.

Proporcionar las direcciones URL de las calculadoras de precios

De forma opcional, los socios pueden proporcionar las URL de las calculadoras de AWS precios a través del Project.ExpectedCustomerSpend[].EstimationUrl campo para importar automáticamente las configuraciones de los servicios y recibir información mejorada, como los indicadores de aptitud para el MAP, las recomendaciones de optimización y los análisis de ahorro de costes.

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

Cuando se proporciona una URL válida de la calculadora de precios, el sistema calcula automáticamente el importe del MRR a partir de la configuración de la calculadora y rellena tanto el campo Importe como los datos detallados de gasto a nivel de producto en la fuente del partner de. AwsProductsSpendInsightsBySource Los socios deben establecer el importe como nulo al proporcionar un valor EstimationUrl ; el sistema lo calculará automáticamente.

Las direcciones URL con formatos no válidos y las que no se puedan resolver se rechazarán con un. ValidationException

¿Cómo funcionan la cantidad y EstimationUrl el funcionamiento en conjunto

Tiene flexibilidad a la hora de proporcionar estimaciones de los ingresos recurrentes mensuales (MRR) para las oportunidades. La API gestiona de forma inteligente varias combinaciones de importes manuales y URL de calculadoras de AWS precios para garantizar que tus oportunidades siempre se puedan crear correctamente.

Utiliza solo un importe manual

Si solo especificas el campo Importe, la API guarda la estimación manual y la establece EstimationUrl como nula. Este enfoque resulta útil cuando tienes una estimación específica del MRR a partir de conversaciones con los clientes o de tus propios cálculos.

Ejemplo de solicitud:

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

Utilizando solo un AWS URL de la calculadora de precios

Cuando solo proporcionas el EstimationUrl campo:

Ejemplo de solicitud:

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

Ejemplo de respuesta de error (URL no válida):

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

Indicar tanto el importe como EstimationUrl

Al proporcionar ambos campos, la API da prioridad a garantizar que la oportunidad se cree correctamente:

Ventaja clave: las URL no válidas nunca bloquean la creación de oportunidades

Este enfoque garantiza que las URL de las calculadoras de AWS precios no válidas o inaccesibles nunca le impidan crear o actualizar oportunidades. El importe que proporciones manualmente siempre tiene prioridad cuando hay un conflicto o un problema de validación, lo que te da el control total sobre los datos de tus oportunidades.

Comprenda el modelo de AwsOpportunitySummary datos ampliados

En esta sección se describe la estructura de respuesta devuelta por la acción GetAwsOpportunitySummary de la API.

La acción de la GetAwsOpportunitySummary API proporciona información sobre el tamaño de las operaciones a través de una nueva Insights.AwsProductsSpendInsightsBySource estructura que proporciona un análisis exhaustivo de los gastos con la atribución de la fuente.

Separación de fuentes:AWS frente a datos de socios

Deal Sizing separa la información por fuente para brindar transparencia y evitar la doble contabilización:

Esta separación permite a los socios:

Descripción general de la estructura

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

Referencia de campo

AwsProductsSpendInsightsBySource Mapa

Source-separated información sobre el gasto que proporciona un análisis independiente para elaborar AWS recomendaciones y estimaciones de los socios.

El Insights.AwsProductsSpendInsightsBySource campo es un mapa que contiene hasta dos claves:

AwsProductInsights Objeto

Análisis exhaustivo de los gastos para una sola fuente (AWS o socio), que incluye los importes totales, los ahorros de optimización, el desglose por categorías de los programas y la información detallada a nivel de producto.

Cada objeto fuente contiene los siguientes campos:

Limitación estatal actual: se refiere a la AWS fuente TotalAmount TotalOptimizedAmount, y se TotalPotentialSavingsAmount puede omitir cuando las recomendaciones de gasto por producto no estén disponibles. En estos casos, Project.ExpectedCustomerSpend[].Amount los socios deben consultar la estimación del AWS MRR total.

TotalAmountByCategory Objeto

Los mapas gastan cantidades en AWS programas e iniciativas estratégicas:

AwsProducts Matriz

Lista de AWS servicios con indicadores de aptitud para el programa (MAP, vías de modernización), estimaciones de costos y recomendaciones de optimización.

Cada objeto de producto contiene:

Gestión nula: en el caso AWS de los productos de origen, el importe y PotentialSavingsAmount los campos pueden ser nulos cuando las recomendaciones de gasto por producto no están disponibles. OptimizedAmount En su lugar, el sistema proporciona el MRR total a través de. Project.ExpectedCustomerSpend[0].Amount

Objeto de optimización

Cada recomendación de optimización contiene:

Ejemplos

Ejemplo 1:AWS Solo recomendaciones (estado actual)

Este ejemplo muestra la respuesta típica cuando solo hay recomendaciones de IA disponibles y aún no se pueden recomendar importes de gasto por producto.

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

Puntos clave: la AWS fuente muestra los productos recomendados con categorías, pero no con importes por producto. La estimación del MRR total está disponible a través de. Project.ExpectedCustomerSpend[].Amount

Ejemplo 2: Importación de una calculadora de precios para socios

Este ejemplo muestra información mejorada cuando un socio ha proporcionado una URL válida de la calculadora de precios.

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

Puntos clave: la fuente del socio contiene detalles completos de los gastos con importes por producto. Las recomendaciones de optimización proporcionan estrategias prácticas de reducción de costos. Los desgloses por categorías muestran los requisitos para el MAP (22 500$ de un total de 32 500$). Los productos incluyen un ServiceCode enlace a la configuración de la calculadora de precios.

Ejemplo 3: Ambas fuentes están presentes (escenario comparativo)

Este ejemplo demuestra cómo AWS las recomendaciones y las estimaciones de los socios aparecen juntas, lo que permite compararlas.

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

Puntos clave: Ambas fuentes incluyen AWS recomendaciones (28 000$ en total) y una calculadora de socios (32 500$ en total).AWS Las recomendaciones muestran 4 productos; la calculadora de socios muestra 4 productos (3 superpuestos). Los socios pueden comparar AWS las recomendaciones con sus estimaciones detalladas.AWS total disponible a través deProject.ExpectedCustomerSpend[].Amount.

Prácticas recomendadas

Manejo de valores nulos

Recomendaciones de optimización

Supervisión de las actualizaciones

Patrones de integración de API

Calidad y precisión de los datos