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

AddRevisions

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 automática de revisão.

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

nota

O procedimento a seguir é para provedores existentes que ainda não migraram seus produtos para publicação automática de revisões.

Para publicar novas revisões do conjunto de dados em seuAWS Data Exchangeproduto, você precisa criar um conjunto de alterações do tipoAddRevisions. Para fazer isso, você pode usar oStartChangeSetOperação da API e especifique o tipo de alteração, o id do produto, o tipo de produto e os detalhes, incluindo o conjunto de dados e a revisão Amazon Resource Names (ARNs).

Você pode atualizar vários produtos em um únicoAddRevisionsconjunto de alterações. Cada alteração tem escopo para um único conjunto de dados dentro de um produto. Se o produto tiver mais de um conjunto de dados e você precisar atualizar todos eles, crie uma alteração separada para cada conjunto de dados.

Tutorial: Adicionando novas revisões de conjuntos de dados a um produto de dados publicado

Este tutorial orienta você através de etapas detalhadas para publicar novosAWS Data ExchangeRevisões do conjunto de dados para um produto existente. 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 necessárias 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 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. Escolha Review policy (Revisar política).

  6. Forneça um nome para a política (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 novas revisões, 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 revisões. 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 revisões a 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 umAddRevisionsAlterar tipo. Os detalhes doAddRevisionsAlterar objeto, no corpo da solicitação, deve conter o seguinte:

    • DataSetArn— O conjunto de dados ao qual você deseja adicionar revisões.

    • RevisionArns— As revisões que você deseja publicar no conjunto de dados no produto. Para obter mais informações sobre o número de revisões que uma única alteração pode incluir, consulteAWS Data ExchangeCotas do .

nota

Para obter mais informações sobre como trabalhar com conjuntos de alterações noAWS MarketplaceAPI do Catalog, consulteTrabalhar com conjuntos de alterações. Para obter mais informações sobre como trabalhar com o identificador para 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 revisions to my test Data Product", "ChangeSet": [ { "ChangeType": "AddRevisions", "Entity": { "Identifier": "entity-id@1", "Type": "DataProduct@1.0" }, "Details": "{\"DataSetArn\": \"data-set-arn\", \"RevisionArns\": [\"revision-arn\", \"revision-arn-2\"] }" } ] }

Exemplo de resposta

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

Verifique o status do 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.

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 revisions 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": "AddRevisions", "Entity": { "Type": "DataProduct@1.0", "Identifier": "entity-id@1" }, "ErrorList": [] } ] }

AddRevisionsexceções

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

REVISION_NOT_FOUND

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

REVISION_NOT_FINALIZADO

As revisões devem ser finalizadas antes de serem adicionadas aoAWS Data ExchangeProdutos . Para resolver esse problema, certifique-se de que as revisões com os ARNs especificados estejam finalizadas e tente novamente.

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 é inválido. Para resolver esse problema, certifique-se de que não haja um erro de digitação na solicitação e que a lista de revisões tenha pelo menos uma e não mais que cinco revisões.

DATA_SET_NOT_PUBLISHED

O recurso solicitado não foi publicado neste produto. Para resolver esse problema, certifique-se de que não há um erro de digitação nos ARNsPara o conjunto de dadoss. Você também pode publicar um novo produto que inclui esses conjuntos de dadoss.

REVISION_DUPLICATE_PROVIDE

Isso acontece quando a mesma solicitação de revisão ocorre mais de uma vez. Para resolver esse problema, certifique-se de que as revisões não são duplicadas e tente novamente.