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.

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

Trabalhe com soluções

Uma solução é uma coleção de produtos e serviços que trabalham juntos para resolver problemas específicos do cliente. As soluções podem incluir produtos do AWS Marketplace e produtos não pertencentes ao AWS Marketplace. As soluções ajudam você a mostrar como vários produtos se integram para abordar casos de uso específicos do setor. A solução descreve o problema do cliente, os casos de uso, os detalhes da integração e os produtos relacionados.

Soluções no AWS Marketplace e na Central de Parceiros da AWS

Ao migrar do Partner Central 2.0 para o Partner Central 3.0, você é solicitado a criar uma conta da AWS e se registrar como vendedor do AWS Marketplace. Para obter mais informações, consulte Registrar e criar seu perfil de vendedor. Esse registro é necessário para:

Entendendo a vinculação e a migração de perfis

Há dois cenários distintos para conectar suas contas do Partner Central e do AWS Marketplace:

Somente vinculação de perfil — Se você vincular suas contas do AWS Partner Central e da AWS sem migrar para o Partner Central 3.0, suas soluções do AWS Marketplace e as soluções do Partner Central permanecerão separadas. Você gerencia cada plataforma de forma independente.

Migração de perfil — Quando você migra para o Partner Central 3.0 com perfis de vendedor vinculados do AWS Marketplace:

Disponibilização de soluções preexistentes do AWS Marketplace para as APIs do Partner Central

As soluções do AWS Marketplace que você criou antes da migração do perfil do Partner Central 3.0 não são reconhecidas automaticamente pelas APIs do Partner Central. Isso se aplica mesmo depois de concluir a migração e vincular sua conta da AWS a uma conta do Partner Central.

Para tornar uma solução de pré-migração existente visível para as APIs do Partner Central, atualize qualquer campo na solução. Você pode inserir as mesmas informações que estão lá atualmente. Repita esse processo para cada solução que você criou antes da migração do perfil do Partner Central 3.0.

Por exemplo, use o tipo de UpdateInformation alteração para atualizar o nome de uma solução com seu valor atual. Depois de atualizar uma solução uma vez, as APIs do Partner Central reconhecerão automaticamente quaisquer atualizações futuras dessa solução.

Entidade de solução

Uma solução é um documento de marketing que ajuda os compradores a descobrir e entender suas ofertas. As soluções contêm título, descrição, casos de uso, produtos do AWS Marketplace e produtos que não são do AWS Marketplace. A solução é um tipo de entidade separado dos conjuntos de produtos, ofertas e ofertas. Cada solução tem sua própria experiência de descoberta e listagem, que os compradores podem pesquisar separadamente dos produtos individuais.

Características principais

O tipo de entidade da solução éSolution@1.0.

Identificadores de entidade

As soluções usam o formato de soln-* identificador (por exemplo,soln-abc123def456).

Formato ARN da entidade

As soluções seguem o formato ARN padrão da AWS:

arn:{aws-partition}:aws-marketplace:{region}:{account-id}:{aws-marketplace-catalog}/Solution/{solution-id}

Exemplo:

arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/soln-abc123def456

Introdução às soluções

Esta seção fornece informações detalhadas sobre como criar e gerenciar soluções usando os tipos de alteração da API de AWS Marketplace catálogo.

Antes de começar, você deve ter o seguinte:

Liste suas soluções

Para listar todas as soluções em sua conta, chame a operação da ListEntities API e EntityType defina como Solução.

Solicitação

POST /ListEntities HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "EntityType": "Solution"
}

Resposta

{
  "EntitySummaryList": [
    {
      "EntityArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/soln-abc123456",
      "EntityId": "soln-abc123456",
      "EntityType": "Solution",
      "LastModifiedDate": "2024-10-10T19:50:43Z",
      "Name": "Test Solution 1",
      "Visibility": "Limited"
    }
  ],
  "NextToken": null
}

Filtrar soluções por visibilidade

Você pode filtrar soluções por visibilidade usando o FilterList parâmetro.

Solicitação

POST /ListEntities HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "EntityType": "Solution",
  "FilterList": [
    {
      "Name": "Visibility",
      "ValueList": [
        "Public"
      ]
    }
  ]
}

