View a markdown version of this page

Acceso a la API de ventas - AWS Centro de socios
Requisitos previosUtilización AWS políticas administradasPolíticas personalizadasAsignación de políticas a los roles y usuarios de IAMAdministrar los permisos mediante claves de condiciónResumen de los permisos necesarios

Se reestructuró la referencia de la Centro de socios de AWS API. Para obtener más información sobre las operaciones de API compatibles, consulta la referencia de la Centro de socios de AWS 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.

Acceso a la API de ventas

El control de acceso y los permisos los gestiona AWS Identity and Access Management(IAM). En esta sección se proporcionan instrucciones para configurar los permisos necesarios para interactuar con la API, incluidos los permisos necesarios para enumerar AWS Marketplace entidades.

Requisitos previos

Antes de configurar los permisos, asegúrese Cuenta de AWS de estar vinculado a Partner Central y de haber creado los roles y usuarios de IAM necesarios. Para obtener más información, consulte Configuración y autenticación.

Utilización AWS políticas administradas

AWS proporciona políticas administradas que otorgan los permisos necesarios para interactuar con la API. Para proporcionar el acceso necesario para gestionar las oportunidades, asocie la AWSPartnerCentralOpportunityManagement política a sus identidades de IAM. Para obtener más información, consulte las políticas AWS gestionadas para los usuarios de AWS Partner Central.

AWSPartnerCentralOpportunityManagement política

Esta política otorga acceso total a las acciones de gestión de oportunidades de Partner Central.

JSON
{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Sid": "OpportunityManagement",
            "Effect": "Allow",
            "Action": [
                "partnercentral:AcceptEngagementInvitation",
                "partnercentral:AssignOpportunity",
                "partnercentral:AssociateOpportunity",
                "partnercentral:CreateEngagement",
                "partnercentral:CreateEngagementInvitation",
                "partnercentral:CreateOpportunity",
                "partnercentral:CreateResourceSnapshot",
                "partnercentral:CreateResourceSnapshotJob",
                "partnercentral:DeleteResourceSnapshotJob",
                "partnercentral:DisassociateOpportunity",
                "partnercentral:GetAwsOpportunitySummary",
                "partnercentral:GetEngagement",
                "partnercentral:GetEngagementInvitation",
                "partnercentral:GetOpportunity",
                "partnercentral:GetResourceSnapshot",
                "partnercentral:GetResourceSnapshotJob",
                "partnercentral:ListEngagementByAcceptingInvitationTasks",
                "partnercentral:ListEngagementFromOpportunityTasks",
                "partnercentral:ListEngagementInvitations",
                "partnercentral:ListEngagementMembers",
                "partnercentral:ListEngagementResourceAssociations",
                "partnercentral:ListEngagements",
                "partnercentral:ListOpportunities",
                "partnercentral:ListResourceSnapshotJobs",
                "partnercentral:ListResourceSnapshots",
                "partnercentral:ListSolutions",
                "partnercentral:RejectEngagementInvitation",
                "partnercentral:StartEngagementByAcceptingInvitationTask",
                "partnercentral:StartEngagementFromOpportunityTask",
                "partnercentral:StartResourceSnapshotJob",
                "partnercentral:StopResourceSnapshotJob",
                "partnercentral:SubmitOpportunity",
                "partnercentral:UpdateOpportunity"
            ],
            "Resource": "*"
        },
        {
            "Sid": "ListingAWSMarketplaceEntities",
            "Effect": "Allow",
            "Action": ["aws-marketplace:ListEntities"],
            "Resource": "*"
        },
        {
            "Sid": "AWSMarketplaceOffersAccess",
            "Effect": "Allow",
            "Action": ["aws-marketplace:DescribeEntity"],
            "Resource": [
            		"arn:aws:aws-marketplace:*:*:AWSMarketplace/Offer/*",
            		"arn:aws:aws-marketplace:*:*:AWSMarketplace/OfferSet/*"
            ]
        }
    ]
}

Políticas personalizadas

Si las políticas gestionadas no se ajustan a tus necesidades, crea políticas de IAM personalizadas que concedan los permisos necesarios para tu caso de uso. El siguiente ejemplo es una política personalizada que concede permisos para enumerar AWS Marketplace entidades:

ejemplo Ejemplo de política personalizada
JSON
{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "partnercentral:ListOpportunities",
                "aws-marketplace:ListEntities"
            ],
            "Resource": "*"
        }
    ]
}

