Atualizar produtos - AWS Data Exchange Guia do usuário
Atualizar detalhes do produto e da ofertaAtualizar um dicionário de dadosAtualizar um esquemaAtualizar os metadados personalizadosPublicar nova revisão do conjunto de dadosCancelar a publicação de um produtoRemover revisãoRevogar revisões

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

Atualizar produtos

As seções a seguir descrevem como atualizar produtos no AWS Data Exchange. As instruções pressupõem que você seja um provedor que conhece o Dados em AWS Data Exchange. Após publicar um produto, você poderá editar os detalhes do produto e a oferta pública. Você também poderá atualizar os conjuntos de dados subjacentes publicando novas revisões aos assinantes. Para obter mais informações, consulte Revisões.

Atualizar detalhes do produto e da oferta

Após publicar um produto, você pode usar o console AWS Data Exchange para editar as informações dele. Você também pode editar as ofertas públicas ou personalizadas do produto e alterar os termos da oferta. Quando você atualiza os termos de oferta do produto, os assinantes com uma assinatura ativa manterão os termos de oferta existentes enquanto a assinatura estiver ativa. Os assinantes que optaram pela renovação automática usarão os novos termos da oferta.

Lembre-se do seguinte ao atualizar produtos:

  • Você não pode remover ou editar a duração de uma assinatura em suas ofertas. Isso garante que os assinantes existentes retenham a possibilidade de renovação. Para deixar de oferecer uma duração de assinatura específica, você poderá cancelar a publicação do produto existente e publicar um novo. Para obter mais informações, consulte Cancelar a publicação de um produto.

  • Você não poderá remover conjuntos de dados de um produto depois da publicação, independentemente de quantos assinantes assinaram o produto.

  • Se você estiver atualizando os custos medidos de um produto que contém APIs:

    • Uma redução no preço dos custos medidos aparece imediatamente na página de detalhes do produto para novos assinantes.

      Atenção

      Se você desfizer uma redução de preço para custos medidos, estará aumentando o preço dos custos medidos. Veja o próximo passo para obter mais informações sobre aumentos de preços de custos medidos.

    • Um aumento de preço de custos medidos entrará em vigor no primeiro dia do mês, 90 dias após o envio do aumento de preço para assinantes existentes OU após a renovação (o que ocorrer primeiro). O e-mail é enviado aos assinantes existentes quando a alteração de preço é enviada. O aumento de preço aparece imediatamente na página de detalhes do produto para novos assinantes.

      exemplo Exemplo

      Você envia um aumento de preço de custos medidos em 10 de maio. Os assinantes existentes recebem um e-mail sobre a mudança de preço. O aumento de preços entra em vigor no dia 1º de setembro.

      Atenção

      Você não pode desfazer um aumento de preço (porque essa ação diminui o preço) antes que o aumento de preço entre em vigor para os assinantes existentes.

Para atualizar detalhes de um produto, conjunto de dados ou oferta

  1. Abra o navegador e faça login no console do AWS Data Exchange.

  2. No painel de navegação à esquerda, em Publicar dados, selecione Produtos.

  3. Em Produtos, escolha o produto que deseja atualizar. Verifique se o status aparece como Publicado.

  4. Em Detalhes do produto:

    • Para editar uma oferta pública, selecione a guia Oferta pública, clique em Editar e siga as instruções para editar o produto.

    • Se estiver editando uma oferta privada, selecione a guia Ofertas personalizadas, escolha o botão de opção ao lado da oferta privada que você deseja editar, clique em Editar e siga as instruções para editar o produto.

    1. No caso de produtos que contêm APIs com custos medidos, em Custos medidos — opcional, selecione o botão de opção ao lado do Tipo de custos medidos que você deseja editar e clique em Editar.

    2. Na caixa de diálogo Editar custo medido, atualize o Preço/unidade ou Descrição.

    3. Escolha Atualizar.

      Os custos medidos atualizados aparecem em Custos medidos — opcional.

  5. Em Conjuntos de dados, em Informações confidenciais, escolha Editar e siga as instruções para editar as informações.

  6. Em Avaliação de dados, atualize o dicionário de dados ou a amostra selecionando o botão de opção ao lado do dicionário de dados ou do Nome da amostra e, em seguida, selecionando Ações. Para obter mais informações, consulte Atualizar um dicionário de dados e Atualizar um esquema.

  7. Configure sua oferta dependendo do tipo de oferta:

    • Se o seu produto for uma oferta pública, em Oferta pública, selecione Editar e siga as instruções para editar a oferta pública.

    • Se o seu produto for uma oferta personalizada, em Ofertas personalizadas, selecione Editar e siga as instruções para editar a oferta personalizada.

    • Se o seu produto for uma oferta privada, em Ofertas privadas, selecione Editar e siga as instruções para editar a oferta privada.

  8. Escolha Atualizar.