Obtenha detalhes da solução

Para obter informações detalhadas sobre uma solução específica, chame a operação DescribeEntity da API.

Solicitação

GET /DescribeEntity?catalog=AWSMarketplace&entityId=soln-abc123456 HTTP/1.1

Resposta

{
  "Details": "{...}",
  "DetailsDocument": {
    "Lifecycle": {
      "Visibility": "Limited"
    },
    "Identifiers": {
      "Id": "soln-abc123456"
    },
    "Presentation": {
      "Title": "My Solution",
      "Name": "solution_for_customer_X",
      "ShortDescription": "Solution value proposition",
      "LongDescription": "Detailed solution description",
      "LogoUrl": "https://s3.amazonaws.com/logo.jpg",
      "UseCases": [
        {
          "Group": "advertising_and_marketing",
          "SubGroup": "ad_intelligence_and_measurement",
          "Item": "amazon_ads_insights",
          "Description": "Use case description"
        }
      ]
    },
    "RelatedProducts": {
      "AwsMarketplaceProducts": [
        {
          "ProductId": "prod-123"
        }
      ],
      "IntegrationDescription": "How products work together",
      "NonAwsMarketplaceProducts": [
        {
          "Type": "Hardware",
          "Title": "A hardware product",
          "Url": "https://example.com",
          "Description": "My hardware product description"
        }
      ]
    },
    "BuyerEngagement": [
      {
        "EngagementOption": "RequestPrivateOffer"
      }
    ]
  },
  "EntityArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/soln-abc123456",
  "EntityIdentifier": "soln-abc123456@12",
  "EntityType": "Solution@1.0",
  "LastModifiedDate": "2025-04-22T01:02:48Z"
}

Listar o histórico de alterações de uma solução

Para ver o histórico de alterações de uma solução específica, chame a operação da ListChangeSets API com um filtro de entidade.

Sintaxe da solicitação

POST /ListChangeSets HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "FilterList": [
    {
      "Name": "EntityId",
      "ValueList": [
        "soln-abc123456"
      ]
    }
  ]
}

Marque soluções e conjuntos de mudanças

Você pode adicionar tags às soluções e aos conjuntos de alterações durante a criação ou atualizá-los posteriormente.

Etiqueta durante a criação

Você pode adicionar EntityTags somente ao tipo de CreateSolution alteração, não a outros tipos de alteração da solução. Você pode adicionar ChangeSetTags a qualquer StartChangeSet carga útil.

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "CreateSolution",
      "Entity": {
        "Type": "Solution@1.0"
      },
      "DetailsDocument": {
        "Name": "Test solution resource name"
      },
      "EntityTags": [
        {
          "Key": "Team",
          "Value": "Solutions"
        }
      ]
    }
  ],
  "ChangeSetTags": [
    {
      "Key": "Environment",
      "Value": "Production"
    }
  ]
}

Gerencie tags em recursos existentes

Use as operações TagResource e a UntagResource API para gerenciar tags em soluções e conjuntos de alterações existentes. Use ListTagsForResource para visualizar as tags atuais.

Para obter mais informações, consulte Gerenciando tags em recursos e Adicionando tags a uma entidade e conjunto de alterações durante a criação.

Criar uma solução

Você pode usar o tipo de CreateSolution alteração para criar um novo documento de solução com apenas uma ID e nome da solução. Outros valores ainda não foram preenchidos.

Quando sua solicitação é processada com sucesso, o AWS Marketplace cria uma solução com Draft status para você. Essa solução incompleta não está visível para os compradores no AWS Marketplace.

Em seguida, você usa outros tipos de alteração para concluir a solução: UpdateInformationUpdateRelatedProducts,, UpdateBuyerEngagementOptions (opcional para criar uma Limited solução) ReleaseSolution e. O tipo de ReleaseSolution alteração valida se todos os campos obrigatórios necessários para uma Limited solução estão presentes na solução e, em seguida, os move para a Limited visibilidade.

Sintaxe da solicitação

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "CreateSolution",
      "Entity": {
        "Type": "Solution@1.0"
      },
      "ChangeName": "CreateSolutionChange",
      "DetailsDocument": {
        "Name": "solution_for_customerX_en",
        "Title": "New Partner Solution"
      }
    }
  ]
}

