Se reestructuró la referencia de API de AWS Marketplace. Para obtener más información sobre las operaciones de API compatibles, consulte la [referencia de API de AWS Marketplace](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html).

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.

# Control de acceso para AWS Marketplace API de informes
<a name="reporting-api-access-control"></a>

Utiliza la API de AWS Marketplace informes para obtener el panel de **información sobre adquisiciones**. La API respalda la [https://docs.aws.amazon.com/marketplace/latest/APIReference/API_marketplace-reporting_GetBuyerDashboard.html](https://docs.aws.amazon.com/marketplace/latest/APIReference/API_marketplace-reporting_GetBuyerDashboard.html)acción. 

Para usar la API, primero debes crear el rol `AWSServiceRoleForProcurementInsightsPolicy` vinculado al servicio. El rol hace lo siguiente: 
+ Permite acceder AWS Marketplace a los datos de todas las cuentas de la organización de un comprador y describirlos.
+ Obtiene el panel **de información sobre adquisiciones**
+ Le permite registrar y anular el registro de los administradores delegados

Los compradores crean el rol cuando usan la AWS Marketplace consola para permitir un acceso confiable al panel de información **sobre adquisiciones**. Para obtener más información sobre ese proceso, consulte [Activar el panel](https://docs.aws.amazon.com/marketplace/latest/buyerguide/enabling-procurement-insights.html#integrate-dashboard) de control en la *Guía del AWS Marketplace comprador*.

**importante**  
Al utilizar la API o la CLI, debe crear el rol vinculado al servicio antes de habilitar el acceso confiable al panel.
Además del rol vinculado al servicio, debe habilitar todas las funciones de su organización y debe pertenecer a una cuenta de administrador. Para obtener más información, consulte los siguientes temas de la *Guía del usuario de AWS Organizations*:  
 [Habilitar todas las funciones para una organización con AWS Organizations](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)
[Tutorial: Creación y configuración de una organización](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_tutorials_basic.html)
[Administrar la cuenta de administración con AWS Organizations](https://docs.aws.amazon.com/organizations/latest/userguide/orgs-manage_accounts_management.html)

`AWSServiceRoleForProcurementInsightsPolicy`Deben tener los siguientes permisos de IAM para poder iniciar la [https://docs.aws.amazon.com/marketplace/latest/APIReference/API_marketplace-reporting_GetBuyerDashboard.html](https://docs.aws.amazon.com/marketplace/latest/APIReference/API_marketplace-reporting_GetBuyerDashboard.html)acción y registrar y anular el registro de los administradores delegados:

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [{
            "Sid": "CreateServiceLinkedRoleForProcurementInsights",
            "Effect": "Allow",
            "Action": "iam:CreateServiceLinkedRole",
            "Resource": "arn:aws:iam::*:role/aws-service-role/procurement-insights.marketplace.amazonaws.com/AWSServiceRoleForProcurementInsights*",
            "Condition": {
                "StringLike": {
                    "iam:AWSServiceName": "procurement-insights.marketplace.amazonaws.com"
                }
            }
        },
        {
            "Sid": "EnableAWSServiceAccessForProcurementInsights",
            "Effect": "Allow",
            "Action": [
                "organizations:EnableAWSServiceAccess"
            ],
            "Resource": "*",
            "Condition": {
                "StringLike": {
                    "organizations:ServicePrincipal": "procurement-insights.marketplace.amazonaws.com"
                }
            }
        },
        {
            "Sid": "ManageDelegatedAdministrators",
            "Effect": "Allow",
            "Action": [
                "organizations:ListDelegatedAdministrators",
                "organizations:DeregisterDelegatedAdministrator",
                "organizations:RegisterDelegatedAdministrator"
            ],
            "Resource": "*",
            "Condition": {
                "StringLike": {
                    "organizations:ServicePrincipal": "procurement-insights.marketplace.amazonaws.com"
                }
            }
        },
        {
            "Sid": "GetBuyerDashboardStatement",
            "Effect": "Allow",
            "Action": "aws-marketplace:GetBuyerDashboard",
            "Resource": "*"
        },
        {
            "Sid": "ViewOrganizationDetails",
            "Effect": "Allow",
            "Action": [
                "organizations:DescribeOrganization",
                "organizations:ListAWSServiceAccessForOrganization"
            ],
            "Resource": "*"
        }
    ]
}
```

------

Para obtener más información sobre la creación de políticas, consulte [Políticas y permisos en AWS Identity and Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html), en la *Guía del usuario de IAM*.

Para obtener más información sobre las AWS Organizations acciones que utiliza la política, consulte la [referencia de la AWS Organizations API](https://docs.aws.amazon.com/organizations/latest/APIReference/API_Operations.html).