Atualizar um dicionário de dados

Você pode atualizar um dicionário de dados removendo primeiro o dicionário de dados existente e depois carregando um novo.

Para atualizar um dicionário de dados

  1. Abra o navegador e faça login no console do AWS Data Exchange.

  2. No painel de navegação à esquerda, em Publicar dados, selecione Produtos.

  3. Em Produtos, escolha o produto que você deseja atualizar e confirme se o status aparece como Publicado.

  4. Escolha a guia Avaliação de dados.

  5. Em Dicionário de dados e amostras, expanda o conjunto de dados escolhendo o ícone de adição e, em seguida, escolha o dicionário de dados selecionando o botão ao lado do Nome do dicionário de dados.

    1. Escolha Ações e, em seguida, Remover dicionário de dados.

      O dicionário de dados é removido.

    2. Selecione o botão de opção ao lado do conjunto de dados, escolha Ações e, em seguida, Fazer upload do dicionário de dados.

    3. Escolha Adicionar arquivos.

    4. Selecione um novo dicionário de dados e clique em Abrir.

    5. Escolha Upload (Carregar).

  6. (Opcional) Escolha o dicionário de dados selecionando o botão de opção ao lado do Nome do dicionário de dados, escolha Ações e selecione Fazer download do dicionário de dados (CSV) para baixar o dicionário de dados no computador.

Atualizar um esquema

Para atualizar uma regra

  1. Abra o navegador e faça login no console do AWS Data Exchange.

  2. No painel de navegação à esquerda, em Publicar dados, selecione Produtos.

  3. Em Produtos, escolha o produto que você deseja atualizar e confirme se o status aparece como Publicado.

  4. Escolha a guia Avaliação de dados.

  5. Em Dicionário de dados e amostras, selecione o botão de opção ao lado de um conjunto de dados.

  6. Escolha Ações e selecione Adicionar instância.

    1. Escolha Fazer upload de amostras.

    2. Selecione uma nova amostra do computador e selecione Abrir.

    3. Insira uma Descrição opcional e selecione Adicionar.

  7. (Opcional) Selecione o botão de opção ao lado do Nome da amostra, selecione Ações e escolha uma das seguintes ações:

    • Fazer download da amostra selecionada

    • Amostra de visualização (somente CSV)

    • Remover amostra selecionada

Atualizar os metadados personalizados

Depois de publicar um produto, você poderá usar o console do AWS Data Exchange para editar os metadados personalizados do produto.

Para atualizar os metadados personalizados

  1. Abra o navegador e faça login no console do AWS Data Exchange.

  2. No painel de navegação à esquerda, em Publicar dados, selecione Produtos.

  3. Em Produtos, escolha o produto que deseja atualizar. Verifique se o status aparece como Publicado.

  4. (Opcional) Em Assinaturas, escolha Exibir metadados personalizados, visualize os metadados e selecione Fechar.

  5. Em Assinaturas, escolha Editar metadados personalizados e siga as instruções para editar os metadados ou adicionar novos metadados.

  6. Escolha Save (Salvar).

Publicar nova revisão do conjunto de dados

O AWS Data Exchange é compatível com produtos atualizados de forma dinâmica. Os assinantes assinam o produto por um determinado período e acessam todos os conjuntos de dados publicados enquanto a assinatura estiver ativa. Por exemplo, um provedor pode fornecer um produto que contenha preços de ações de fechamentos diários dos EUA, que seriam atualizados todos os dias com os preços de fechamento do dia. Você pode criar e finalizar novas revisões que estarão disponíveis nos conjuntos de dados do seu produto ou adicionar novos conjuntos de dados ao produto.

Seu produto inclui algumas ou todas as revisões passadas e futuras como parte de uma assinatura. Para obter mais informações, consulte Regras de acesso de revisão.

