A referência da API do AWS Marketplace foi reestruturada. Para obter mais informações sobre as operações de API suportadas, consulte a [Referência de API do AWS Marketplace](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html).

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á.

# Controle de acesso para o AWS Marketplace API de relatórios
<a name="reporting-api-access-control"></a>

Você usa a API AWS Marketplace de relatórios para obter o painel de **insights de compras**. A API suporta a [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)ação. 

Para usar a API, você deve primeiro criar a função `AWSServiceRoleForProcurementInsightsPolicy` vinculada ao serviço. A função faz o seguinte: 
+ Permite AWS Marketplace acessar e descrever os dados de todas as contas na organização do comprador.
+ Obtém o **painel de informações de compras**
+ Permite que você registre e cancele o registro de administradores delegados

Os compradores criam a função quando usam o AWS Marketplace console para permitir acesso confiável ao painel de **insights de compras**. Para obter mais informações sobre esse processo, consulte [Ativação do painel](https://docs.aws.amazon.com/marketplace/latest/buyerguide/enabling-procurement-insights.html#integrate-dashboard), no *Guia do AWS Marketplace comprador*.

**Importante**  
Ao usar a API ou a CLI, você deve criar a função vinculada ao serviço antes de habilitar o acesso confiável ao painel.
Além da função vinculada ao serviço, você deve habilitar todos os recursos da sua organização e pertencer a uma conta de administrador. Para obter mais informações, consulte os seguintes tópicos no *Guia do Usuário do AWS Organizations*:  
 [Habilitando todos os recursos de uma organização com AWS Organizations](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)
[Tutorial: Criando e configurando uma organização](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_tutorials_basic.html)
[Gerenciando a conta de gerenciamento com AWS Organizations](https://docs.aws.amazon.com/organizations/latest/userguide/orgs-manage_accounts_management.html)

Eles `AWSServiceRoleForProcurementInsightsPolicy` devem ter as seguintes permissões do IAM para chamar a [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)ação e registrar e cancelar o registro de 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 obter mais informações sobre a criação de políticas, consulte [Políticas e permissões em AWS Identity and Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html), no *Guia do usuário do IAM*.

Para obter mais informações sobre as AWS Organizations ações que a política usa, consulte a [referência AWS Organizations da API](https://docs.aws.amazon.com/organizations/latest/APIReference/API_Operations.html).