View a markdown version of this page

Usar o AWS Marketplace API para compartilhar recursos - AWS Marketplace
Pré-requisitos para compartilhar AWS Marketplace entidadesCompartilhe um AWS Marketplace entidade

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

Usar o AWS Marketplace API para compartilhar recursos

AWS Marketplace Catalog API integra-se com AWS Resource Access Manager (AWS RAM) para permitir o compartilhamento de recursos. Um recurso é uma entidade com a qual os usuários podem trabalhar AWS Marketplace, como um produto, uma oferta ou uma autorização de revenda. Com AWS RAM, você pode compartilhar alguns AWS Marketplace Catalog API recursos com outros Contas da AWS. Você compartilha atributos que possui criando um compartilhamento de atributos. Um compartilhamento de recursos especifica os recursos que você deseja compartilhar e os consumidores com quem compartilhá-los.

Pré-requisitos para compartilhar AWS Marketplace entidades

Antes de compartilhar entidades AWS Marketplace Catalog API, você deve atender aos seguintes pré-requisitos:

  • Você só pode ter uma política de recursos anexada à sua AWS Marketplace entidade.

  • Para compartilhar uma AWS Marketplace entidade, você deve possuí-la em seu Conta da AWS. Esse requisito significa que a entidade deve ser alocada ou provisionada em sua conta. Você não pode compartilhar uma AWS Marketplace entidade que tenha sido compartilhada com você.

Compartilhe um AWS Marketplace entidade

Com o compartilhamento de AWS Marketplace recursos, os proprietários de entidades podem compartilhar suas entidades com outras Contas da AWS pessoas AWS Marketplace. Entity-owners podem ser ISVs e parceiros de canal. As entidades que podem ser compartilhadas são produtos, ofertas e autorizações de revenda.

nota

No momento, você só pode compartilhar entidades. As entidades em AWS Marketplace incluem AmiProduct AudienceBrandingSettings,ContainerProduct,Experience,, ProcurementPolicy e.

Para obter mais informações sobre AWS RAM, consulte o Guia AWS RAM do usuário. Para obter mais informações sobre como gerenciar seus recursos compartilhados, consulte Como usar AWS recursos compartilhados no Guia AWS RAM do usuário.

Como conta de compartilhamento, você pode definir somente leitura ou ambas read/write nos recursos que deseja compartilhar. Essas permissões determinam quais operações uma conta consumidora pode realizar nos recursos que são compartilhados com ela.

  • Conta de compartilhamento — O recurso que é compartilhado e no qual o AWS RAM administrador cria o compartilhamento de AWS recursos usando AWS RAM.

  • Conta consumidora — A conta Conta da AWS com a qual um recurso é compartilhado. O compartilhamento de recursos pode especificar uma conta inteira como entidade principal ou, para alguns tipos de recursos, perfis ou usuários individuais na conta.

Para compartilhar uma AWS Marketplace entidade, você deve adicioná-la a um compartilhamento de recursos. Um compartilhamento de recursos é um recurso do AWS RAM que permite que você compartilhe seus recursos entre Contas da AWS. Um compartilhamento de recursos especifica os recursos a serem compartilhados, e os clientes com os quais compartilhá-los. Ao compartilhar uma entidade usando o AWS Marketplace console, você a adiciona a um compartilhamento de recursos existente. Para adicionar a AWS Marketplace entidade a um novo compartilhamento de recursos, primeiro você deve criar o compartilhamento de recursos usando o AWS RAM console.

Você pode compartilhar uma AWS Marketplace entidade de sua propriedade usando o AWS Marketplace console, o AWS RAM console ou o AWS Command Line Interface (AWS CLI).

Para compartilhar um AWS Marketplace entidade que você possui usando o AWS RAM console

Consulte Criar um compartilhamento de recursos no Manual do usuário do AWS RAM .

Para compartilhar um AWS Marketplace entidade que você possui usando o AWS CLI

Use o comando create-resource-share.

nota

Para tipos de recursos, como entidades que oferecem suporte a políticas baseadas em recursos, você pode usar AWS RAM para compartilhar recursos para usar recursos adicionais AWS RAM . Para obter mais informações, consulte a Resource-based política no Guia AWS RAM do usuário. AWS RAM usa o AWS Marketplace Catalog API para criar automaticamente a política de recursos a partir das permissões em um compartilhamento de recursos e gerencia essa política de recursos para você.

Para obter informações sobre como definir, visualizar ou excluir políticas AWS baseadas em recursos em sua AWS Marketplace entidade por meio de AWS RAM, consulte Permitir ações em todos os recursos no Guia do AWS RAMusuário.

Diferenças entre compartilhar uma entidade por meio de AWS RAM e o AWS Marketplace Catalog API

Além de compartilhar sua entidade por meio de AWS RAM, você também pode definir, visualizar ou excluir políticas AWS baseadas em recursos em suas entidades por meio do. AWS Marketplace Catalog API No entanto, existem algumas diferenças entre compartilhar sua entidade por AWS RAM meio do AWS Marketplace Catalog API.