No procedimento a seguir, você cria e finaliza uma nova revisão de um conjunto de dados que já foi publicado usando o console do AWS Data Exchange. A revisão do conjunto de dados é então publicada automaticamente para todos os produtos aos quais o conjunto de dados pertence. Para obter mais informações, consulte Revisões.

Importante

Um provedor pode revogar o acesso do assinante a uma revisão e, em seguida, excluir os ativos da revisão usando a API ou o console do AWS Data Exchange. Para obter mais informações, consulte Revogar revisões.

Para publicar uma nova revisão do conjunto de dados para um produto

  1. Abra o navegador e faça login no console do AWS Data Exchange.

  2. No painel de navegação à esquerda, em Publicar dados, escolha Conjuntos de dados de propriedade.

  3. Em Conjuntos de dados de propriedade, escolha o conjunto de dados que você deseja atualizar.

  4. Acesse a guia Produtos para garantir que o conjunto de dados esteja associado a um produto publicado.

  5. Na guia Revisões, escolha Criar revisão para abrir a página Criar revisão.

    1. (Opcional) Em Configurações de revisão, forneça um comentário opcional para sua revisão que descreva a finalidade da revisão.

    2. (Opcional) Em Adicionar tags — opcional, adicione tags associadas ao recurso.

    3. Escolha Criar revisão.

      A nova revisão foi criada.

  6. Na seção Trabalhos, escolha Importar do Amazon S3 ou Upload (para fazer upload do computador), dependendo se os ativos que você deseja incluir estão armazenados em um bucket do Amazon S3 de sua propriedade ou em seu computador local.

    1. Siga as instruções, dependendo da sua seleção. Um trabalho é iniciado para importar o ativo para o conjunto de dados.

    2. Após a conclusão do trabalho, o campo Estado na seção Trabalhos será atualizado para Concluído.

  7. Em Visão geral da revisão, analise a revisão e os ativos e selecione Finalizar.

A revisão foi publicada no produto e agora está disponível para assinantes.

Abordagem sugerida para dados passados publicados com o tipo de entrega Arquivos

Alguns produtos dinâmicos contêm conteúdo passado que os assinantes podem acessar. Por exemplo, se o seu produto incluir um histórico de 30 anos de preços diários de fechamento de ações dos EUA, os assinantes terão acesso a esses dados, além das atualizações dinâmicas todos os dias.

Para esses tipos de produtos que contêm um registro histórico de dados, uma prática recomendada é publicar todos os dados passados em uma única revisão do conjunto de dados. Você pode usar o comentário opcional da revisão para indicar que essa revisão é um upload único de todo o histórico de dados de uma data específica.

Se a única revisão passada tiver uma série temporal de vários objetos, considere rotular os nomes dos objetos para descrever a periodicidade dos dados subjacentes. Por exemplo, se a sua única revisão do histórico tiver 200 arquivos, cada um com uma semana de dados passados, você poderá nomear cada arquivo com uma data para a semana em que o histórico de dados começa.

Abordagens sugeridas para atualizações

Você pode atualizar de forma dinâmica os conjuntos de dados de diversas maneiras. Veja três exemplos de abordagens, todas criando uma nova revisão para cada atualização, mas o conteúdo da nova revisão é diferente.

  • Use uma nova revisão para cada atualização que contenha apenas os itens que foram alterados desde a última revisão — O tamanho da sua revisão seria menor porque apenas os itens que foram alterados são atualizados. Essa abordagem é adequada para conjuntos de dados para os quais as atualizações afetam apenas um pequeno subconjunto de dados e os assinantes se concentram apenas nos itens que foram alterados.

  • Use uma nova revisão para cada atualização que contém os dados atualizados — A nova revisão contém um arquivo atualizado completo. Todos os itens são incluídos na nova revisão, inclusive aqueles que não foram alterados desde a última revisão. Essa abordagem é conveniente para assinantes que desejam manter um único arquivo atualizado para os dados. Os assinantes exportam os ativos da revisão mais recente para o mesmo destino e substituem arquivos anteriores.

  • Use uma nova revisão para cada atualização que contenha o histórico completo e os dados atualizados — A nova revisão contém o histórico completo dos dados, incluindo o estado mais recente dos dados e o histórico das revisões anteriores. Essa abordagem requer mais armazenamento. É adequada para conjuntos de dados para os quais os assinantes estão interessados na visão abrangente mais recente do histórico dos dados, incluindo possíveis correções ou ajustes anteriores. Nessa abordagem, cada revisão é autossuficiente e fornece uma visão completa do histórico do conjunto de dados sem dependência de revisões anteriores.

