AddDataConjuntos - Guia do usuário do AWS Data Exchange

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

AddDataConjuntos

Importante

A partir de 22 de julho de 2021, provedores novos e existentes podem publicar revisões automaticamente em conjuntos de dados. Todos os novos produtos emAWS Data Exchangepadrão para publicação automática de revisões. Se você criou produtos existentes emAWS Data ExchangeAntes de 22 de julho de 2021, você precisa migrá-los para a publicação de revisão automática.

Para obter mais informações, consulte Migração de um produto existente para publicação automática de revisão.

nota

Conjuntos de dados adicionados por meio do conjunto de alterações da API do catálogoAddDataSetspadrão para o método de publicação do produto.

Para adicionar conjuntos de dados ao seuAWS Data Exchangeproduto, inicie um conjunto de alterações do tipoAddDataSets. Para fazer isso, você pode usar oStartChangeSetOperação da API e especifique o tipo de alteração, o identificador do produto, o tipo de produto e os detalhes, incluindo o conjunto de dados Amazon Resource Name (ARN).

Tutorial: Adicionando novos conjuntos de dados a um produto de dados publicado

Este tutorial orienta você a etapas detalhadas para adicionar novasAWS Data Exchangeconjuntos de dados para um produto publicado. O tutorial tem as seguintes etapas de nível elevado.

Configurar permissões do IAM

Antes de começar, você precisaAWS Identity and Access ManagementPermissões (IAM) para usar oAWS MarketplaceAPI do Catalog. Essas permissões vão além das permissões que você precisa para usarAWS Data Exchange.

  1. Navegue pelo navegador até o console do IAM e faça login usando umConta da AWSque podem gerenciar permissões do IAM.

  2. No painel de navegação esquerdo, escolhaPolíticas.

  3. Escolha Create policy (Criar política).

  4. Selecione oJSONe forneça as seguintes permissões. Isso fornece acesso total aoAWS MarketplaceAPI do Catalog. Você pode restringir o acesso conforme apropriado para o seu caso de uso.

    { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "aws-marketplace:CancelChangeSet", "aws-marketplace:ListChangeSets", "aws-marketplace:DescribeEntity", "aws-marketplace:StartChangeSet", "aws-marketplace:ListEntities", "aws-marketplace:DescribeChangeSet", "dataexchange:PublishDataSet" ], "Resource": "*" } ] }
  5. Selecione Next (Próximo): Análise.

  6. Forneça um nome para a política do (por exemplo,CatalogAPIFullAccess) e, depois, escolhaCriar política.

  7. Usando o console do IAM, escolha os usuários, grupos ou funções aos quais você deseja anexar a política.

Acesso aoAWS MarketplaceAPI do Catalog

Para acessar oAWS MarketplaceAPI do catálogo, use o seguinte endpoint de cliente HTTP.

catalog.marketplace.us-east-1.amazonaws.com

Obtenha o ID do produto a partir doAWS Data Exchangeconsole

Antes de poder usar oAWS MarketplaceAPI do catálogo para publicar novos conjuntos de dados, obter o ID do produto a partir doAWS Data Exchangeconsole do . Navegue até o .Painel do produtoe, em seguida, copie o ID do produto para o qual você gostaria de publicar conjuntos de dados. Você também pode usar oAWS MarketplaceAPI do Catalogpara encontrar o ID do produto, usando oListEntitiesação com oDataProduct@1.0tipo de entidade.

Iniciar uma solicitação de alteração

Para iniciar uma solicitação de alteração para adicionar um conjunto de dados em seu produto de teste

  1. Copie o ID da entidade que você obtém seguindo as instruções emObtenha o ID do produto a partir doAWS Data Exchangeconsole.

  2. Faça umStartChangeSetsolicitação com umAddDataSetsAlterar tipo.

nota

Para obter mais informações sobre como trabalhar com conjuntos de alterações noAWS MarketplaceAPI do Catalog, consulteTrabalhar com conjuntos de alteração. Para obter mais informações sobre como trabalhar com o identificador de entidades, consulteIdentifier.

Exemplo de solicitação

https://catalog.marketplace.us-east-1.amazonaws.com/StartChangeSet

Exemplo de corpo da solicitação

{ "Catalog": "AWSMarketplace", "ChangeSetName": "Adding Data Set to my test Data Product", "ChangeSet": [ { "ChangeType": "AddDataSets", "Entity": { "Identifier": "entity-id@1", "Type": "DataProduct@1.0" }, "Details": "{ \"DataSets\": [ { \"Arn\": \"data-set-arn\" } ] }" } ] }

Exemplo de resposta

{ "ChangeSetId": "cs-bnEXAMPLE4mkz9oh", "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:account-id:AWSMarketplace/ChangeSet/cs-bnEXAMPLE4mkz9oh" }

Verifique o status do seu conjunto de alterações

Depois de usar oStartChangeSetOperação da API para iniciar a solicitação de alteração, você pode usar oDescribeChangeSetoperação para verificar seu status. Forneça o ID do conjunto de alterações retornado naStartChangeSetResposta da API do.

Exemplo de solicitação

https://catalog.marketplace.us-east-1.amazonaws.com/DescribeChangeSet?catalog=AWSMarketplace&changeSetId=cs-bnEXAMPLE4mkz9oh

Exemplo de corpo da solicitação

{ "changeSetId":"cs-bnEXAMPLE4mkz9oh" }

Exemplo de resposta

{ "ChangeSetId": "cs-bnEXAMPLE4mkz9oh", "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:account-id:AWSMarketplace/ChangeSet/cs-bnEXAMPLE4mkz9oh", "ChangeSetName": "Adding Data Set to my test Data Product", "StartTime": "2018-09-20T19:45:03.115+0000", "EndTime": "2018-09-20T19:48:12.517+0000", "Status": "SUCCEEDED", "FailureDescription": null, "ChangeSet": [ { "ChangeType": "AddDataSets", "Entity": { "Type": "DataProduct@1.0", "Identifier": "entity-id@1" }, "ErrorList": [] } ] }

AddDataDefine exceções

As seguintes exceções podem ocorrer quando você usa oAWS MarketplaceAPI do Catalog comAWS Data Exchange:

DATA_SET_NOT_FOUND

Isso acontece quando o conjunto de dados solicitado não foi encontrado. Para resolver esse problema, certifique-se de que não há um erro de digitação no ARN do conjunto de dados e que seuConta da AWSé dono do conjunto de dados e tente novamente.

INVALID_INPUT

A solicitação não pôde ser processada devido aentradaque não é válido. Para resolver esse problema, certifique-se de que não há um erro de digitação na solicitação e que o produto não exceda o número máximo de conjuntos de dados permitidos.

DATA_SET_ALREADY_PUBLISHED

Isso acontece quando o conjunto de dados já foi adicionado anteriormente ao produto.

DATA_SET_DUPLICATE_PROVIDE

Isso acontece quando o mesmo conjunto de dados é fornecido mais de uma vez na solicitação.