Quando você compartilha uma entidade por meio de AWS RAM:

  • Se você compartilha sua entidade com contas externas AWS Organizations, a conta consumidora deve primeiro aceitar sua solicitação de compartilhamento antes que a entidade seja compartilhada.

  • A conta consumidora pode descobrir a entidade compartilhada por meio ListEntities de OwnershipType set toSHARED.

  • Você deve aderir a várias cotas de recursos. Para ter mais informações, consulte Service quotas for AWS RAM no Guia do usuário do AWS RAM .

Quando você compartilha uma entidade por meio do AWS Marketplace Catalog API:

  • Sua entidade será compartilhada assim que a PutResourcePolicy solicitação for bem-sucedida, sem nenhuma entrada da conta consumidora.

  • A conta consumidora não consegue descobrir a entidade compartilhada por meio ListEntities de OwnershipType set toSHARED. Em vez disso, o proprietário da conta de compartilhamento deve informar à conta consumidora o ID da entidade compartilhada.

nota

Se seu caso de uso exigir o compartilhamento de recursos que possam exceder as cotas de AWS RAM serviço, ou se você quiser compartilhar recursos sem a entrada direta da conta consumidora, considere compartilhar por meio do AWS Marketplace Catalog API. Para todos os outros casos de uso, considere usar AWS RAM para compartilhar AWS Marketplace recursos.

As seções a seguir detalham como você pode definir, visualizar ou excluir políticas AWS baseadas em recursos em suas entidades por meio do. AWS Marketplace Catalog API

Anexe uma política somente para leitura ao seu recurso

Você pode criar uma política baseada em recursos somente para leitura em seu recurso compartilhado usando uma conta de compartilhamento. Com essa política, o diretor só pode visualizar os detalhes do recurso que é compartilhado com ele.

Solicitação

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

{
   "ResourceArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/AmiProduct/example2-abcd-1234-5ef6",
   "Policy": { 
        "Version": "2012-10-17",
        "Statement": {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::222233334444:root"
            },
            "Action": [
                "aws-marketplace:DescribeEntity"
            ],
            "Resource": [
                "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/AmiProduct/example2-abcd-1234-5ef6"
            ]
        }
    }
}

Resposta

HTTP/1.1 200
Content-type: application/json

{}

Anexe uma política de recursos de leitura e gravação ao seu recurso

Como conta de compartilhamento, você pode criar uma política baseada em recursos de leitura e gravação em seu recurso compartilhado. Com essa política, o diretor pode visualizar os detalhes e realizar operações de gravação no recurso que é compartilhado com ele.

Solicitação

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

{
   "ResourceArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/AmiProduct/example2-abcd-1234-5ef6",
   "Policy": { 
        "Version": "2012-10-17",
        "Statement": {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::222233334444:root"
            },
            "Action": [
                "aws-marketplace:DescribeEntity",
                "aws-marketplace:StartChangeSet"
            ],
            "Resource": [
                "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/AmiProduct/example2-abcd-1234-5ef6"
            ]
        }
    }
}

Resposta

HTTP/1.1 200
Content-type: application/json

{}

Visualize a política de recursos definida em seu recurso

Como conta de compartilhamento, você pode visualizar a política de recursos definida no seu recurso compartilhado.

Solicitação

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

{
   "ResourceArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/AmiProduct/example2-abcd-1234-5ef6"
}

Resposta

HTTP/1.1 200
Content-type: application/json

{
  "Policy": { 
        "Version": "2012-10-17",
        "Statement": {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::222233334444:root"
            },
            "Action": [
                "aws-marketplace:DescribeEntity",
                "aws-marketplace:StartChangeSet"
            ],
            "Resource": [
                "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/AmiProduct/example2-abcd-1234-5ef6"
            ]
        }
    }
}

Excluir política de recursos em seu recurso

Como conta de compartilhamento, você pode excluir a política de recursos definida no seu recurso compartilhado.

Solicitação


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

{
   "ResourceArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/AmiProduct/example2-abcd-1234-5ef6"
}

Resposta

HTTP/1.1 200
Content-type: application/json

{}

Veja todos os recursos pertencentes a você e compartilhados com você

Como conta consumidora, você pode visualizar os recursos que são compartilhados com você.

nota

Você pode visualizar os recursos compartilhados com você somente se os recursos foram compartilhados por meio de AWS RAM.

Solicitação


POST /ListEntities HTTP/1.1
Content-type: application/json
{
   "Catalog": "AWSMarketplace",
   "EntityType": "AmiProduct",
   "FilterList": [ 
      { 
         "Name": "EntityId",
         "ValueList": [ "example2-abcd-1234-5ef6" ]
      }
   ],
   "OwnershipType": "SHARED"
}

Resposta

HTTP/1.1 200
Content-type: application/json

{ 
  "EntitySummaryList": [ 
    { 
      "EntityArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/AmiProduct/example2-abcd-1234-5ef6",
      "EntityId": "example2-abcd-1234-5ef6",
      "EntityType": "AmiProduct",
      "LastModifiedDate": "2018-02-27T13:45:22Z",
      "Name": "TestProduct",
      "Visibility": "public" 
    } 
  ],
  "NextToken": "" 
}