Forneça informações sobre os campos para adicionar o tipo de CreateSolution alteração:

Sintaxe de resposta

Um conjunto de alterações é criado para sua solicitação. A resposta fornece a você o ChangeSetId eChangeSetArn:

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

A solicitação de alteração é adicionada a uma fila e processada. Você pode verificar o status usando o portal de gerenciamento do AWS Marketplace ou a operação DescribeChangeSet da API.

Quando a solicitação for concluída com sucesso (se Status for o casoSUCCEEDED), uma nova ID da solução será gerada.

Erros assíncronos

CreateSolutionações retornam erros específicos, além de erros assíncronos comuns. Você recebe esses erros DescribeChangeSet após o término do processamento de um conjunto de alterações. Para saber como obter o status da solicitação de alteração, consulte Como trabalhar com conjuntos de alterações.

Atualizar as informações da solução

Se você já tem uma solução no AWS Marketplace, pode usar a API do catálogo para atualizar as informações da solução.

Para atualizar as informações da solução, chame a operação da StartChangeSet API com o tipo de UpdateInformation alteração e seus detalhes atualizados. Veja o exemplo a seguir.

O AWS Marketplace verifica e ingere logotipos e ativos de mídia promocional em um local da AWS Marketplace-owned . DescribeEntity retorna um URL acessível para os arquivos ingeridos, não sua entrada original de StartChangeSet. Para ver seus URLs originais enviados, use a DescribeChangeSet API.

Sintaxe da solicitação

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateInformation",
      "Entity": {
        "Identifier": "soln-1234abcd",
        "Type": "Solution@1.0"
      },
      "DetailsDocument": {
        "Name": "project_cold_harbor",
        "Title": "My Awesome Solution",
        "ShortDescription": "Solution value proposition",
        "LongDescription": "Detailed solution description explaining how this addresses customer needs",
        "LogoUrl": "https://s3.amazonaws.com/awsmp-logos/logo.jpg",
        "PromotionalMedia": [
          {
            "Type": "Image",
            "Url": "https://s3.amazonaws.com/awsmp-media/image.jpg",
            "Title": "Sample image",
            "Description": "Sample image description"
          },
          {
            "Type": "Video",
            "Url": "https://s3.amazonaws.com/awsmp-media/video.mp4",
            "Title": "Sample video",
            "PreviewUrl": "https://s3.amazonaws.com/awsmp-media/preview.png",
            "Description": "Sample video description"
          }
        ],
        "AdditionalResources": [
          {
            "Text": "Troubleshooting guide",
            "Url": "https://example.com/troubleshooting"
          }
        ],
        "UseCases": [
          {
            "Group": "advertising_and_marketing",
            "SubGroup": "ad_intelligence_and_measurement",
            "Item": "amazon_ads_insights",
            "Description": "Highlight description of this use case"
          }
        ]
      }
    }
  ]
}

Forneça informações sobre os campos para adicionar o tipo de UpdateInformation alteração:

Para obter informações sobre URLs pré-assinadas, consulte Compartilhamento de objetos com URLs pré-assinadas.

Sintaxe de resposta

Um conjunto de alterações é criado para sua solicitação. A resposta a essa solicitação fornece a ChangeSetId e ChangeSetArn para o conjunto de alterações e tem a seguinte aparência.

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

A solicitação de alteração é adicionada a uma fila e processada. Para verificar o status da solicitação, use o portal de gerenciamento do AWS Marketplace ou chame a DescribeChangeSet API.

Depois de acionar esse tipo de alteração com PromotionalMedia ativos modificados para uma Public solução, ele pode levar até 37 dias para ser concluído. Isso inclui o tempo que a equipe de operações de vendedores do AWS Marketplace precisa analisar, auditar e aprovar.

Erros assíncronos

Além dos erros assíncronos comuns, os erros a seguir são específicos de UpdateInformation ações na API do AWS Marketplace Catalog. Esses erros são retornados quando você liga DescribeChangeSet após o processamento de um conjunto de alterações. Para obter mais informações sobre como usar DescribeChangeSet para obter o status de uma solicitação de alteração, consulte Como trabalhar com conjuntos de alterações.