Cancelar a publicação de um produto

Depois que seu produto for publicado, ele estará disponível para todos encontrarem e assinarem, com base nas configurações de visibilidade do produto. Você pode cancelar a publicação de um produto para obter algum dos seguintes resultados:

  • Remova um produto que você criou para o exercício Publicação de novo produto.

  • Limpe os recursos.

  • Remova um produto dos produtos listados publicamente no AWS Data Exchange.

  • Impeça que os assinantes renovem automaticamente seu produto.

Lembre-se do seguinte ao cancelar a publicação de um produto:

  • Você poderá cancelar a publicação de um produto sempre que quiser.

  • Se você cancelar a publicação de um produto, ele não estará mais visível no catálogo do AWS Data Exchange ou no AWS Marketplace.

  • Os assinantes com uma assinatura ativa mantêm acesso ao produto de dados até que o prazo da assinatura expire.

  • Assinaturas ativas que expiram após você cancelar a publicação do seu produto não são renovadas, mesmo que o assinante tenha habilitado a renovação automática.

  • Os assinantes existentes ainda poderão visualizar os detalhes do produto até que a assinatura expire.

Para cancelar a publicação de um produto

  1. Abra o navegador e faça login no console do AWS Data Exchange.

  2. No painel de navegação à esquerda, em Publicar dados, selecione Produtos.

  3. Em Produtos, escolha o produto que você deseja remover. Verifique se o status aparece como Publicado.

  4. Em Visão geral do produto, selecione Cancelar publicação e siga as instruções para cancelar a publicação do produto.

    Importante

    Essa ação não pode ser desfeita.

Após seguir essas etapas, o status do produto será Não publicado. Um produto não publicado não pode ser publicado novamente, mas você pode criar um novo produto (com um novo ID do produto) que tenha os mesmos conjuntos de dados, detalhes do produto e detalhes da oferta.

Remover revisão

Um provedor pode revogar o acesso do assinante a uma revisão e, em seguida, excluir os ativos da revisão usando a API ou o console do AWS Data Exchange. Para obter mais informações, consulte Revogar revisões.

Você pode editar ou excluir uma revisão depois de finalizada, mas antes de adicioná-la a um produto. Para obter mais informações, consulte os tópicos a seguir:

Revogar revisões

Como provedor, você pode revogar o acesso do assinante a uma revisão específica a qualquer momento. Essa ação normalmente é realizada pelos provedores por motivos de conformidade. A revogação de uma revisão não exclui os ativos subjacentes. Após revogar a revisão, todos os assinantes receberão uma notificação do Amazon EventBridge (anteriormente conhecido como CloudWatch Events) informando que a revisão foi revogada. Os assinantes podem então visualizar o motivo da revisão revogada no console do AWS Data Exchange. Os assinantes não podem exportar ou consultar os dados de uma revisão revogada.

Para conseguir revogar as revisões, os provedores que gerenciam as próprias políticas de IAM devem adicionar dataexchange:RevokeRevision como uma nova ação. Os provedores que usam as políticas gerenciadas do AWS Data Exchange não precisam fazer nenhuma alteração.

Depois que uma revisão for revogada, você poderá excluir os ativos da revisão usando o console ou a operação da API DeleteAsset do AWS Data Exchange.

Revogar uma revisão (AWS CLI)

Para revogar uma revisão (AWS CLI)

  1. Use o comando revoke-revision para revogar uma revisão. 

    $ aws dataexchange revoke-revision \
--data-set-id $DATA_SET_ID \
--revision-id $REVISION_ID \
--comment 'Revoking Revision Example'

{
"Id": "ab7859881EXAMPLEdd3e8a4b88fc6a8d",
"Arn": "arn:aws:dataexchange:us-east-1:427362365172:data-sets/$DATA_SET_ID/revisions/$REVISION_ID",
"Comment": "Revoking Revision Example",
"CreatedAt": "2022-03-08T18:54:20.746Z",
"UpdatedAt": "2022-03-09T20:28:53.105Z",
"DataSetId": "24d30f8446a878237c35d011e7b22d0b",
"Finalized": true,
"Revoked": true,
"RevokedAt": "2022-03-09T20:28:53.105Z",
"RevocationComment": "revoking revision example"
}

  2. Após revogar uma revisão, você poderá excluir os ativos da revisão usando a operação da API DeleteAsset do AWS Data Exchange.

