AddDataSets

nota

Os conjuntos de dados adicionados por meio do conjunto de alterações da API do Catálogo do tipo AddDataSets são padrão para o método de publicação do produto.

Para adicionar conjuntos de dados ao seu produto AWS Data Exchange, inicie um conjunto de alterações do tipo AddDataSets. Para fazer isso, você pode usar a operação da API StartChangeSet e especificar o tipo de alteração, o identificador do produto, o tipo de produto e os detalhes, incluindo o nome do recurso da Amazon (ARN) do conjunto de dados.

Tutorial: Inclusão de novos conjuntos de dados em um produto de dados publicado

Este tutorial orienta você pelas etapas detalhadas para adicionar novos conjuntos de dados do AWS Data Exchange a um produto publicado. O tutorial tem as seguintes etapas de nível avançado.

Configurar permissões do IAM

Antes de começar, você precisa de permissões do AWS Identity and Access Management (IAM) para usar a API do catálogo do AWS Marketplace. Essas permissões são adicionais às permissões necessárias para usar a AWS Data Exchange.

1. Acesse em seu navegador o console do IAM e faça login usando uma Conta da AWS que possa gerenciar permissões do IAM.

2. No painel de navegação à esquerda, escolha Políticas.

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

4. Selecione a guia JSON e forneça as seguintes permissões. Isso fornece acesso total à API do catálogo AWS Marketplace. 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 Next: Review (Próximo: revisar).

6. Forneça um nome para a política (por exemplo, CatalogAPIFullAccess) e selecione Criar política.

7. Ao usar o console do IAM, selecione usuários, grupos ou perfis para anexar a política.

Acessar a API do catálogo AWS Marketplace

Para acessar a API do catálogo AWS Marketplace, use o seguinte endpoint do cliente HTTP.

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

Obter o ID do produto no console do AWS Data Exchange

Antes de usar a API do catálogo AWS Marketplace para publicar novos conjuntos de dados, obtenha o ID do produto no console do AWS Data Exchange. Acesse o Painel do Produto e copie o ID do produto para o qual você gostaria de publicar os conjuntos de dados. Você também pode usar a API do catálogo AWS Marketplace para encontrar o ID do produto, usando a ação da ListEntities com o tipo de entidade DataProduct@1.0.

Iniciar uma solicitação de alteração

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

1. Copie o ID da entidade obtido seguindo as instruções na Obter o ID do produto no console do AWS Data Exchange.

2. Faça uma solicitação StartChangeSet com um tipo de alteração AddDataSets.

nota

Para obter informações sobre como trabalhar com conjuntos de alterações na API do Catálogo AWS Marketplace, consulte Trabalho com conjuntos de alterações. Para obter mais informações sobre como trabalhar com o identificador de entidades, consulte Identificador.

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

Após usar a operação de API StartChangeSet para iniciar a solicitação de mudança, você poderá usar a operação DescribeChangeSet para verificar seu status. Forneça o ID do conjunto de alterações retornado na resposta da API StartChangeSet.

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": []
        }
    ]
}

Exceções de AddDataSets

As seguintes exceções podem ocorrer quando você usa a API do catálogo AWS Marketplace e AWS Data Exchange:

DATA_SET_NOT_FOUND

Isso acontece quando o conjunto de dados solicitado não foi encontrado. Para resolver esse problema, verifique se há um erro de digitação no ARN do conjunto de dados e se a Conta da AWS tem o conjunto de dados, depois tente novamente.

INVALID_INPUT

A solicitação não pôde ser processada devido a uma entrada inválida. Para resolver esse problema, verifique se há erros de digitação na solicitação e se o produto excede 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_PROVIDED

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