Atualizar produtos relacionados

Você pode usar a API do Catálogo para atualizar os produtos e serviços incluídos na sua solução, incluindo produtos do AWS Marketplace e produtos que não são do AWS Marketplace.

Para atualizar produtos relacionados, chame a operação da StartChangeSet API com o tipo de UpdateRelatedProducts alteração, conforme mostrado no exemplo a seguir.

Sintaxe da solicitação

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateRelatedProducts",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "soln-123456"
      },
      "DetailsDocument": {
        "IntegrationDescription": "How to use the products in this solution (usage guide)",
        "AwsMarketplaceProducts": [
          {
            "ProductId": "prod-123"
          },
          {
            "ProductId": "prod-456"
          }
        ],
        "NonAwsMarketplaceProducts": [
          {
            "Type": "Hardware",
            "Title": "Diamond engine",
            "Description": "Hardware details",
            "Url": "https://example.com/hardware-product-specs.html"
          }
        ]
      }
    }
  ]
}

Forneça informações sobre os campos para adicionar o tipo de UpdateRelatedProducts alteração:

Sintaxe de resposta

Um conjunto de alterações é criado para sua solicitação. A resposta a essa solicitação fornece a ChangeSetId e ChangeSetArn para o conjunto de alterações e tem a seguinte aparência.

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

A solicitação de alteração é adicionada a uma fila e processada.

Para verificar o status da solicitação, use o portal de gerenciamento do AWS Marketplace ou chame a DescribeChangeSet API.

Erros assíncronos

Além dos erros assíncronos comuns, os erros a seguir são específicos de UpdateRelatedProducts ações na API do AWS Marketplace Catalog. Esses erros são retornados quando você liga DescribeChangeSet após o processamento de um conjunto de alterações. Para obter mais informações sobre como usar DescribeChangeSet para obter o status de uma solicitação de alteração, consulte Como trabalhar com conjuntos de alterações.

Libere uma solução

Você pode usar a API do Catalog para publicar uma Draft solução com Limited visibilidade no AWS Marketplace.

O tipo de ReleaseSolution alteração valida que todos os campos obrigatórios de uma Limited solução estão presentes. Em seguida, ele move a solução da Draft Limited visibilidade. Quando uma solução está em Limited visibilidade, você não pode movê-la de volta à Draft visibilidade.

Para liberar uma solução, chame a operação da StartChangeSet API com o tipo de ReleaseSolution alteração, conforme mostrado no exemplo a seguir.

Sintaxe da solicitação

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "ReleaseSolution",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "soln-1234abcd"
      },
      "DetailsDocument": {}
    }
  ]
}

Forneça informações sobre os campos para adicionar o tipo de ReleaseSolution alteração:

Sintaxe de resposta

Um conjunto de alterações é criado para sua solicitação. A resposta a essa solicitação fornece a ChangeSetId e ChangeSetArn para o conjunto de alterações e tem a seguinte aparência.

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

A solicitação de alteração é adicionada a uma fila e processada. Você pode verificar o status da solicitação por meio do Portal de Gerenciamento do AWS Marketplace ou diretamente por meio da API do Catálogo usando a operação da DescribeChangeSet API.

Erros assíncronos

Além dos erros assíncronos comuns, os erros a seguir são específicos de ReleaseSolution ações na API do AWS Marketplace Catalog. Esses erros são retornados quando você liga DescribeChangeSet após o processamento de um conjunto de alterações. Para obter mais informações sobre como usar DescribeChangeSet para obter o status de uma solicitação de alteração, consulte Como trabalhar com conjuntos de alterações.

Atualizar as opções de engajamento do comprador

Você pode usar a API do Catálogo para configurar como os compradores interagem com você sobre sua solução.

Para atualizar as opções de engajamento do comprador, chame a operação da StartChangeSet API com o tipo de UpdateBuyerEngagementOptions alteração, conforme mostrado no exemplo a seguir.

Sintaxe da solicitação

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateBuyerEngagementOptions",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "soln-1234abcd"
      },
      "DetailsDocument": [
        {
          "EngagementOption": "RequestProductDemo"
        },
        {
          "EngagementOption": "RequestPrivateOffer"
        }
      ]
    }
  ]
}