Revogar uma única revisão como provedor (console)

Para revogar a revisão como provedor (console)

  1. Abra o navegador e faça login no console do AWS Data Exchange.

  2. No painel de navegação à esquerda, em Publicar dados, selecione Conjuntos de dados de propriedade.

  3. Em Conjuntos de dados de propriedade, escolha o conjunto de dados que tem a revisão que você deseja revogar.

  4. Na guia Revisões, em Revisões, escolha a revisão.

  5. Na página de revisão, em Visão geral da revisão, em Ações, selecione Revogar.

  6. Na caixa de diálogo Revogar revisão, insira uma breve descrição do motivo da revogação da revisão. Os assinantes verão a descrição.

  7. Escolha Revogar.

    O Status da revisão está definido como Revogado.

    Atenção

    Isso revoga a revisão e todos os ativos. Os assinantes podem visualizar o motivo da revogação, mas não podem acessar ou exportar os ativos. Essa ação não pode ser desfeita.

  8. Após revogar uma revisão, você poderá excluir os ativos da revisão ao acessar a página de revisão, selecionando os ativos que deseja excluir na tabela Ativos importados e, em seguida, escolher Excluir.

Para editar o motivo de uma revisão revogada, consulte Editar um motivo de revogação como provedor (console).

Revogar várias revisões como provedor (console)

Para revogar várias revisões como provedor (console)

  1. Abra o navegador e faça login no console do AWS Data Exchange.

  2. No painel de navegação à esquerda, em Publicar dados, selecione Conjuntos de dados de propriedade.

  3. Em Conjuntos de dados de propriedade, escolha o conjunto de dados que tem as revisões que você deseja revogar.

  4. Na guia Revisões, escolha até 10 revisões.

  5. Escolha Revogar.

  6. Na caixa de diálogo Revogar {x} revisões, insira uma breve descrição do motivo da revogação das revisões. Os assinantes verão a descrição. Em seguida, escolha Ressincronizar.

    O Status das revisões está definido como Revogado.

    Atenção

    Isso revoga as revisões e todos os ativos. Os assinantes podem visualizar o motivo da revogação, mas não podem acessar ou exportar os ativos. Essa ação não pode ser desfeita.

  7. Após revogar uma revisão, você poderá excluir os ativos da revisão ao acessar a página de revisão, selecionando os ativos que deseja excluir na tabela Ativos importados e, em seguida, escolher Excluir.

Para editar o motivo de uma revisão revogada, consulte Editar um motivo de revogação como provedor (console).

Editar um motivo de revogação como provedor (console)

Como provedor, você pode editar o motivo da revogação após a revisão ter sido revogada.

Para editar uma revisão de revogação como provedor (console)

  1. Abra o navegador e faça login no console do AWS Data Exchange.

  2. No painel de navegação à esquerda, para Publicar produtos de dados, selecione Conjuntos de dados de propriedade.

  3. Em Conjuntos de dados de propriedade, escolha o conjunto de dados que tem a revisão que você revogou.

  4. Na guia Revisões, escolha a revisão revogada.

  5. Na página de revisão, selecione Editar motivo da revogação.

  6. Na caixa de diálogo Editar revisão de revogação, insira uma breve descrição do motivo da revogação da revisão.

  7. Escolha Save (Salvar).

    O Status da revisão está definido como Revogado.

    O motivo de revogação atualizado é exibido na página de revisão.

Visualizar revisões revogadas como assinante (console)

Para ver uma revisão revogada como assinante (console)

  1. Abra o navegador e faça login no console do AWS Data Exchange.

  2. No painel de navegação à esquerda em Minhas assinaturas, selecione Dados autorizados.

  3. Em Produtos, escolha um produto e amplie o conjunto de dados no produto para ver uma lista de revisões.

  4. Na página do conjunto de dados, na guia Revisões, visualize se o Status da revisão aparece como (Publicada ou Revogada).

  5. Escolha uma revisão.

  6. Veja o motivo da revisão na parte superior da página de detalhes da revisão.