Política permisiva personalizada

Esta política proporciona un amplio acceso a las acciones de venta de Partner Central, incluidas las funciones que se puedan añadir en el futuro sin necesidad de actualizar la política. Al utilizar el carácter comodínpartnercentral:*, esta política otorga automáticamente acceso a las nuevas funciones de venta de Partner Central a medida que estén disponibles, lo que reduce la necesidad de actualizaciones manuales. Esta política también incluye permisos para interactuar con AWS Marketplace las entidades, lo que ayuda a garantizar que se mantenga el acceso tanto para las acciones de venta como para las de Marketplace.

JSON
{
    "Version":"2012-10-17",
    "Statement":
    [
        {
            "Effect": "Allow",
            "Action":
            [
                "partnercentral:*"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action":
            [
                "aws-marketplace:ListEntities",
                "aws-marketplace:DescribeEntity"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action":
            [
                "aws-marketplace:SearchAgreements",
                "aws-marketplace:DescribeAgreement"
            ],
            "Resource": "*",
            "Condition":
            {
                "StringEquals":
                {
                    "aws-marketplace:PartyType": "Proposer"
                }
            }
        }
    ]
}

Asignación de políticas a los roles y usuarios de IAM

Siga estos pasos para asignar políticas a los roles y usuarios de IAM:

  1. Inicie sesión en.AWS Management Console

  2. Navegue hasta el servicio de IAM.

  3. Seleccione las funciones o los usuarios y elija la función o el usuario de IAM al que desee asociar una política.

  4. Adjunta la AWSPartnerCentralOpportunityManagement política o tu política personalizada al rol o usuario de IAM seleccionado.

Para obtener más información, consulte Añadir y eliminar permisos de identidad de IAM.

Administrar los permisos mediante claves de condición

Las claves de condición de las políticas de IAM proporcionan permisos a nivel de recursos para determinar cuándo se deben aplicar las políticas de declaración. Puede utilizar las claves de condición para especificar las condiciones que determinan cuándo se permiten o deniegan determinados permisos.

Para obtener más información, consulte Elementos de la política de JSON de IAM: Operadores de condición.

Descripción general de las claves de condición
Clave de condición Description (Descripción) Acciones aplicables Valores válidos
Partner Central: catálogo filtra el acceso por el tipo de entidad de catálogo asociada todas las acciones AWS, sandbox
aws-marketplace: PartyType filtra el acceso según el tipo de persona (por ejemplo, el proponente) SearchAgreements, DescribeAgreement licitante

Resumen de los permisos necesarios

Resumen de los permisos necesarios
Action Description (Descripción)
partnercentral: CreateOpportunity permite crear oportunidades
Partnercentral: UpdateOpportunity permite actualizar las oportunidades
Partnercentral: ListOpportunities permite enumerar oportunidades
partnercentral: GetOpportunity permite recuperar los detalles de la oportunidad
central de socios: ListSolutions permite enumerar soluciones
Partnercentral: AssociateOpportunity permite asociar oportunidades con otras entidades
partnercentral: DisassociateOpportunity permite disociar las oportunidades de otras entidades
central de socios: AcceptEngagementInvitation permite aceptar invitaciones de compromiso
Partnercentral: RejectEngagementInvitation permite rechazar las invitaciones de compromiso
Partnercentral: GetEngagementInvitation permite recuperar los detalles de la invitación de compromiso
central de socios: ListEngagementInvitations permite enumerar las invitaciones de compromiso
Partnercentral: SubmitOpportunity permite enviar oportunidades
Partnercentral: GetAwsOpportunitySummary permite recuperar AWS el resumen de la oportunidad
Partnercentral: StartProspectingFromEngagementTask Crea una tarea de prospección a partir de las contrataciones
central de socios: GetProspectingFromEngagementTask Devuelve los detalles de la tarea de prospección
Partnercentral: ListProspectingFromEngagementTasks Devuelve una lista de tareas de prospección
aws-marketplace: ListEntities permite enumerar entidades AWS Marketplace
aws-marketplace: DescribeEntity permite describir entidades AWS Marketplace
aws-marketplace: SearchAgreements permite buscar acuerdos en AWS Marketplace
aws-marketplace: DescribeAgreement permite describir acuerdos en AWS Marketplace