Forneça informações sobre os campos para adicionar o tipo de UpdateBuyerEngagementOptions alteração:

Sintaxe de resposta

Um conjunto de alterações é criado para sua solicitação. A resposta a essa solicitação fornece a ChangeSetId e ChangeSetArn para o conjunto de alterações e tem a seguinte aparência.

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

A solicitação de alteração é adicionada a uma fila e processada.

Para verificar o status da solicitação, use o portal de gerenciamento do AWS Marketplace ou chame a DescribeChangeSet API.

Erros assíncronos

Além dos erros assíncronos comuns, os erros a seguir são específicos de UpdateBuyerEngagementOptions ações na API do AWS Marketplace Catalog. Esses erros são retornados quando você liga DescribeChangeSet após o processamento de um conjunto de alterações. Para obter mais informações sobre como usar DescribeChangeSet para obter o status de uma solicitação de alteração, consulte Como trabalhar com conjuntos de alterações.

Atualize a visibilidade da solução

Você pode usar a API do Catálogo para atualizar a visibilidade de uma solução no AWS Marketplace.

Você pode definir as visibilidades do alvo como LimitedPublic, ouRestricted.

Quando você define comoPublic, TargetVisibility o tipo de UpdateVisibility alteração exige uma revisão manual da equipe de operações do vendedor do AWS Marketplace. Isso aumenta o tempo de execução. Use UpdateVisibility separadamente em seu próprio conjunto de alterações.

Para atualizar a visibilidade da sua solução, chame a operação da StartChangeSet API com o tipo de UpdateVisibility alteração, conforme mostrado no exemplo a seguir.

Sintaxe da solicitação

Para quando TargetVisibility é Public ouLimited.

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateVisibility",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "soln-1234abcd"
      },
      "DetailsDocument": {
        "TargetVisibility": "Public"
      }
    }
  ]
}

Para quando TargetVisibility éRestricted.

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateVisibility",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "soln-1234abcd"
      },
      "DetailsDocument": {
        "TargetVisibility": "Restricted"
      }
    }
  ]
}

Forneça informações sobre os campos para adicionar o tipo de UpdateVisibility alteração:

Sintaxe de resposta

Um conjunto de alterações é criado para sua solicitação. A resposta a essa solicitação fornece a ChangeSetId e ChangeSetArn para o conjunto de alterações e tem a seguinte aparência.

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

A solicitação de alteração é adicionada a uma fila e processada.

Você pode verificar o status da solicitação por meio do Portal de Gerenciamento do AWS Marketplace ou diretamente por meio da API do Catálogo usando a operação da DescribeChangeSet API.

Depois de acionar esse tipo de alteração com TargetVisibility asPublic, pode levar até 37 dias para ser concluído. Isso inclui o tempo que a equipe de operações de vendedores do AWS Marketplace precisa analisar, auditar e aprovar.

Erros assíncronos

Os erros a seguir são específicos de UpdateVisibility ações na API do AWS Marketplace Catalog. Esses erros são retornados quando você liga DescribeChangeSet após o processamento de um conjunto de alterações. Para obter mais informações sobre como usar DescribeChangeSet para obter o status de uma solicitação de alteração, consulte Como trabalhar com conjuntos de alterações.

Códigos de erro assíncronos comuns

Há algumas validações assíncronas que se aplicam a todos os tipos de alteração de solução, como verificações de validade de URL e caracteres não suportados, e seus códigos de erro e mensagens de erro estão listados aqui.

Cada campo de URL fornecido deve usar o protocolo HTTPS e estar em conformidade com os padrões RFC2396 ou RFC 2732.

Ciclo de vida da solução

As soluções progridem por meio dos seguintes valores de visibilidade:

Requisitos mínimos para uma solução completa

Para criar uma solução completa e publicá-la além do status de Rascunho, você precisa dos seguintes tipos e atributos de alteração:

O exemplo a seguir mostra como criar uma solução completa com Limited visibilidade em um único conjunto de alterações:

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "CreateSolution",
      "Entity": {
        "Type": "Solution@1.0"
      },
      "ChangeName": "CreateSolutionChange",
      "DetailsDocument": {
        "Name": "complete_solution_example",
        "Title": "Complete Solution Example"
      }
    },
    {
      "ChangeType": "UpdateInformation",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "$CreateSolutionChange.Entity.Identifier"
      },
      "ChangeName": "UpdateInformationChange",
      "DetailsDocument": {
        "ShortDescription": "A comprehensive solution for customer needs",
        "LongDescription": "This solution combines multiple products to address specific customer requirements in the advertising and marketing space.",
        "LogoUrl": "https://s3.amazonaws.com/awsmp-logos/solution-logo.jpg",
        "UseCases": [
          {
            "Group": "advertising_and_marketing",
            "SubGroup": "ad_intelligence_and_measurement",
            "Item": "amazon_ads_insights",
            "Description": "Provides comprehensive advertising insights and measurement capabilities"
          }
        ]
      }
    },
    {
      "ChangeType": "UpdateRelatedProducts",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "$CreateSolutionChange.Entity.Identifier"
      },
      "ChangeName": "UpdateRelatedProductsChange",
      "DetailsDocument": {
        "AwsMarketplaceProducts": [
          {
            "ProductId": "prod-123"
          }
        ],
        "IntegrationDescription": "These products work together to provide end-to-end advertising analytics and optimization capabilities."
      }
    },
    {
      "ChangeType": "UpdateBuyerEngagementOptions",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "$CreateSolutionChange.Entity.Identifier"
      },
      "ChangeName": "UpdateBuyerEngagementChange",
      "DetailsDocument": [
        {
          "EngagementOption": "RequestPrivateOffer"
        }
      ]
    },
    {
      "ChangeType": "ReleaseSolution",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "$CreateSolutionChange.Entity.Identifier"
      },
      "ChangeName": "ReleaseSolutionChange",
      "DetailsDocument": {}
    }
  ]
}

Permissões do IAM para soluções

A API do AWS Marketplace Catalog usa permissões padrão do IAM. Consulte Controle de acesso para a API do AWS Marketplace Catalog para obter mais detalhes.

Você pode usar AWSMarketplaceSellerProductFullAccess para realizar todas as operações necessárias para acessar a Solução por meio da API do Catálogo e do Partner Central 3.0 no AWS Management Console.

Exemplo de política de IAM para soluções

O exemplo de política do IAM a seguir permite ações específicas (DescribeEntityListEntities, eStartChangeSet) na Solution@1.0 entidade. Você pode restringi-lo ainda mais para restringir o acesso de um principal a determinados tipos de alteração em determinados IDs de entidade ou ampliá-lo para permitir que um principal também opere em outro tipo de entidade compatível com a API de catálogo.

{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:StartChangeSet"
      ],
      "Resource": [
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*",
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/*"
      ],
      "Condition": {
        "StringEquals": {
          "catalog:ChangeType": [
            "CreateSolution",
            "UpdateInformation",
            "UpdateRelatedProducts",
            "ReleaseSolution",
            "UpdateBuyerEngagementOptions",
            "UpdateVisibility"
          ]
        }
      }
    },
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:ListEntities",
        "aws-marketplace:DescribeEntity"
      ],
      "Resource": [
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:DescribeChangeSet",
        "aws-marketplace:ListChangeSets",
        "aws-marketplace:CancelChangeSet"
      ],
      "Resource": [
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:TagResource",
        "aws-marketplace:UntagResource",
        "aws-marketplace:ListTagsForResource"
      ],
      "Resource": [
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*",
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/*"
      ]
    }
  ]
}

Restringindo o acesso a soluções específicas

Você pode restringir o acesso a soluções específicas usando o ID da solução no ARN do recurso:

{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:DescribeEntity",
        "aws-marketplace:StartChangeSet"
      ],
      "Resource": [
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/soln-specific123"
      ]
    }
  ]
}

Restringindo o acesso a tipos específicos de alteração

Você pode restringir o acesso a tipos de alteração específicos usando chaves de condição:

{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:StartChangeSet"
      ],
      "Resource": [
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*"
      ],
      "Condition": {
        "StringEquals": {
          "catalog:ChangeType": [
            "UpdateInformation",
            "UpdateRelatedProducts"
          ]
        }
      }
    }
  ]
}