Publicação de produto contendo dados baseados em arquivo Publicar um produto contendo APIs Publicar um produto contendo conjuntos de dados do Amazon Redshift Publicar um produto contendo acesso a dados do Amazon S3 Publicação de um produto contendo conjuntos de dados de permissão de dados do AWS Lake Formation (Visualização)

Publicação de novo produto

Os tópicos a seguir descrevem o processo de publicação de um novo produto no AWS Data Exchange usando o console do AWS Data Exchange.

Tópicos

Publicação de produto contendo dados baseados em arquivo
Publicar um produto contendo APIs
Publicar um produto contendo conjuntos de dados do Amazon Redshift
Publicar um produto contendo acesso a dados do Amazon S3
Publicação de um produto contendo conjuntos de dados de permissão de dados do AWS Lake Formation (Visualização)

O vídeo a seguir explica mais sobre como publicar um novo produto de dados no AWS Data Exchange.

Publicação de produto contendo dados baseados em arquivo

Os tópicos a seguir descrevem o processo de criação de um conjunto de dados e publicação de um novo produto contendo dados baseados em arquivo no AWS Data Exchange usando o console do AWS Data Exchange. O processo tem as seguintes etapas:

Etapas

Etapa 1: criar ativos
Etapa 2: criar um conjunto de dados
Etapa 3: criar uma revisão
Etapa 4: importar ativos para uma revisão
Etapa 5: publicar um novo produto
Etapa 6: (Opcional) copiar um produto

Etapa 1: criar ativos

Ativos são os dados no AWS Data Exchange. Para obter mais informações, consulte Ativos.

Antes de criar e publicar um novo produto de dados baseado em arquivo, você deve:

Criar seus arquivos.

O AWS Data Exchange é compatível com todos os tipos de arquivo.
Armazene seus arquivos como objetos no Amazon Simple Storage Service (Amazon S3) ou no computador local.

Para obter mais informações sobre como armazenar arquivos no Amazon S3, consulte o Guia do usuário do Amazon S3.

Etapa 2: criar um conjunto de dados

Os conjuntos de dados no AWS Data Exchange são dinâmicos e versionados por meio de revisões, com cada revisão contendo pelo menos um ativo. Para obter mais informações, consulte Dados em AWS Data Exchange.

Para criar um conjunto de dados

Abra o navegador e faça login no console do AWS Data Exchange.
No painel de navegação à esquerda, em Publicar dados, selecione Conjuntos de dados de propriedade.
Em Conjuntos de dados de propriedade, selecione Criar conjunto de dados para abrir o assistente de Etapas de criação do conjunto de dados.
Em Selecionar tipo de conjunto de dados, selecione Arquivos.
Em Definir conjunto de dados, insira um Nome e uma Descrição para o conjunto de dados. Para obter mais informações, consulte Melhores práticas de conjunto de dados.
(Opcional) Em Adicionar tags — opcional, adicione tags.
Escolha Create data set.

Etapa 3: criar uma revisão

No procedimento a seguir, você cria uma revisão depois de criar um conjunto de dados no console do AWS Data Exchange. Para obter mais informações, consulte Revisões.

Para criar uma revisão

Na seção Visão geral do conjunto de dados da página de detalhes do conjunto de dados:
1. (Opcional) Selecione Editar nome para editar informações sobre seu conjunto de dados.
2. (Opcional) Selecione Excluir para excluir o conjunto de dados.
Na seção Revisões, selecione Criar revisão.
Em Definir revisão, forneça um comentário opcional para a revisão que descreva a finalidade dela.
(Opcional) Em Adicionar tags — opcional, adicione tags associadas ao recurso.
Escolha Criar revisão.
Revise, edite ou exclua as alterações da etapa anterior.

Etapa 4: importar ativos para uma revisão

No procedimento a seguir, você importa ativos de dados e finaliza a revisão no console do AWS Data Exchange. Para obter mais informações, consulte Ativos.

Para importar ativos para a revisão

Na seção Trabalhos da página de detalhes do conjunto de dados, selecione Importar do Amazon S3 ou Fazer upload (para fazer upload do computador), dependendo de onde os ativos de dados do conjunto de dados estão armazenados.
Siga as instruções, dependendo da sua seleção. Um trabalho é iniciado para importar o ativo para o conjunto de dados.
Depois que o trabalho for concluído, o campo Estado na seção Trabalhos será atualizado para Concluído.
Se você tiver mais dados para adicionar, repita a Etapa 1.
Em Visão geral da revisão, analise a revisão e os ativos.
Selecione Finalizar revisão.

Você finalizou com êxito a revisão do conjunto de dados.

Você pode editar ou excluir uma revisão antes de adicioná-la a um produto.

Editar revisão

Para editar a revisão depois de ter finalizado

Em Visão geral da revisão, selecione Desfinalizar.

Você verá uma mensagem informando que a revisão não está mais no estado finalizado.
Para editar a revisão, em Visão geral da revisão, selecione Ações > Editar.
Faça as alterações e selecione Atualizar.
Analise as alterações e selecione Finalizar.

Excluir revisão

Para excluir a revisão depois de ter finalizado

Em Visão geral da revisão, selecione Excluir.
Digite Delete na caixa de diálogo Excluir revisão e selecione Excluir.

Atenção

Isso exclui a revisão e todos os ativos. Esta ação não pode ser desfeita.

Etapa 5: publicar um novo produto

Depois de criar pelo menos um conjunto de dados e finalizar uma revisão com ativos, você estará pronto para publicar esse conjunto de dados como parte de um produto. Para obter mais informações, consulte Detalhes do produto. Verifique se você tem todos os detalhes necessários do produto e da oferta.

Para publicar um novo produto

No painel de navegação à esquerda do console do AWS Data Exchange, em Publicar dados, selecione Produtos.
Em Produtos, selecione Publicar novo produto para abrir o assistente Publicar novo produto.
Na seção Visibilidade do produto, escolha as Opções de visibilidade do produto e a configuração de Informações confidenciais e, em seguida, selecione Próximo. Para obter mais informações, consulte Visibilidade do produto e Categorias de informações confidenciais.
Na seção Adicionar dados, em Conjuntos de dados de propriedade, marque as caixas de seleção ao lado dos conjuntos de dados que você deseja adicionar e selecione Adicionar selecionado.

nota
Os conjuntos de dados escolhidos devem ter uma revisão finalizada. Conjuntos de dados sem revisões finalizadas não podem ser adicionados.
1. Acesse Conjuntos de dados selecionados para revisar suas seleções.
  
  Você pode revisar o Nome e o Tipo do conjunto de dados e a marcação de data e hora de quando o conjunto de dados foi Atualizado pela última vez.
2. Acesse Selecionar regras de acesso à revisão, escolha as regras de acesso à revisão que você deseja definir para conjuntos de dados incluídos no produto e selecione Próximo. Para obter mais detalhes, consulte Regras de acesso de revisão.
Na seção Definir produto, em Visão geral do produto, insira as informações sobre o produto, incluindo o Nome do produto, o Logotipo do produto, as informações de Contato do suporte e as Categorias do produto.

Para obter mais informações, consulte Detalhes do produto.
(Opcional) Na seção Definir produto, em Dicionários de dados e amostras — opcional, escolha um conjunto de dados selecionando o botão de opção ao lado do nome do conjunto de dados e selecione Editar.
1. Na caixa de diálogo Editar, em Carregar dicionário de dados, selecione Adicionar arquivo para carregar um novo dicionário de dados.
  
  Você pode escolher um dicionário de dados, em formato .csv, com tamanho máximo de 1 MB.
2. Escolha um dicionário de dados salvo no computador e selecione Abrir.
  
  O arquivo .csv do dicionário de dados aparece na caixa de diálogo Editar.
  
  nota
  O dicionário de dados deve estar em conformidade com o modelo de dicionário de dados do AWS Data Exchange. Se você não tiver um dicionário de dados salvo para fazer upload, poderá escolher o link de modelo de dicionário de dados em branco ou o link de exemplo do dicionário de dados no console do AWS Data Exchange.
3. Selecione Visualização do dicionário de dados para visualizar o dicionário de dados.
4. Em Amostras — opcional, selecione Carregar amostras, escolha uma amostra do computador e selecione Abrir.
  
  As amostras aparecem na caixa de diálogo Editar.
  
  nota
  Você pode fazer upload de até 10 amostras com tamanho máximo de 50 MB. Amostras em formato .csv podem ser visualizadas.
5. Insira uma descrição para cada amostra que ficará visível na página de detalhes do produto.
6. Escolha Save (Salvar).
Em Definição do produto, insira uma Descrição curta e uma Descrição longa do produto.

Para usar um modelo para descrição longa, selecione Aplicar modelo, escolha o tipo de modelo e preencha o modelo com os detalhes específicos do produto.
Escolha Next (Próximo).
Configure a oferta.
- Se você estiver criando uma oferta pública, na seção Adicionar oferta pública, configure a oferta. Todos os produtos AWS Data Exchange com visibilidade definida como Pública exigem uma oferta pública.
  1. Escolha as opções de Preço e duração de acesso para a assinatura.
  2. Escolha as configurações de imposto sobre vendas nos EUA, contrato de assinatura de dados (DSA) e política de reembolso.
  3. (Opcional) Defina a Verificação da assinatura, que permite controlar quem pode assinar o produto. Para obter mais informações, consulte Verificação de assinatura para provedores.
  4. Escolha sua opção de Renovação automática da oferta. Para obter mais informações, consulte Criação de oferta para produtos AWS Data Exchange.
  5. Escolha Next (Próximo).
- Se você estiver criando uma oferta privada, configure os detalhes da oferta na seção Adicionar oferta personalizada.
  1. Na seção Informações da conta do assinante, adicione pelo menos uma conta de assinante à qual deseja estender a oferta.
  2. Selecione as opções de Preço e duração de acesso para a assinatura.
  3. Escolha a Data de expiração da oferta até a qual o assinante deve aceitar a oferta.
  4. Escolha as configurações de imposto sobre vendas nos EUA, contrato de assinatura de dados (DSA) e política de reembolso.
  5. Escolha sua opção de Renovação automática da oferta. Para obter mais informações, consulte Criação de oferta para produtos AWS Data Exchange.
  6. Escolha Next (Próximo).
Na seção Revisar e publicar, revise as informações do produto e amplie a Visualização da página do produto para ver como ela ficará após a publicação.
Se tiver certeza de que deseja tornar o produto e a oferta pública visíveis e disponíveis para todos, selecione Publicar.

Agora você concluiu a parte manual da publicação de um produto de dados com uma oferta pública. O AWS Data Exchange prepara e publica o produto. Na página Visão geral do produto, o status do produto será Aguardando aprovação e, após a publicação, mudará para Publicado.

Etapa 6: (Opcional) copiar um produto

Após criar o primeiro produto, você poderá copiar os detalhes e ofertas públicas para criar um novo.

nota

Você pode copiar um produto público, privado, publicado ou não publicado. As ofertas personalizadas associadas ao produto não serão copiadas, mas as ofertas públicas serão.

Para copiar um produto

Abra o navegador e faça login no console do AWS Data Exchange.
No painel de navegação à esquerda, em Publicar dados, selecione Produtos.
Em Produtos, selecione o botão ao lado do produto que você deseja copiar.
Selecione o menu suspenso Ações e selecione Criar cópia.
Continue no fluxo de trabalho Publicar um novo produto, com os detalhes já preenchidos, com base no produto escolhido na Etapa 3. Para obter mais informações, consulte Etapa 5: publicar um novo produto.

Publicar um produto contendo APIs

Visão geral

Os tópicos a seguir descrevem o processo de criação de um conjunto de dados da API REST e de publicação de um novo produto que contém APIs no AWS Data Exchange. Você pode concluir o processo usando o console do AWS Data Exchange ou o AWS Command Line Interface.

Depois de configurar a API REST do Amazon API Gateway, você poderá criar um novo conjunto de dados de API no AWS Data Exchange. Você pode criar uma revisão e adicionar ativos de API.

A criação e publicação de um ativo de API permite que solicitações de assinantes para um endpoint do AWS Data Exchange façam proxy por meio da API do API Gateway. Você pode adicionar esse conjunto de dados a um produto e adicionar preços. Assim, o assinante poderá visualizar o produto e assinar no catálogo do AWS Marketplace no catálogo do AWS Data Exchange.

Os recursos AWS Data Exchange estão disponíveis, incluindo regras de acesso de revisão, produtos privados, ofertas privadas e verificação de assinatura.

Você pode escolher apenas preços baseados em contrato, preços de custo medidos (em que o preço do contrato é US$ 0) ou uma combinação de preços medidos e de contrato.

Você pode escolher custos medidos padrão ou especificar um custo medido personalizado. Existem três tipos de custos medidos padrão disponíveis:

Por solicitação de API
Por solicitação de API bem-sucedida
Por unidade de dados transferidos em bytes

nota

Os custos medidos se aplicam a todos os conjuntos de dados de API em um produto. Portanto, para cobrar preços diferentes pela mesma dimensão para diferentes conjuntos de dados de API, recomendamos que você crie esses conjuntos de dados em produtos diferentes.

O processo tem as seguintes etapas:

Etapas

Pré-requisitos
Etapa 1: atualizar a política de recursos da API
Etapa 2: criar um conjunto de dados de API
Etapa 3: criar uma revisão
Etapa 4: adicionar ativos da API a uma revisão
Etapa 5: publicar um novo produto contendo APIs
Etapa 6: (Opcional) copiar um produto

Pré-requisitos

Antes de poder publicar um produto contendo APIs, você deve atender aos seguintes pré-requisitos:

Antes de usar qualquer AWS service (Serviço da AWS), incluindo o AWS Data Exchange, você deve se inscrever na AWS e criar um usuário administrativo. Para obter mais informações, consulte Conceitos básicos no Guia do usuário do AWS IAM Identity Center.
Para criar produtos no AWS Data Exchange, você deve registrar a Conta da AWS como Vendedor do AWS Marketplace. Use essa conta para criar seus conjuntos de dados. A conta com o recurso API Gateway não precisa estar na mesma conta que está criando os conjuntos de dados.
A API REST deve estar no Amazon API Gateway com uma integração que use um modelo apropriado de solicitação e resposta para acessar os dados, como Amazon DynamoDB ou AWS Lambda. Para obter mais informações, consulte Desenvolvimento de uma API REST no API Gateway e Trabalho com APIs REST no Guia do desenvolvedor do Amazon API Gateway.

nota
Somente as APIs públicas do API Gateway são compatíveis.
A API REST do API Gateway deve ser capaz de autenticar e autorizar chamadas da entidade principal de serviço do AWS Data Exchange. Cada solicitação do AWS Data Exchange para sua API usa o protocolo Signature Version 4 (SigV4) assinado com credenciais do AWS Data Exchange. O AWS Data Exchange funciona com domínios personalizados e mapeamentos de chaves de domínio.

nota
O AWS Data Exchange não é compatível com Amazon Cognito, No-Auth e autorizadores do AWS Lambda.
Se a API REST do API Gateway usar um sistema de identidade personalizado para autenticação e autorização, configure para usar a autenticação do IAM e importe um esquema OpenAPI que descreva a API. O AWS Data Exchange invocará sua API REST do API Gateway com as próprias credenciais de serviço e incluirá informações do assinante, como ID da conta.
Sua API REST do API Gateway é responsável pela integração com o back-end. Para isso, execute um dos seguintes procedimentos:
- Anexe um token de autenticação de longa duração a cada solicitação que chega por meio da API REST do API Gateway que o back-end pode verificar.
- Use o API Gateway para invocar uma função do Lambda que pode gerar credenciais e invocar a API.

Sua API é invocada de acordo com a especificação da solicitação de integração da API.

Para obter informações, consulte os tópicos a seguir:

Tópicos

Segurança do conjunto de dados da API
Especificação de solicitação de integração de API
Encaminhamento de cabeçalho

Segurança do conjunto de dados da API

O AWS Data Exchange criptografa o tráfego de ponta a ponta usando Transport Layer Security (TLS) 1.2. Todos os metadados são criptografados em repouso. O AWS Data Exchange não armazenará solicitações de assinantes ou respostas do seu back-end. Extraímos apenas metadados de medição necessários para faturamento.

Especificação de solicitação de integração de API

Uma API no AWS Data Exchange passa por todos os cabeçalhos (exceto os cabeçalhos indicados em Encaminhamento de cabeçalho), corpo, método http, caminho e trilhas de caracteres de consulta como estão na solicitação do cliente e anexa os cabeçalhos a seguir.


// These headers help prevent Confused Deputy attacks.  They enable the SourceAccount
// and SourceArn variables in IAM policies.
'x-amz-source-account': ACCOUNT_ID,
'x-amz-source-arn': `arn:aws:dataexchange:${REGION}:${OWNER_ACCOUNT_ID}:data-sets/${DATA_SET_ID}/revisions/${REVISION_ID}/assets/${ASSET_ID}`,
  
// These headers identify the API Asset in Data Exchange.  
'x-amzn-dataexchange-asset-id': ASSET_ID,
'x-amzn-dataexchange-data-set-id': DATA_SET_ID,
'x-amzn-dataexchange-revision-id': REVISION_ID,

// This header identifies the Data Exchange Product.
'x-amzn-dataexchange-product-id': PRODUCT_ID,
  
// This header identifies the caller of Data Exchange.  It will contain subscriber
// information.
'x-amzn-dataexchange-requester-account-id': REQUESTER_ACCOUNT_ID,

// Providers can attach custom metadata in the form of key/value pairs
// to a particular subscription. We will send these key/value pairs as stringified
// JSON.
'x-amz-dataexchange-subscription-metadata': STRINGIFIED_METADATA,

Encaminhamento de cabeçalho

O AWS Data Exchange remove os cabeçalhos relacionados à autenticação ou com namespace para a Amazon antes de encaminhá-los para um back-end do provedor. Especificamente, o AWS Data Exchange remove:

AuthenticationCabeçalho
Qualquer cabeçalho que comece com x-amz

O cabeçalho host será substituído como consequência do proxy.

Etapa 1: atualizar a política de recursos da API

Se você tiver uma API REST do Amazon API Gateway que atenda aos Pré-requisitos, deverá atualizar a política de recursos de API para conceder ao AWS Data Exchange a capacidade de invocar a API quando um assinante fizer uma solicitação para obter o esquema da API.

Para atualizar sua política de recursos de API

Adicione a seguinte política à política de recursos da sua API:


{
"Effect": "Allow",
"Principal": {"Service": "dataexchange.amazonaws.com"},
"Action": "execute-api:Invoke",
"Resource": "*",
"Condition": {"StringEquals": {"aws:SourceAccount": "<account-id>"}}
}

Substitua o account-id pela conta que criará o conjunto de dados da API.

A conta com o recurso API Gateway não precisa estar na mesma conta que está criando o conjunto de dados.

Essa política restringe essas permissões a chamadas feitas pela entidade principal de serviço do AWS Data Exchange e exige que somente sua conta possa autorizar a integração do AWS Data Exchange com a API.

nota

Se você tiver uma política de recursos que nega explicitamente que o AWS Data Exchange faça essa invocação, você deverá remover ou limitar essa negação.

Agora, você está pronto para criar um conjunto de dados da API.

Etapa 2: criar um conjunto de dados de API

Você usa o console do AWS Data Exchange ou a AWS Command Line Interface para criar um conjunto de dados de API:

Criar um conjunto de dados de API (console)
Criação de um conjunto de dados de API (AWS CLI)

Criar um conjunto de dados de API (console)

Para criar um conjunto de dados de API (console)

Abra o navegador e faça login no console do AWS Data Exchange.
No painel de navegação esquerdo, em Meus dados, selecione Conjuntos de dados de propriedade.
Em Conjuntos de dados de propriedade, selecione Criar conjunto de dados para abrir o assistente de Etapas de criação do conjunto de dados.
Em Selecionar tipo de conjunto de dados, selecione API do Amazon API Gateway.
Em Definir conjunto de dados, insira um Nome e uma Descrição para o conjunto de dados. Para obter mais informações, consulte Melhores práticas de conjunto de dados.
(Opcional) Em Adicionar tags — opcional, adicione tags.
Escolha Create (Criar).

Agora você está pronto para criar uma revisão.

Criação de um conjunto de dados de API (AWS CLI)

Para criar um conjunto de dados de API (CLI)

Use o comando create-data-set para criar um conjunto de dados de API:


$ aws dataexchange create-data-set \
--asset-type API_GATEWAY_API \
--description 'Data Set Description' \
--name 'Data Set Name'

{
"Arn": "arn:aws:dataexchange:us-east-1:123456789012:data-sets/$DATA_SET_ID",
"AssetType": "API_GATEWAY_API",
"CreatedAt": "2021-09-11T00:16:46.349000+00:00",
"Description": "Data Set Description",
"Id": "$DATA_SET_ID",
"Name": "Data Set Name",
"Origin": "OWNED",
"UpdatedAt": "2021-09-11T00:16:46.349000+00:00"
}

Observe o novo tipo de ativo de API_GATEWAY_API.

Agora você está pronto para criar uma revisão.

Etapa 3: criar uma revisão

No procedimento a seguir, você cria uma revisão depois de criar um conjunto de dados. Para obter mais informações, consulte Revisões.

Você usa o console do AWS Data Exchange ou a AWS Command Line Interface para criar uma revisão:

Criação de revisão (console)
Criação de revisão (AWS CLI)

Criação de revisão (console)

Para criar uma revisão (console)

Na seção Visão geral do conjunto de dados da página de detalhes do conjunto de dados:
1. (Opcional) Selecione Editar nome para editar informações sobre seu conjunto de dados.
2. (Opcional) Selecione Excluir para excluir o conjunto de dados.
Na seção Revisões, selecione Criar revisão.
Em Definir revisão, forneça um comentário opcional para sua revisão que descreva a finalidade da revisão.
(Opcional) Em Adicionar tags — opcional, adicione tags associadas ao recurso.
Escolha Criar revisão.
Revise, edite ou exclua as alterações da etapa anterior.

Agora você pode adicionar ativos de API à revisão.

Criação de revisão (AWS CLI)

Para criar uma revisão (AWS CLI)

Use o comando create-revision para criar uma revisão:


$ aws dataexchange create-revision \
--data-set-id $DATA_SET_ID \
--comment 'First Atlas Revision'
{
"Arn": "arn:aws:dataexchange:us-east-1:123456789012:data-sets/$DATA_SET_ID/revisions/$REVISION_ID",
"Comment": "First Atlas Revision",
"CreatedAt": "2021-09-11T00:18:49.160000+00:00",
"DataSetId": "$DATA_SET_ID",
"Finalized": false,
"Id": "$REVISION_ID",
"UpdatedAt": "2021-09-11T00:18:49.160000+00:00"
}

Adicione os ativos da API à revisão.

nota
Você precisará saber o ID da API REST do API Gateway que deseja importar, bem como o estágio.

Etapa 4: adicionar ativos da API a uma revisão

Os ativos de API contêm as informações de que os assinantes precisam para fazer chamadas para sua API. Para obter mais informações, consulte Ativos.

No procedimento a seguir, você importa ativos de dados e finaliza a revisão.

Você usa o console do AWS Data Exchange ou a AWS CLI para adicionar ativos a uma revisão:

Adicionar ativos de API a uma revisão (console)
Adicionar ativos de API a uma revisão (AWS CLI)

Adicionar ativos de API a uma revisão (console)

Para adicionar ativos à revisão (console)

Na seção Ativos da API da página de detalhes do conjunto de dados, selecione Adicionar estágio da API.
Em Selecionar estágio da API, para a API do Amazon API Gateway, insira uma API na caixa de entrada ou escolha uma das seguintes opções na lista suspensa:
- API em outra Conta da AWS — essa é uma API de várias contas que você recebeu permissão para acessar.
- Nesta Conta da AWS — esta é uma API na Conta da AWS.
1. Se você escolheu API em outra Conta da AWS, insira o ID da API e o Nome do estágio da API nas caixas de entrada.
2. Se você escolher Nesta Conta da AWS, selecione o Nome do estágio da API na lista suspensa
nota
Você pode criar um novo estágio de API escolhendo Criar novo e seguindo as etapas no modal Criar nova API no Amazon API Gateway. Depois que o novo estágio for criado, repita a Etapa 2.
Em Configuração avançada — opcional, você pode escolher Conectar o plano de uso existente do Amazon API Gateway para usar o controle de utilização e cota, conforme definido no plano de uso existente, e inserir a chave da API.
Em API de documentos para assinantes, forneça detalhes sobre a API que os assinantes verão depois de assinarem o produto.
1. Em Nome da API, insira um nome que os assinantes possam usar para identificar o ativo da API.
  
  nota
  Se uma Nesta Conta da AWS for selecionada, o Nome da API será preenchido automaticamente, e você poderá modificar se necessário.
  Se uma API em outra Conta da AWS for selecionada, o Nome da API será preenchido com um nome padrão, que você deve modificar para que o assinante possa entender facilmente o que é.
2. Para a especificação OpenAPI 3.0:
  1. Insira ou copie e cole o arquivo de especificação OpenAPI 3.0.
  2. Selecione Importar do arquivo.JSON e selecione o arquivo.json do seu computador local para importar.
    
    A especificação importada aparece na caixa.
  3. Selecione Importar do Amazon API Gateway e selecione uma especificação para importar.
    
    A especificação importada aparece na caixa.
3. Em Documentação adicional — opcional, insira qualquer informação adicional que seja útil para o assinante saber sobre a API. O Markdown é compatível.
nota
Você não poderá editar a especificação OpenAPI e a documentação adicional depois de adicionar esse ativo a uma revisão.
Se desejar atualizar essas informações e a revisão não for finalizada, você poderá substituir o ativo.
Se quiser atualizar essas informações e a revisão estiver finalizada, você poderá fazer uma nova revisão com o ativo atualizado.
Selecione Adicionar estágio de API.

Um trabalho é iniciado para importar o ativo (neste caso, a API) para o conjunto de dados.

nota
Se não tiver uma API no Amazon API Gateway, você será solicitado a criar uma.
Depois que o trabalho for concluído, o campo Estado na seção Trabalhos será atualizado para Concluído.
Se você tiver mais APIs para adicionar, repita a Etapa 2.
Em Visão geral da revisão, analise a revisão e os ativos.
Selecione Finalizar.

Você finalizou com sucesso uma revisão para um conjunto de dados.

Você pode editar ou excluir uma revisão antes de adicioná-la a um produto.

Agora você já pode publicar um novo produto de dados de API.

Adicionar ativos de API a uma revisão (AWS CLI)

Você pode adicionar ativos de API executando um trabalho IMPORT_ASSET_FROM_API_GATEWAY_API.

Para adicionar ativos de API a uma revisão (AWS CLI):

Use o comando create-job para adicionar ativos de API à revisão:


$ aws dataexchange create-job \
  --type IMPORT_ASSET_FROM_API_GATEWAY_API \
  --details '{"ImportAssetFromApiGatewayApi":{"DataSetId":"$DATA_SET_ID","RevisionId":"$REVISION_ID","ApiId":"$API_ID","Stage":"$API_STAGE","ProtocolType":"REST"}}'
{
    "Arn": "arn:aws:dataexchange:us-east-1:123456789012:jobs/$JOB_ID",
    "CreatedAt": "2021-09-11T00:38:19.875000+00:00",
    "Details": {
        "ImportAssetFromApiGatewayApi": {
            "ApiId": "$API_ID",
            "DataSetId": "$DATA_SET_ID",
            "ProtocolType": "REST",
            "RevisionId": "$REVISION_ID",
            "Stage": "$API_STAGE"
        }
    },
    "Id": "$JOB_ID",
    "State": "WAITING",
    "Type": "IMPORT_ASSET_FROM_API_GATEWAY_API",
    "UpdatedAt": "2021-09-11T00:38:19.875000+00:00"
}

$ aws dataexchange start-job --job-id $JOB_ID
$ aws dataexchange get-job --job-id $JOB_ID
{
    "Arn": "arn:aws:dataexchange:us-east-1:0123456789012:jobs/$JOB_ID",
    "CreatedAt": "2021-09-11T00:38:19.875000+00:00",
    "Details": {
        "ImportAssetFromApiGatewayApi": {
            "ApiId": "$API_ID",
            "DataSetId": "$DATA_SET_ID",
            "ProtocolType": "REST",
            "RevisionId": "$REVISION_ID",
            "Stage": "$API_STAGE"
            "ApiEndpoint": "string",
            "ApiKey": "string",
            "ApiName": "string",            
            "ApiDescription": "string",
            "ApiSpecificationDownloadUrl": "string",
            "ApiSpecificationDownloadUrlExpiresAt": "string"
        }
    },
    "Id": "$JOB_ID",
    "State": "COMPLETED",
    "Type": "IMPORT_ASSET_FROM_API_GATEWAY_API",
    "UpdatedAt": "2021-09-11T00:38:52.538000+00:00"
}

Use o comando list-revision-assets para confirmar se o novo ativo foi criado corretamente:


$ aws dataexchange list-revision-assets \
  --data-set-id $DATA_SET_ID \
  --revision-id $REVISION_ID
{
    "Assets": [
    {
        "Arn": "arn:aws:dataexchange:us-east-1:123456789012:data-sets/$DATA_SET_ID/revisions/$REVISION_ID/assets/$ASSET_ID",
        "AssetDetails": {
            "ApiGatewayApiAsset": {
                "ApiEndpoint": "https://$API_ID.execute-api.us-east-1.amazonaws.com/$API_STAGE",
                "ApiId": "$API_ID",
                "ProtocolType": "REST",
                "Stage": "$API_STAGE"
            }
        },
        "AssetType": "API_GATEWAY_API",
        "CreatedAt": "2021-09-11T00:38:52.457000+00:00",
        "DataSetId": "$DATA_SET_ID",
        "Id": "$ASSET_ID",
        "Name": "$ASSET_ID/$API_STAGE",
        "RevisionId": "$REVISION_ID",
        "UpdatedAt": "2021-09-11T00:38:52.457000+00:00"
    }
    ]
}

Agora você já pode para publicar o produto de dados da API.

Editar revisão

Para editar a revisão depois de finalizá-la

Na Visão geral da revisão, selecione Desfinalizar.

Você verá uma mensagem informando que a revisão não está mais no estado finalizado.
Para editar a revisão, em Visão geral da revisão, selecione Ações > Editar.
Faça as alterações e selecione Atualizar.
Analise as alterações e selecione Finalizar.

Excluir revisão

Para excluir a revisão depois de finalizá-la

Na Visão geral da revisão, selecione Excluir.
Digite Delete na caixa de diálogo Excluir revisão e selecione Excluir.

Atenção

Isso exclui a revisão e todos os ativos. Esta ação não pode ser desfeita.

Etapa 5: publicar um novo produto contendo APIs

Depois de criar pelo menos um conjunto de dados e finalizar uma revisão com ativos, você poderá publicar esse conjunto de dados como parte de um produto. Para obter mais informações, consulte Detalhes do produto. Verifique se você tem todos os detalhes necessários sobre seu produto e oferta.

Você usa o console AWS Data Exchange ou a API do catálogo do AWS Marketplace para publicar um novo produto contendo APIs. Para obter mais informações sobre como publicar um novo produto usando a API do catálogo do AWS Marketplace, consulte Usar AWS Data Exchange com a API do catálogo AWS Marketplace.

Publicação de um novo produto contendo APIs (console)

Publicação de um novo produto contendo APIs (console)

Para publicar um novo produto contendo APIs

No painel de navegação à esquerda do console do AWS Data Exchange, em Publicar dados, selecione Produtos.
Em Produtos, selecione Publicar novo produto para abrir o assistente Publicar novo produto.
Em Visibilidade do produto:
1. Selecione as Opções de visibilidade do produto como Públicas ou Privadas.
  
  Todos os produtos AWS Data Exchange com visibilidade definida como Pública exigem uma oferta pública.
  
  Para obter mais informações, consulte Visibilidade do produto.
2. Selecione a configuração de Informações confidenciais do seu produto.
  
  Para obter mais informações, consulte Categorias de informações confidenciais.
3. Escolha Next (Próximo).
Em Adicionar dados:
1. Em Conjuntos de dados de propriedade, marque as caixas de seleção ao lado dos conjuntos de dados que você deseja adicionar e selecione Adicionar selecionado.
  
  nota
  Os conjuntos de dados escolhidos devem ter uma revisão finalizada. Conjuntos de dados sem revisões finalizadas não são adicionados.
2. Acesse Conjuntos de dados selecionados para revisar as seleções.
  
  Você pode revisar o Nome do conjunto de dados, o Tipo de conjunto de dados e a marcação de data e hora de quando o conjunto de dados foi Atualizado pela última vez.
3. Acesse Selecionar regras de acesso à revisão e escolha as regras de acesso à revisão que você deseja definir para conjuntos de dados incluídos neste produto.
  
  Para obter mais informações, consulte Regras de acesso de revisão.
4. Escolha Next (Próximo).
Em Definir produto:
1. Em Visão geral do produto, insira as informações sobre o produto, incluindo o Nome do produto, o Logotipo do produto, as informações de Contato do suporte e as Categorias do produto.
  
  Para obter mais informações, consulte Detalhes do produto.
2. (Opcional) Em Dicionários de dados e amostras — opcional, escolha um conjunto de dados selecionando o botão de opção próximo ao nome do conjunto de dados e selecione Editar.
  1. Na caixa de diálogo Editar, selecione Carregar para carregar um novo dicionário de dados.
    
    Você pode escolher um dicionário de dados, em formato .csv, com tamanho máximo de 1 MB.
  2. Escolha um dicionário de dados salvo em seu computador e selecione Abrir.
    
    O arquivo .csv do dicionário de dados aparece na caixa de diálogo Editar.
    
    nota
    O dicionário de dados deve estar em conformidade com o modelo de dicionário de dados do AWS Data Exchange. Se você não tiver um dicionário de dados salvo para fazer upload, poderá escolher o link de modelo de dicionário de dados em branco ou o link de dicionário de dados de exemplos no console do AWS Data Exchange.
  3. Selecione Visualização do dicionário de dados para visualizar o dicionário.
  4. Em Amostras — opcional, selecione Carregar amostras, escolha uma amostra do computador e selecione Abrir.
    
    As amostras aparecem na caixa de diálogo Editar.
    
    nota
    Você pode fazer upload de até 10 amostras com tamanho máximo de 50 MB. Amostras em formato .csv podem ser visualizadas.
  5. Insira uma descrição para cada amostra que ficará visível na página de detalhes do produto.
  6. Escolha Save (Salvar).
Em Definição do produto, insira uma Descrição curta e uma Descrição longa do produto.

Para usar um modelo para descrição longa, selecione Aplicar modelo, escolha o tipo de modelo e preencha o modelo com os detalhes específicos do produto.
Escolha Next (Próximo).
Configure a oferta em Adicionar oferta pública (para oferta pública) ou Adicionar oferta personalizada (para ofertas privadas):

Todos os produtos AWS Data Exchange com visibilidade definida como Pública exigem uma oferta pública.
1. Apenas para ofertas privadas:
  1. Escolha um dos Tipos de oferta informados: Oferta privada, Oferta privada renovada ou Traga sua própria assinatura (BYOS).
  2. Na seção Informações da conta do assinante, adicione pelo menos uma conta de assinante à qual deseja estender a oferta.
2. Escolha as opções de Preço e duração de acesso para a assinatura.
3. Em Custos medidos — opcional, selecione Adicionar.
  1. Em Adicionar custo medido, selecione o tipo de custo da chamada de API na lista Tipo:
    - Por solicitação de API
    - Por solicitação de API bem-sucedida
    - Por unidade de dados transferidos em bytes
    - Novo custo medido personalizado
  2. Insira ou atualize o Nome de exibição do custo, que fica visível na fatura do assinante.
  3. Caso você esteja usando um Custo medido predefinido, a Chave é gerada automaticamente, não pode ser editada e não precisa ser enviada de volta ao cabeçalho da resposta.
  4. Caso você esteja criando um Novo custo medido personalizado, insira a Chave, que é o identificador do custo medido no cabeçalho de resposta da API (máximo de 15 caracteres).
    
    Essa Chave deve ser enviada de volta como parte do cabeçalho da respostax-amz-dataexchange-metering.
    
    exemplo Chave personalizada
    Se você tiver uma chave personalizada chamada VertexCount e outra chave personalizada chamada EdgeCount, o cabeçalho de resposta “x-amz-dataexchange-metering” poderá ter um valor de VertexCount=3,EdgeCount=10 ou você poderá gerar duas linhas de cabeçalho separadas:
    x-amz-dataexchange-metering: VertextCount=3
    x-amz-dataexchange-metering: EdgeCount=10
  5. Insira o preço que o assinante será cobrado por unidade em Preço/unidade.
  6. (Opcional) Insira o número de unidades para exibir um exemplo do custo na Calculadora de custo medido.
  7. (Opcional) Insira uma breve Descrição do custo medido que aparece na página de detalhes do produto.
  8. Escolha Adicionar.
  9. (Opcional) Repita o procedimento para adicionar mais custos medidos.
    
    A ordem dos custos medidos aparece na página de detalhes do produto. Não é possível reordená-los.
    
    nota
    Após a criação da oferta, você poderá editar o preço e a descrição de um custo medido. Para obter mais informações, consulte Atualizar detalhes do produto e da oferta.
4. Somente para ofertas privadas, escolha a Data de expiração da oferta até a qual o assinante deve aceitar a oferta.
5. Escolha as Configurações fiscais, Contrato de assinatura de dados (DSA) e Política de reembolso.
6. (Opcional) Somente para ofertas públicas, defina a Verificação da assinatura, que permite controlar quem pode assinar o produto. Para obter mais informações, consulte Verificação de assinatura para provedores.
7. Escolha sua opção de Renovação automática da oferta. Para obter mais informações, consulte Criação de oferta para produtos AWS Data Exchange.
8. Escolha Next (Próximo).
Na seção Revisar e publicar, revise as informações do produto.
1. Amplie a Visualização da página do produto para ver como a página do produto ficará após a publicação.
2. (Opcional) Clique no botão Editar em qualquer seção para editar a seção.
Se tiver certeza de que deseja tornar o produto e a oferta pública visíveis e disponíveis para todos, selecione Publicar.

Agora você concluiu a parte manual da publicação de um produto de dados com uma oferta pública. O AWS Data Exchange prepara e publica o produto.

Na página Visão geral do produto, o status do produto será Aguardando aprovação e, após a publicação, mudará para Publicado.

Etapa 6: (Opcional) copiar um produto

Após criar o primeiro produto, você poderá copiar os detalhes e ofertas públicas para criar um novo.

nota

Você pode copiar um produto público, privado, publicado ou não publicado. As ofertas personalizadas associadas ao produto não serão copiadas, mas as ofertas públicas serão.

Para copiar um produto

Abra o navegador e faça login no console do AWS Data Exchange.
No painel de navegação à esquerda, em Publicar dados, selecione Produtos.
Em Produtos, selecione o botão ao lado do produto que você deseja copiar.
Selecione o menu suspenso Ações e selecione Criar cópia.
Continue no fluxo de trabalho Publicar um novo produto, com os detalhes já preenchidos, com base no produto escolhido na Etapa 3. Para obter mais informações, consulte Etapa 5: publicar um novo produto.

Publicar um produto contendo conjuntos de dados do Amazon Redshift

Visão geral

Um conjunto de dados do Amazon Redshift contém unidade de compartilhamento de dados AWS Data Exchange para o Amazon Redshift. Quando clientes assinam um produto que contém unidades de compartilhamento de dados, recebem acesso de somente leitura às tabelas, visualizações, esquemas e funções definidas pelo usuário que um provedor de dados adiciona à unidade de compartilhamento de dados.

Como provedor de dados, você cria um AWS Data Exchange para a unidade de compartilhamento de dados do Amazon Redshift no cluster. Em seguida, você adiciona à unidade de compartilhamento de dados os esquemas, tabelas, visualizações e funções definidas pelo usuário que deseja que os assinantes acessem. Depois, você importa a unidade de compartilhamento de dados para o AWS Data Exchange, cria um conjunto de dados, adiciona-o a um produto e publica o produto. Os assinantes recebem acesso à unidade de compartilhamento de dados mediante assinatura.

Depois de configurar a unidade de compartilhamento de dados do Amazon Redshift no Amazon Redshift, você poderá criar um novo conjunto de dados do Amazon Redshift no AWS Data Exchange. Você pode então criar uma revisão e adicionar ativos de unidade de compartilhamento de dados do Amazon Redshift. Isso permite que solicitações ao endpoint do AWS Data Exchange façam proxy por meio da unidade de compartilhamento de dados do Amazon Redshift. Você pode adicionar esse conjunto de dados a um produto e adicionar preços. Assim, os possíveis assinantes poderão visualizar o produto e assinar no catálogo do AWS Data Exchange.

Os tópicos a seguir descrevem o processo de criação de um conjunto de dados do Amazon Redshift e de publicação de um novo produto com conjuntos de dados do Amazon Redshift usando o console do AWS Data Exchange. O processo tem as seguintes etapas:

Etapas

Etapa 1: criar um ativo de unidade de compartilhamento de dados do Amazon Redshift
Etapa 2: criar um conjunto de dados do Amazon Redshift
Etapa 3: criar uma revisão
Etapa 4: adicionar ativos de unidade de compartilhamento de dados do Amazon Redshift a uma revisão
Etapa 5: publicar um novo produto contendo conjuntos de dados do Amazon Redshift
Etapa 6: (Opcional) copiar um produto

Etapa 1: criar um ativo de unidade de compartilhamento de dados do Amazon Redshift

Ativos são os dados no AWS Data Exchange. Para obter mais informações, consulte Ativos.

Para criar um ativo de unidade de compartilhamento de dados do Amazon Redshift

Crie uma unidade de compartilhamento de dados no cluster do Amazon Redshift.

Para obter mais informações sobre como criar uma unidade de compartilhamento de dados, consulte Trabalhar com unidade de compartilhamento de dados do AWS Data Exchange como produtor no Guia do desenvolvedor de banco de dados do Amazon Redshift.

nota
Recomendamos definir a unidade de compartilhamento de dados como acessível publicamente. Caso contrário, os clientes com clusters acessíveis ao público não poderão consumir seus dados.
Etapa 2: criar um conjunto de dados do Amazon Redshift.

Etapa 2: criar um conjunto de dados do Amazon Redshift

Um conjunto de dados do Amazon Redshift inclui unidades de compartilhamento de dados do AWS Data Exchange para o Amazon Redshift. Para obter mais informações, consulte Conjunto de dados do Amazon Redshift.

Para criar um conjunto de dados do Amazon Redshift

Abra o navegador e faça login no console do AWS Data Exchange.
No painel de navegação à esquerda, em Publicar dados, selecione Conjuntos de dados de propriedade.
Em Conjuntos de dados de propriedade, selecione Criar conjunto de dados para abrir o assistente de Etapas de criação do conjunto de dados.
Em Selecionar tipo de conjunto de dados, selecione unidade de compartilhamento de dados do Amazon Redshift.
Em Definir conjunto de dados, insira um Nome e uma Descrição para seu conjunto de dados. Para obter mais informações, consulte Melhores práticas de conjunto de dados.
Em Adicionar tags — opcional, adicione tags.
Escolha Create (Criar).

Etapa 3: criar uma revisão

No procedimento a seguir, você cria uma revisão depois de criar um conjunto de dados no console do AWS Data Exchange. Para obter mais informações, consulte Revisões.

Para criar uma revisão

Na seção Visão geral do conjunto de dados da página de detalhes do conjunto de dados:
1. (Opcional) Selecione Editar nome para editar informações sobre seu conjunto de dados.
2. (Opcional) Selecione Excluir para excluir o conjunto de dados.
Na seção Revisões, selecione Criar revisão.
Em Definir revisão, forneça um comentário opcional para a revisão que descreva a finalidade dela.
Em Adicionar tags — opcional, adicione tags associadas ao recurso.
Escolha Create (Criar).
Revise, edite ou exclua as alterações da etapa anterior.

Etapa 4: adicionar ativos de unidade de compartilhamento de dados do Amazon Redshift a uma revisão

No procedimento a seguir, você adiciona ativos da unidade de compartilhamento de dados do Amazon Redshift a uma revisão e, em seguida, finaliza a revisão no console do AWS Data Exchange. Para obter mais informações, consulte Ativos.

Para adicionar ativos à revisão

Na seção de Unidades de compartilhamento de dados do AWS Data Exchange para o Amazon Redshift da página de detalhes do conjunto de dados, selecione Adicionar unidades de compartilhamento de dados.
Em Unidades de compartilhamento de dados doAWS Data Exchange para o Amazon Redshift, selecione a unidade de compartilhamento de dados e, em seguida, selecione Adicionar unidades de compartilhamento de dados.

nota
Você pode adicionar até 20 unidades de compartilhamentos de dados a uma revisão.

Um trabalho é iniciado para importar os ativos para sua revisão.
Depois que o trabalho for concluído, o campo Estado na seção Trabalhos será atualizado para Concluído.
Se você tiver mais dados para adicionar, repita a Etapa 1.
Em Visão geral da revisão, analise a revisão e os ativos.
Selecione Finalizar.

Você finalizou com êxito uma revisão de um conjunto de dados.

Você pode editar ou excluir uma revisão antes de adicioná-la a um produto.

Etapa 5: publicar um novo produto contendo conjuntos de dados do Amazon Redshift

Depois de criar pelo menos um conjunto de dados e finalizar uma revisão com ativos, você estará pronto para publicar um produto com conjuntos de dados do Amazon Redshift. Para obter mais informações, consulte Detalhes do produto. Verifique se você tem todos os detalhes necessários sobre o produto e a oferta.

Para publicar um novo produto contendo conjuntos de dados do Amazon Redshift

No painel de navegação à esquerda do console do AWS Data Exchange, em Publicar dados, selecione Produtos.
Em Produtos, escolha Publicar novo produto para abrir o assistente Publicar novo produto.
Na seção Visibilidade do produto, escolha as Opções de visibilidade do produto e a configuração de Informações confidenciais e, em seguida, selecione Próximo. Para obter mais informações, consulte Visibilidade do produto e Categorias de informações confidenciais.
Na seção Adicionar dados, em Conjuntos de dados de propriedade, marque as caixas de seleção ao lado dos conjuntos de dados que você deseja adicionar e selecione Adicionar selecionado.

nota
Os conjuntos de dados escolhidos devem ter uma revisão finalizada. Conjuntos de dados sem revisões finalizadas não serão adicionados.
1. Acesse Conjuntos de dados selecionados para revisar suas seleções.
  
  Você pode revisar o Nome e o Tipo do conjunto de dados e a marcação de data e hora de quando o conjunto de dados foi Atualizado pela última vez.
2. Acesse Selecionar regras de acesso à revisão, escolha as regras de acesso à revisão que você deseja definir para conjuntos de dados incluídos no produto e selecione Próximo.
  
  Para obter mais detalhes, consulte Regras de acesso de revisão.
Na seção Definir produto, em Visão geral do produto, insira as informações sobre o produto, incluindo o Nome do produto, o Logotipo do produto, as informações de Contato do suporte e as Categorias do produto.

Para obter mais informações, consulte Detalhes do produto.
(Opcional) Na seção Definir produto, em Dicionários de dados e amostras — opcional, escolha um conjunto de dados selecionando o botão de opção próximo ao nome do conjunto de dados e escolha Editar.

Para obter mais informações, consulte Dicionário de dados e Amostras.
1. Na caixa de diálogo Editar, em Fazer upload de dicionário de dados, selecione Adicionar arquivo para fazer upload de um novo dicionário de dados.
  
  Você pode escolher um dicionário de dados, em formato .csv, com tamanho máximo de 1 MB.
2. Escolha um dicionário de dados salvo em seu computador e selecione Abrir.
  
  O arquivo .csv do dicionário de dados aparece na caixa de diálogo Editar.
  
  nota
  O dicionário de dados deve estar em conformidade com o modelo de dicionário de dados do AWS Data Exchange. Se você não tiver um dicionário de dados salvo para fazer upload, poderá escolher o link de modelo de dicionário de dados em branco ou o link de exemplo do dicionário de dados no console do AWS Data Exchange.
3. Selecione Visualização do dicionário de dados para visualizar o dicionário de dados.
4. Em Amostras — opcional, selecione Carregar amostras, escolha uma amostra do computador e selecione Abrir.
  
  As amostras aparecem na caixa de diálogo Editar.
  
  nota
  Você pode fazer upload de até 10 amostras com tamanho máximo de 50 MB. Amostras em formato .csv podem ser visualizadas.
5. Insira uma descrição para cada amostra que ficará visível na página de detalhes do produto.
6. Escolha Save (Salvar).
Em Definição do produto, insira uma Descrição curta e uma Descrição longa do produto.

Para usar um modelo para descrição longa, selecione Aplicar modelo, escolha o tipo de modelo e preencha o modelo com os detalhes específicos do produto.
Escolha Next (Próximo).
Configure a oferta.
- Se você estiver criando uma oferta pública, configure a oferta na seção Adicionar oferta pública. Todos os produtos AWS Data Exchange com visibilidade definida como Pública exigem uma oferta pública.
  1. Escolha as opções de Preço e duração de acesso para a assinatura.
  2. Escolha as configurações de imposto sobre vendas nos EUA, contrato de assinatura de dados (DSA) e política de reembolso.
  3. (Opcional) Defina a Verificação da assinatura, que permite controlar quem pode assinar o produto. Para obter mais informações, consulte Verificação de assinatura para provedores.
  4. Escolha sua opção de Renovação automática da oferta. Para obter mais informações, consulte Criação de oferta para produtos AWS Data Exchange.
  5. Escolha Next (Próximo).
- Se você estiver criando uma oferta privada, configure os detalhes da oferta na seção Adicionar oferta personalizada.
  1. Na seção Informações da conta do assinante, adicione pelo menos uma conta de assinante à qual deseja estender a oferta.
  2. Selecione as opções de Preço e duração de acesso para a assinatura.
  3. Escolha a Data de expiração da oferta até a qual o assinante deve aceitar a oferta.
  4. Escolha as configurações de imposto sobre vendas nos EUA, contrato de assinatura de dados (DSA) e política de reembolso.
  5. Escolha sua opção de Renovação automática da oferta. Para obter mais informações, consulte Criação de oferta para produtos AWS Data Exchange.
  6. Escolha Next (Próximo).
Na seção Revisar e publicar, revise as informações do produto e amplie a Visualização da página do produto para ver como ela ficará após a publicação.
Se tiver certeza de que deseja tornar o produto e a oferta pública visíveis e disponíveis para todos, selecione Publicar.

Etapa 6: (Opcional) copiar um produto

Após criar o primeiro produto, você poderá copiar os detalhes e ofertas públicas para criar um novo.

nota

Você pode copiar um produto público, privado, publicado ou não publicado. As ofertas personalizadas associadas ao produto não serão copiadas, mas as ofertas públicas serão.

Para copiar um produto

Abra o navegador e faça login no console do AWS Data Exchange.
No painel de navegação à esquerda, em Publicar dados, selecione Produtos.
Em Produtos, selecione o botão ao lado do produto que você deseja copiar.
Selecione o menu suspenso Ações e selecione Criar cópia.
Continue no fluxo de trabalho Publicar um produto, com os detalhes já preenchidos, com base no produto escolhido na Etapa 3. Para obter mais informações, consulte Etapa 5: publicar um novo produto.

Publicar um produto contendo acesso a dados do Amazon S3

Visão geral

Com o AWS Data Exchange para Amazon S3, os provedores podem compartilhar acesso direto a buckets do Amazon S3 ou prefixos e objetos do Amazon S3 específicos. Os provedores também usam o AWS Data Exchange para gerenciar automaticamente assinaturas, direitos, cobranças e pagamentos.

Como provedor de dados, você pode compartilhar acesso direto a um bucket inteiro do Amazon S3 ou a prefixos e objetos do Amazon S3 específicos sem criar ou gerenciar cópias. Esses objetos compartilhados do Amazon S3 podem ser criptografados no servidor com chaves gerenciadas pelo cliente armazenadas no AWS Key Management Service (AWS KMS) ou com Chaves gerenciadas pela AWS (SSE-S3). Para obter mais informações sobre como monitorar suas chaves KMS e compreender os contextos de criptografia, consulte Gerenciamento de chaves para acesso aos dados do Amazon S3. Quando um cliente assina seus produtos de dados, o AWS Data Exchange provisiona automaticamente um ponto de acesso Amazon S3 e atualiza as políticas de recursos em seu nome para conceder aos assinantes acesso de somente leitura. Os assinantes podem usar os aliases do ponto de acesso Amazon S3 nos locais em que usam nomes de bucket do Amazon S3 para acessar dados no Amazon S3.

Quando a assinatura termina, as permissões do assinante são revogadas. Se você optar por rescindir antecipadamente o contrato com um assinante, entre em contato com o AWS Support. Você pode adicionar termos de assinatura no Contrato de Assinatura de Dados (DSA).

Antes de poder publicar um produto contendo acesso a dados do Amazon S3, você deve atender aos seguintes pré-requisitos:

Pré-requisitos

Confirme se os buckets do Amazon S3 que hospedam os dados estão configurados com a configuração imposta pelo proprietário do bucket do Amazon S3 ativada em ACLs desativadas. Para obter mais informações, consulte Controlar a propriedade de objetos e desabilitar ACLs para seu bucket, no Guia do usuário do Amazon Simple Storage Service.
Os objetos compartilhados devem estar na classe Amazon S3 Standard Storage ou ser gerenciados usando o S3 Intelligent Tiering para que os assinantes possam acessá-los com êxito. Se eles estiverem em outras classes de armazenamento ou se você tiver habilitado o Intelligent Tiering com Deep Archive, os assinantes receberão erros porque não terão permissão para RestoreObject.
Confirme se os buckets do Amazon S3 que hospedam os dados têm a criptografia desabilitada ou criptografada com chaves gerenciadas do Amazon S3 (SSE-S3) ou chaves gerenciadas pelo cliente armazenadas no AWS Key Management Service (AWS KMS).

Se estiver usando chaves gerenciadas pelo cliente, você deverá ter o seguinte:

Permissões do IAM para kms:CreateGrant nas chaves do KMS. Você pode acessar essas permissões por meio da política de chave, credenciais do IAM ou por meio de uma concessão de AWS KMS na chave KMS. Para obter mais informações sobre gerenciamento de chaves e entender como o AWS Data Exchange usa concessões do AWS KMS, consulte Criação de AWS KMS subsídios.

Para conceder acesso, adicione as permissões aos seus usuários, grupos ou perfis:

Usuários e grupos no AWS IAM Identity Center:

Crie um conjunto de permissões. Siga as instruções em Create a permission set (Criação de um conjunto de permissões) no Guia do usuário do AWS IAM Identity Center.
Usuários gerenciados no IAM com provedor de identidades:

Crie um perfil para a federação de identidades. Siga as instruções em Criar um perfil para um provedor de identidades de terceiros (federação) no Guia do usuário do IAM.
Usuários do IAM:
- Crie um perfil que seu usuário possa assumir. Siga as instruções em Creating a role for an IAM user (Criação de um perfil para um usuário do IAM) no Guia do usuário do IAM.
- (Não recomendado) Vincule uma política diretamente a um usuário ou adicione um usuário a um grupo de usuários. Siga as instruções em Adição de permissões a um usuário (console) no Guia do usuário do IAM.

Os usuários precisam de acesso programático se quiserem interagir com a AWS de fora do AWS Management Console. A forma de conceder acesso programático depende do tipo de usuário que está acessando a AWS.

Para conceder acesso programático aos usuários, selecione uma das seguintes opções:

Qual usuário precisa de acesso programático?	Para	Por
Identificação da força de trabalho (Usuários gerenciados no Centro de Identidade do IAM)	Use credenciais temporárias para assinar solicitações programáticas para a AWS CLI, os SDKs da AWS ou as APIs da AWS.	Siga as instruções da interface que deseja utilizar. Para a AWS CLI, consulte Configuração da AWS CLI para usar o AWS IAM Identity Center no AWS Command Line InterfaceGuia do usuário da . Para os SDKs da AWS, ferramentas e APIs da AWS, consulte Autenticação do Centro de Identidade do IAM no Guia de referência de ferramentas e SDKs da AWS.
IAM	Use credenciais temporárias para assinar solicitações programáticas para a AWS CLI, os SDKs da AWS ou as APIs da AWS.	Siga as instruções em Como usar credenciais temporárias com recursos da AWS no Guia do usuário do IAM.
IAM	(Não recomendado) Use credenciais de longo prazo para assinar solicitações programáticas para a AWS CLI, os SDKs da AWS ou as APIs da AWS.	Siga as instruções da interface que deseja utilizar. Para a AWS CLI, consulte Autenticação usando as credenciais de usuário do IAM no Guia do usuário da AWS Command Line Interface. Para as ferramentas e SDKs da AWS, consulte Autenticação usando as credenciais de longo prazo no Guia de referência de ferramentas e SDKs da AWS. Para as APIs da AWS, consulte Gerenciamento de chaves de acesso de usuários do IAM no Guia do usuário do IAM.

Qual usuário precisa de acesso programático?

Para

Por

Identificação da força de trabalho

(Usuários gerenciados no Centro de Identidade do IAM)

Use credenciais temporárias para assinar solicitações programáticas para a AWS CLI, os SDKs da AWS ou as APIs da AWS.

Siga as instruções da interface que deseja utilizar.

Para a AWS CLI, consulte Configuração da AWS CLI para usar o AWS IAM Identity Center no AWS Command Line InterfaceGuia do usuário da .
Para os SDKs da AWS, ferramentas e APIs da AWS, consulte Autenticação do Centro de Identidade do IAM no Guia de referência de ferramentas e SDKs da AWS.

IAM

Use credenciais temporárias para assinar solicitações programáticas para a AWS CLI, os SDKs da AWS ou as APIs da AWS.

Siga as instruções em Como usar credenciais temporárias com recursos da AWS no Guia do usuário do IAM.

IAM

(Não recomendado)

Use credenciais de longo prazo para assinar solicitações programáticas para a AWS CLI, os SDKs da AWS ou as APIs da AWS.

Siga as instruções da interface que deseja utilizar.

Para a AWS CLI, consulte Autenticação usando as credenciais de usuário do IAM no Guia do usuário da AWS Command Line Interface.
Para as ferramentas e SDKs da AWS, consulte Autenticação usando as credenciais de longo prazo no Guia de referência de ferramentas e SDKs da AWS.
Para as APIs da AWS, consulte Gerenciamento de chaves de acesso de usuários do IAM no Guia do usuário do IAM.

Veja um exemplo de política JSON que mostra como você pode adicionar à política de chave da chave KMS.



{
      "Sid": "AllowCreateGrantPermission",
      "Effect": "Allow",
      "Principal": {
"AWS": "<IAM identity who will call Dataexchange API>"             
      },
      "Action": "kms:CreateGrant",
      "Resource": "*"
}

A política a seguir mostra um exemplo de adição de política para a identidade do IAM usada.



{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Sid": "AllowCreateGrantPermission",
            "Action": [
                 "kms:CreateGrant
            ],
            "Resource": [
              <Enter KMS Key ARNs in your account>                
            ]
        }
    ]
}

nota

Chaves KMS entre contas também serão permitidas se a permissão kms:CreateGrant nas chaves KMS for obtida na etapa anterior. Se outra conta tiver a chave, você deverá ter permissões na política de chave e suas credenciais do IAM, conforme detalhado nos exemplos acima.

Verifique se você usa as chaves do KMS para criptografar objetos novos e existentes no bucket do Amazon S3 usando o recurso de chave do bucket do Amazon S3. Para obter mais informações, consulte Configurar chaves do bucket do S3 no Guia do usuário do Amazon Simple Storage Service.
- No caso de novos objetos adicionados ao bucket do Amazon S3, você pode configurar a criptografia de chave do bucket do Amazon S3 por padrão. Se os objetos existentes tiverem sido criptografados sem usar o recurso de chave do bucket do Amazon S3, esses objetos deverão ser migrados para usar a chave do bucket do Amazon S3 para criptografia.
  
  Para habilitar a chave do bucket do Amazon S3 para objetos existentes, use a operação de copy. Para obter mais informações, consulte Configurar uma chave do bucket do Amazon S3 no nível do objeto usando operações em lote.
- Chaves KMS gerenciadas pela AWS ou Chaves pertencentes à AWS não são compatíveis. Você pode migrar de um esquema de criptografia sem suporte para aqueles atualmente com suporte. Para obter mais informações, consulte Alteração da criptografia do Amazon S3 no AWS Storage Blog.

Defina os buckets do Amazon S3 que hospedam os dados para confiar em ponto de acesso de propriedade do AWS Data Exchange. Você deve atualizar essas políticas de bucket do Amazon S3 para conceder permissões do AWS Data Exchange para criar pontos de acesso Amazon S3 e conceder ou remover o acesso dos assinantes em seu nome. Se a declaração da política estiver faltando, você deverá editar a política do bucket para adicionar os locais do Amazon S3 ao seu conjunto de dados.

Um exemplo de política é mostrado abaixo. Substitua <Bucket ARN> pelo valor apropriado.


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": "*"
            },
            "Action": [
                "s3:GetObject",
                "s3:ListBucket"
            ],
            "Resource": [
                "<Bucket ARN>",
                "<Bucket ARN>/*"
            ],
            "Condition": {
                "StringEquals": {
                    "s3:DataAccessPointAccount": [
                        "337040091392",
                        "504002150500",
                        "366362662752",
                        "330489627928",
                        "291973504423",
                        "461002523379",
                        "036905324694",
                        "540564263739",
                        "675969394711",
                        "108584782536",
                        "844053218156"
                    ]
                }
            }
        }
    ]
}

Você pode delegar o compartilhamento de dados por meio do AWS Data Exchange para um bucket inteiro do Amazon S3. No entanto, você pode definir o escopo da delegação para os prefixos e objetos específicos do bucket que deseja compartilhar no conjunto de dados. Veja um exemplo de uma política com escopo definido. Substitua <Bucket ARN> e "mybucket/folder1/*" pelas próprias informações.


{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "DelegateToAdxGetObjectsInFolder1",
      "Effect": "Allow",
      "Principal": {
        "AWS": "*"
      },
      "Action": [
        "s3:GetObject"
      ],
      "Resource": [
        "arn:aws:s3:::mybucket/folder1/*"
      ],
      "Condition": {
        "StringEquals": {
          "s3:DataAccessPointAccount": [
            "337040091392",
            "504002150500",
            "366362662752",
            "330489627928",
            "291973504423",
            "461002523379",
            "036905324694",
            "540564263739",
            "675969394711",
            "108584782536",
            "844053218156"
          ]
        }
      }
    },
    {
      "Sid": "DelegateToAdxListObjectsInFolder1",
      "Effect": "Allow",
      "Principal": {
        "AWS": "*"
      },
      "Action": "s3:ListBucket",
      "Resource": "arn:aws:s3:::mybucket",
      "Condition": {
        "StringLike": {
          "s3:prefix": [
            "folder1/*"
          ]
        },
        "StringEquals": {
          "s3:DataAccessPointAccount": [
            "337040091392",
            "504002150500",
            "366362662752",
            "330489627928",
            "291973504423",
            "461002523379",
            "036905324694",
            "540564263739",
            "675969394711",
            "108584782536",
            "844053218156"
          ]
        }
      }
    }
  ]
}

Da mesma forma, para definir o escopo do acesso a apenas um único arquivo, um provedor pode usar a política a seguir.


{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "DelegateToAdxGetMyFile",
      "Effect": "Allow",
      "Principal": {
        "AWS": "*"
      },
      "Action": [
        "s3:GetObject"
      ],
      "Resource": [
        "arn:aws:s3:::mybucket/folder1/myfile"
      ],
      "Condition": {
        "StringEquals": {
          "s3:DataAccessPointAccount": [
            "337040091392",
            "504002150500",
            "366362662752",
            "330489627928",
            "291973504423",
            "461002523379",
            "036905324694",
            "540564263739",
            "675969394711",
            "108584782536",
            "844053218156"
          ]
        }
      }
    }
  ]
}

Os tópicos a seguir descrevem o processo de criação de um conjunto de dados do Amazon S3 e de publicação de um novo produto com conjuntos de dados do Amazon S3 usando o console do AWS Data Exchange. O processo tem as seguintes etapas:

Etapas

Etapa 1: criar um conjunto de dados do Amazon S3
Etapa 2: configurar o acesso aos dados do Amazon S3
Etapa 3: revisar e finalizar o conjunto de dados
Etapa 4: adicionar um conjunto de dados do Amazon S3 a um produto AWS Data Exchange
Etapa 5: publicar um novo produto contendo acesso ao Amazon S3
Etapa 6: (opcional) copiar um produto

Etapa 1: criar um conjunto de dados do Amazon S3

Para criar um conjunto de dados do Amazon S3

No painel de navegação à esquerda, em Publicar dados, selecione Conjuntos de dados de propriedade.
No painel de navegação à esquerda, em Publicar dados, selecione Conjuntos de dados de propriedade.
Em Conjuntos de dados de propriedade, selecione Criar conjunto de dados para abrir o assistente de Etapas de criação do conjunto de dados.
Em Selecionar tipo de conjunto de dados, selecione Acesso aos dados do Amazon S3.
Em Definir conjunto de dados, insira um Nome e uma Descrição para seu conjunto de dados. Para obter mais informações, consulte Melhores práticas de conjunto de dados.
(Opcional) Em Adicionar tags — opcional, adicione tags.
Selecione Criar conjunto de dados e continue.

Etapa 2: configurar o acesso aos dados do Amazon S3

Selecione os buckets do Amazon S3 ou locais de bucket do Amazon S3 que você deseja disponibilizar aos assinantes. Você pode selecionar um bucket inteiro do Amazon S3 ou especificar até cinco prefixos ou objetos em um bucket do Amazon S3. Para adicionar mais buckets do Amazon S3, você deve criar outro compartilhamento de dados do Amazon S3.

Para configurar o acesso compartilhado aos dados do Amazon S3

Na página Configurar acesso aos dados do Amazon S3, selecione Escolher locais do Amazon S3.
Em Escolher locais do Amazon S3, insira o nome do bucket do Amazon S3 na barra de pesquisa ou selecione o bucket do Amazon S3, os prefixos ou os arquivos do Amazon S3 e selecione Adicionar selecionado. Selecione Adicionar aplicativo.

nota
Recomendamos escolher uma pasta de nível superior em que a maioria dos objetos e prefixos são armazenados para que os provedores não precisem reconfigurar quais prefixos ou objetos compartilhar.
Em Detalhes da configuração, escolha a configuração do Pagamento do solicitante. Existem duas opções:
- Habilitar pagamentos do solicitante (recomendado) — Os solicitantes pagarão por todas as solicitações e transferências no bucket do Amazon S3. Recomendamos esta opção porque ela ajuda a proteger contra custos não intencionais decorrentes de solicitações e transferências de assinantes.
- Desativar pagamentos do solicitante — Você paga pelas solicitações e transferências de assinantes no bucket do Amazon S3.
  
  Para obter mais informações sobre Pagamentos do solicitante, consulte Objetos em buckets dos Pagamentos do solicitante no Guia do usuário do Amazon Simple Storage Service.
Selecione a Política de Bucket que melhor atende às suas necessidades. Selecione Geral para usar uma política de bucket para todo o bucket do Amazon S3. Essa é uma configuração única, e não é necessária configuração adicional para compartilhar prefixos ou objetos no futuro. Escolha Específico para usar uma política de bucket específica para os locais selecionados do Amazon S3. O bucket compartilhado do Amazon S3 precisa de uma política de bucket em vigor para criar um conjunto de dados de acesso a dados do Amazon S3 com êxito e não pode ter ACLs habilitadas.
1. Para desabilitar ACLs, acesse as permissões do seu bucket e defina Propriedade do objeto como Imposto pelo proprietário do bucket.
2. Para adicionar uma política de bucket, copie a instrução do bucket para a área de transferência. No console do Amazon S3, na guia de Permissões do Amazon S3, selecione Editar na seção de política do bucket, cole a política do bucket na declaração e salve as alterações.
Se o bucket do Amazon S3 contiver objetos criptografados usando chaves AWS KMS gerenciadas pelo cliente, você deverá compartilhar todas essas chaves KMS com o AWS Data Exchange. Para obter informações sobre os pré-requisitos necessários ao usar chaves KMS para criptografar objetos em seu bucket do Amazon S3, consulte Publicar um produto contendo acesso a dados do Amazon S3. Para compartilhar essas chaves KMS com o AWS Data Exchange, faça o seguinte:
1. Na página Configurar acesso a dados do Amazon S3 em Chaves KMS gerenciadas pelo cliente, selecione Escolher entre AWS KMS keys ou Inserir ARN AWS KMS key e selecione todos AWS KMS keys que estão sendo usados atualmente para criptografar os locais compartilhados do Amazon S3. O AWS Data Exchange usa essas chaves KMS para criar concessões para assinantes acessarem os locais compartilhados. Para obter mais informações, consulte Concessões no AWS KMS.
nota
O AWS KMS tem um limite de 50.000 concessões por chave KMS, incluindo concessões pré-existentes.
Revise os locais do Amazon S3, as chaves KMS selecionadas e os detalhes de configuração e selecione Salvar e continuar.

Etapa 3: revisar e finalizar o conjunto de dados

Revise e finalize o conjunto de dados recém-criado. Para criar e adicionar outro acesso a dados do Amazon S3 para compartilhar o acesso a buckets, prefixos e objetos adicionais do Amazon S3, selecione Adicionar outro acesso a dados do Amazon S3.

nota

Recomendamos isso quando for necessário compartilhar o acesso a dados hospedados em um bucket do Amazon S3 diferente daquele escolhido anteriormente no acesso inicial aos dados do Amazon S3.

Para fazer alterações antes da publicação, você pode salvar o conjunto de dados como rascunho selecionando Salvar rascunho. Em seguida, escolha Finalizar conjunto de dados para adicionar ao seu produto.

Etapa 4: adicionar um conjunto de dados do Amazon S3 a um produto AWS Data Exchange

No procedimento a seguir, você adiciona seu conjunto de dados a um produto AWS Data Exchange novo ou existente.

Para adicionar um conjunto de dados a um produto AWS Data Exchange novo ou existente

Na página Conjuntos de dados de propriedade em Visão geral do conjunto de dados, você pode Editar nome, Excluir ou Criar produto com base no conjunto de dados.
Conclua a criação do produto especificando a descrição do produto, casos de uso, metadados, preços e termos e condições.
Revise e publique o produto quando terminar.

nota
Quando um cliente assina seu produto, ele recebe permissão de acesso para ler e usar seus dados usando o ponto de acesso Amazon S3 criado em seu nome.

Etapa 5: publicar um novo produto contendo acesso ao Amazon S3

Após criar pelo menos um conjunto de dados e finalizar uma revisão com ativos, você poderá publicar um produto com acesso a dados do Amazon S3. Para obter mais informações, consulte Detalhes do produto. Verifique se você tem todos os detalhes necessários sobre seu produto e oferta.

nota

Você não precisa criar uma nova revisão ao atualizar os objetos compartilhados do Amazon S3, a menos que os locais do Amazon S3 tenham sido alterados e esses objetos não estejam acessíveis aos assinantes.

Para publicar um novo produto contendo acesso ao Amazon S3

No painel de navegação à esquerda do console do AWS Data Exchange, em Publicar dados, selecione Produtos.
Em Produtos, escolha Publicar novo produto para abrir o assistente Publicar novo produto.
Na seção Visibilidade do produto, escolha as Opções de visibilidade do produto e a configuração de Informações confidenciais e, em seguida, selecione Próximo. Para obter mais informações, consulte Visibilidade do produto e Categorias de informações confidenciais.
Na seção Adicionar dados, em Conjuntos de dados de propriedade, marque as caixas de seleção ao lado dos conjuntos de dados que você deseja adicionar e selecione Adicionar selecionado.

nota
Os conjuntos de dados escolhidos devem ter uma revisão finalizada. Conjuntos de dados sem revisões finalizadas não são adicionados.
1. Acesse Conjuntos de dados selecionados para revisar as seleções.
  
  Você pode revisar o Nome e o Tipo do conjunto de dados e a marcação de data e hora de quando o conjunto de dados foi Atualizado pela última vez.
2. Acesse Selecionar regras de acesso à revisão, escolha as regras de acesso à revisão que você deseja definir para conjuntos de dados incluídos no produto e selecione Próximo.
  
  Para obter mais detalhes, consulte Regras de acesso de revisão.
Na seção Definir produto, em Visão geral do produto, insira as informações sobre o produto, incluindo o Nome do produto, o Logotipo do produto, as informações de Contato do suporte e as Categorias do produto.

Para obter mais informações, consulte Detalhes do produto.
(Opcional) Na seção Definir produto, em Dicionários de dados e amostras — opcional, escolha um conjunto de dados selecionando o botão de opção próximo ao nome do conjunto de dados e escolha Editar.

Para obter mais informações, consulte Dicionário de dados e Amostras.
1. Na caixa de diálogo Editar, em Fazer upload de dicionário de dados, selecione Adicionar arquivo para fazer upload de um novo dicionário de dados.
  
  Você pode escolher um dicionário de dados, em formato .csv, com tamanho máximo de 1 MB.
2. Escolha um dicionário de dados salvo em seu computador e selecione Abrir.
  
  O arquivo .csv do dicionário de dados aparece na caixa de diálogo Editar.
  
  nota
  O dicionário de dados deve estar em conformidade com o modelo de dicionário de dados do AWS Data Exchange. Se você não tiver um dicionário de dados salvo para fazer upload, poderá escolher o link de modelo de dicionário de dados em branco ou o link de dicionário de dados de exemplos no console do AWS Data Exchange.
3. Selecione Visualização do dicionário de dados para visualizar o dicionário.
4. Em Amostras — opcional, selecione Carregar amostras, escolha uma amostra do computador e selecione Abrir.
  
  As amostras aparecem na caixa de diálogo Editar.
  
  nota
  Você pode fazer upload de até 10 amostras com tamanho máximo de 50 MB. Amostras em formato .csv podem ser visualizadas.
5. Insira uma descrição para cada amostra que ficará visível na página de detalhes do produto.
6. Escolha Save (Salvar).
Em Definição do produto, insira uma Descrição curta e uma Descrição longa do produto.

Para usar um modelo para descrição longa, selecione Aplicar modelo, selecione o tipo de modelo e forneça os detalhes específicos do produto no modelo.
Escolha Next (Próximo).
Configure a oferta.
- Se você estiver criando uma oferta pública, na seção Adicionar oferta pública, configure a oferta. Todos os produtos AWS Data Exchange com visibilidade definida como Pública exigem uma oferta pública.
  1. Escolha as opções de Preço e duração de acesso para a assinatura.
  2. Escolha as configurações de imposto sobre vendas nos EUA, contrato de assinatura de dados (DSA) e política de reembolso.
  3. (Opcional) Defina a Verificação da assinatura para controlar quem pode assinar o produto. Para obter mais informações, consulte Verificação de assinatura para provedores.
  4. Escolha sua opção de Renovação automática da oferta. Para obter mais informações, consulte Criação de oferta para produtos AWS Data Exchange.
  5. Escolha Next (Próximo).
- Se você estiver criando uma oferta privada, configure os detalhes da oferta na seção Adicionar oferta personalizada.
  1. Na seção Informações da conta do assinante, adicione pelo menos uma conta de assinante à qual deseja estender a oferta.
  2. Selecione as opções de Preço e duração de acesso para a assinatura.
  3. Escolha a Data de expiração da oferta até a qual o assinante deve aceitar a oferta.
  4. Escolha as configurações de imposto sobre vendas nos EUA, contrato de assinatura de dados (DSA) e política de reembolso.
  5. Escolha sua opção de Renovação automática da oferta. Para obter mais informações, consulte Criação de oferta para produtos AWS Data Exchange.
  6. Escolha Next (Próximo).
Na seção Revisar e publicar, revise as informações do produto e amplie a Visualização da página do produto para ver como ela ficará após a publicação.
Se tiver certeza de que deseja tornar o produto e a oferta pública visíveis e disponíveis para todos, selecione Publicar.

Agora você concluiu a parte manual da publicação de um produto de dados com uma oferta pública. O AWS Data Exchange prepara e publica o produto. Na página Visão geral do produto, o status do produto será Aguardando aprovação. O status mudará para Publicado após a publicação do produto.

Etapa 6: (opcional) copiar um produto

Após criar o primeiro produto, você poderá copiar os detalhes e ofertas públicas para criar um novo.

nota

Você pode copiar um produto público, privado, publicado ou não publicado. As ofertas personalizadas associadas ao produto não podem ser copiadas, mas as ofertas públicas sim.

Para copiar um produto

Abra o navegador e faça login no console do AWS Data Exchange.
No painel de navegação à esquerda, em Publicar dados, selecione Produtos.
Em Produtos, selecione a opção ao lado do produto que deseja copiar.
Selecione a lista suspensa Ações e selecione Cria cópia.
Continue no fluxo de trabalho Publicar um produto, com os detalhes já preenchidos, com base no produto escolhido na Etapa 3. Para obter mais informações, consulte Etapa 5: publicar um novo produto.

Publicação de um produto contendo conjuntos de dados de permissão de dados do AWS Lake Formation (Visualização)

Visão geral

Se você tiver interesse em publicar produtos contendo conjuntos de dados de permissão de dados AWS Lake Formation durante esta visualização, entre em contato com o AWS Support.

Um conjunto de dados de permissão de dados do AWS Lake Formation contém um conjunto de tags LF e permissões para dados gerenciados pelo AWS Lake Formation. Quando os clientes assinam um produto que contém permissões de dados do Lake Formation, eles recebem acesso somente leitura aos bancos de dados, tabelas e colunas associadas às tags LF adicionadas ao conjunto de dados.

Como provedor de dados, você começa criando tags LF no AWS Lake Formation e associando essas tags aos dados que queira disponibilizar aos assinantes. Para obter mais informações sobre como marcar seus recursos no Lake Formation, consulte Controle de acesso baseado em tags do Lake Formation no Guia do desenvolvedor do AWS Lake Formation. Em seguida, você importa essas tags LF e um conjunto de permissões de dados para o AWS Data Exchange como um ativo. Os assinantes recebem acesso aos dados associados a essas tags LF no momento da assinatura.

Os tópicos a seguir descrevem o processo de publicação de um produto contendo permissões de dados do AWS Lake Formation. O processo tem as seguintes etapas:

Etapas

Etapa 1: criar um conjunto de dados do AWS Lake Formation (Visualização)
Etapa 2: criar uma permissão de dados do AWS Lake Formation (Visualização)
Etapa 3: revisar e finalizar
Etapa 5: (opcional) criar uma revisão
Etapa 6: publicar um novo produto contendo conjuntos de dados do AWS Lake Formation (Visualização)
Considerações ao publicar um conjunto de dados de permissão de dados do AWS Lake Formation (Visualização)

Etapa 1: criar um conjunto de dados do AWS Lake Formation (Visualização)

Para criar um conjunto de dados do AWS Lake Formation

Abra o navegador e faça login no console do AWS Data Exchange.
No painel de navegação à esquerda, em Publicar dados, selecione Produtos.
Em Conjuntos de dados de propriedade, selecione Criar conjunto de dados para abrir o assistente de Etapas de criação do conjunto de dados.
Em Selecionar tipo de conjunto de dados, selecione Permissão de dados do AWS Lake Formation.
Em Definir conjunto de dados, insira um Nome e uma Descrição para seu conjunto de dados. Para obter mais informações, consulte Melhores práticas de conjunto de dados.
Em Adicionar tags — opcional, selecione Adicionar nova tag.
Selecione Criar conjunto de dados e continue.

Etapa 2: criar uma permissão de dados do AWS Lake Formation (Visualização)

O AWS Data Exchange usa tags LF para conceder permissões de dados. Selecione as tags LF associadas aos dados que deseja compartilhar para conceder permissões de assinante aos dados.

Para criar permissão de dados do AWS Lake Formation

Na página Criar permissão de dados do Lake Formation, selecione Adicionar tag LF.
Insira a Chave e selecione os Valores de tag LF.
Selecione Visualizar recurso(s) para ver como as tags LF são interpretadas.
1. Em Visualizar recurso(s), selecione seu(s) Recurso(s) do catálogo de dados associado.
  
  nota
  Verifique revogação do grupo IAMAllowedPrincipals nos seguintes recursos. Para obter mais informações, consulte Revogação de credenciais de segurança temporárias do perfil do IAM no Guia do usuário do IAM.
Analise a interpretação da expressão de tag LF na caixa de diálogo abaixo e Permissões associadas ao conjunto de dados.
Em Acesso ao serviço, selecione o perfil de serviço existente que permita ao AWS Data Exchange assumir o perfil e acessar, conceder e revogar direitos às permissões de dados do Lake Formation em seu nome. Em seguida, selecione Criar permissão de dados do Lake Formation. Para obter mais informações sobre como criar um perfil para um AWS service (Serviço da AWS), consulte Como criar um perfil para delegar permissões a um AWS service (Serviço da AWS).
Na seção Definir produto em Visão geral do produto, insira informações sobre o seu produto, incluindo o Nome do produto, o Logotipo do produto, as informações de Contato do suporte e as Categorias do produto.

Para obter mais informações, consulte Detalhes do produto.
(Opcional) Na seção Definir produto, em Dicionários de dados e amostras — opcional, escolha um conjunto de dados selecionando o botão de opção próximo ao nome do conjunto de dados e escolha Editar.

Para obter mais informações, consulte Dicionário de dados e Amostras.
1. Na caixa de diálogo Editar, em Fazer upload de dicionário de dados, selecione Adicionar arquivo para fazer upload de um novo dicionário de dados.
  
  Você pode escolher um dicionário de dados, em formato .csv, com tamanho máximo de 1 MB.
2. Escolha um dicionário de dados salvo em seu computador e selecione Abrir.
  
  O arquivo .csv do dicionário de dados aparece na caixa de diálogo Editar.
  
  nota
  O dicionário de dados deve estar em conformidade com o modelo de dicionário de dados do AWS Data Exchange. Se você não tiver um dicionário de dados salvo para fazer upload, poderá escolher o link de modelo de dicionário de dados em branco ou o link de dicionário de dados de exemplos no console do AWS Data Exchange.
3. Selecione Visualização do dicionário de dados para visualizar o dicionário.
4. Em Amostras — opcional, selecione Carregar amostras, escolha uma amostra do computador e selecione Abrir.
  
  As amostras aparecem na caixa de diálogo Editar.
  
  nota
  Você pode fazer upload de até 10 amostras com tamanho máximo de 50 MB. Amostras em formato .csv podem ser visualizadas.
5. Insira uma descrição para cada amostra que ficará visível na página de detalhes do produto.
6. Escolha Save (Salvar).
Em Definição do produto, insira uma Descrição curta e uma Descrição longa do produto.

Para usar um modelo para descrição longa, selecione Aplicar modelo, selecione o tipo de modelo e forneça os detalhes específicos do produto no modelo.
Escolha Next (Próximo).
Configure a oferta.
- Se você estiver criando uma oferta pública, na seção Adicionar oferta pública, configure a oferta. Todos os produtos AWS Data Exchange com visibilidade definida como Pública exigem uma oferta pública.
  1. Escolha as opções de Preço e duração de acesso para a assinatura.
  2. Escolha as configurações de imposto sobre vendas nos EUA, contrato de assinatura de dados (DSA) e política de reembolso.
  3. (Opcional) Defina a Verificação da assinatura para controlar quem pode assinar o produto. Para obter mais informações, consulte Verificação de assinatura para provedores.
  4. Escolha sua opção de Renovação automática da oferta. Para obter mais informações, consulte Criação de oferta para produtos AWS Data Exchange.
  5. Escolha Next (Próximo).
- Se você estiver criando uma oferta privada, configure os detalhes da oferta na seção Adicionar oferta personalizada.
  1. Na seção Informações da conta do assinante, adicione pelo menos uma conta de assinante à qual deseja estender a oferta.
  2. Selecione as opções de Preço e duração de acesso para a assinatura.
  3. Escolha a Data de expiração da oferta até a qual o assinante deve aceitar a oferta.
  4. Escolha as configurações de imposto sobre vendas nos EUA, contrato de assinatura de dados (DSA) e política de reembolso.
  5. Escolha sua opção de Renovação automática da oferta. Para obter mais informações, consulte Criação de oferta para produtos AWS Data Exchange.
  6. Escolha Next (Próximo).
Na seção Revisar e publicar, revise as informações do produto e amplie a Visualização da página do produto para ver como ela ficará após a publicação.
Se tiver certeza de que deseja tornar o produto e a oferta pública visíveis e disponíveis para todos, selecione Publicar.

Agora você concluiu a parte manual da publicação de um produto de dados com uma oferta pública. O AWS Data Exchange prepara e publica o produto. Na página Visão geral do produto, o status do produto será Aguardando aprovação. O status mudará para Publicado após a publicação do produto.

Etapa 3: revisar e finalizar

Depois de criar sua permissão de dados do AWS Lake Formation (Visualização), você poderá Revisar e Finalizar o conjunto de dados.

Para revisar e finalizar

Analise os Detalhes do conjunto de dados e as Tags na Etapa 1 para verificar a precisão.
Analise as Expressões de tag LF, Adicione outra permissão de dados do Lake Formation (opcional), Recursos do catálogo de dados associados e detalhes do trabalho.

nota
Os trabalhos são excluídos 90 dias após serem criados.
Selecione Finalizar.

Etapa 5: (opcional) criar uma revisão

Para criar uma revisão

Na seção Conjuntos de dados de propriedade, escolha o conjunto de dados ao qual você deseja adicionar uma revisão.
Escolha a guia Revisões.
Na seção Revisões, selecione Criar revisão.
Na página Permissão de dados do Revise Lake Formation, selecione Adicionar tag LF.
Revise as Permissões para Banco de dados e Tabela.
Em Acesso ao serviço, selecione um perfil de serviço existente e escolha Criar permissão de dados do Lake Formation.

Etapa 6: publicar um novo produto contendo conjuntos de dados do AWS Lake Formation (Visualização)

Depois de criar pelo menos um conjunto de dados e finalizar uma revisão com ativos, você poderá publicar um produto com conjuntos de dados do AWS Lake Formation. Para obter mais informações, consulte Detalhes do produto. Verifique se você tem todos os detalhes necessários sobre o seu produto.

Para publicar um novo produto contendo conjuntos de dados do AWS Lake Formation (Visualização)

Abra o navegador e faça login no console do AWS Data Exchange.
No painel de navegação à esquerda, em Publicar dados, selecione Produtos.
Em Produtos, selecione Publicar novo produto para abrir o assistente Publicar novo produto.
Na seção Visibilidade do produto, escolha as Opções de visibilidade do produto e a configuração de Informações confidenciais do produto e escolha Próximo. Para obter mais informações, consulte Visibilidade do produto e Categorias de informações confidenciais.
Na seção Adicionar dados, em Conjuntos de dados de propriedade, marque as caixas de seleção ao lado dos conjuntos de dados que você deseja adicionar e selecione Adicionar selecionado.

nota
Os conjuntos de dados escolhidos devem ter uma revisão finalizada. Conjuntos de dados sem revisões finalizadas não são adicionados.
1. Acesse Conjuntos de dados selecionados para revisar as seleções.
  
  Você pode revisar o Nome e o Tipo do conjunto de dados e a marcação de data e hora de quando o conjunto de dados foi Atualizado pela última vez.
2. Acesse Selecionar regras de acesso à revisão, escolha as regras de acesso à revisão que você deseja definir para conjuntos de dados incluídos no produto e selecione Próximo.
  
  Para obter mais detalhes, consulte Regras de acesso de revisão.

Considerações ao publicar um conjunto de dados de permissão de dados do AWS Lake Formation (Visualização)

Para garantir uma experiência ideal para o assinante, desaconselhamos fazer qualquer uma das seguintes modificações em permissões em que seu produto contenha conjuntos de dados do AWS Data Exchange para Lake Formation (Visualização) com assinantes ativos desse produto.

Recomendamos não excluir ou modificar perfis do IAM transmitidos ao AWS Data Exchange em produtos publicados que contenham conjuntos de dados do AWS Lake Formation. Ao excluir ou modificar esses perfis do IAM, ocorrerão os seguintes problemas:
- As Contas da AWS que têm acesso às permissões de dados do Lake Formation podem reter o acesso indefinidamente.
- As Contas da AWS que assinam seu produto, mas ainda não receberam acesso às permissões de dados do Lake Formation, não receberão acesso.
O AWS Data Exchange não será responsável pelos perfis do IAM que você excluir ou modificar.
Recomendamos que você não revogue permissões de dados do AWS Lake Formation concedidas de perfis do IAM passadas ao AWS Data Exchange em produtos publicados contendo conjuntos de dados do AWS Lake Formation. Se você revogar as permissões de dados concedidas a esses perfis do IAM, ocorrerão os seguintes problemas:
- As Contas da AWS que têm acesso às permissões de dados do Lake Formation podem reter o acesso indefinidamente.
- As Contas da AWS que assinam seu produto, mas ainda não receberam acesso às permissões de dados do Lake Formation, não receberão acesso.
Recomendamos não revogar permissões de dados do AWS Lake Formation concedidas pelas Contas da AWS com assinaturas ativas para produtos publicados contendo conjuntos de dados do AWS Lake Formation. Se você revogar as permissões de dados concedidas pelas Contas da AWS inscritas em seu produto, essas contas perderão o acesso, proporcionando uma experiência negativa para o cliente.
Recomendamos definir a versão entre contas em seu AWS Glue Data Catalog para a versão 3 ao publicar produtos contendo conjuntos de dados do AWS Lake Formation. Se você fizer downgrade da versão entre contas do seu catálogo do Data Lake enquanto publica produtos contendo conjuntos de dados do AWS Lake Formation, as Contas da AWS que assinam seu produto, mas ainda não receberam acesso às permissões de dados do Lake Formation, poderão não conseguir obter acesso aos dados.

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Conceitos básicos

Modelos de descrição de produto

Publicação de novo produto

Tópicos

Publicação de produto contendo dados baseados em arquivo

Etapas

Etapa 1: criar ativos

Etapa 2: criar um conjunto de dados

Para criar um conjunto de dados

Etapa 3: criar uma revisão

Para criar uma revisão

Etapa 4: importar ativos para uma revisão

Para importar ativos para a revisão

Tópicos

Editar revisão

Para editar a revisão depois de ter finalizado

Excluir revisão

Para excluir a revisão depois de ter finalizado

Atenção

Etapa 5: publicar um novo produto

Para publicar um novo produto

nota

nota

nota

Etapa 6: (Opcional) copiar um produto

nota

Para copiar um produto

Publicar um produto contendo APIs

Visão geral

nota

Etapas

Pré-requisitos

nota

nota

Tópicos

Segurança do conjunto de dados da API

Especificação de solicitação de integração de API

Encaminhamento de cabeçalho

Etapa 1: atualizar a política de recursos da API

Para atualizar sua política de recursos de API

nota

Etapa 2: criar um conjunto de dados de API

Criar um conjunto de dados de API (console)

Para criar um conjunto de dados de API (console)

Criação de um conjunto de dados de API (AWS CLI)

Para criar um conjunto de dados de API (CLI)

Etapa 3: criar uma revisão

Criação de revisão (console)

Para criar uma revisão (console)

Criação de revisão (AWS CLI)

Para criar uma revisão (AWS CLI)

nota

Etapa 4: adicionar ativos da API a uma revisão

Adicionar ativos de API a uma revisão (console)

Para adicionar ativos à revisão (console)

nota

nota

nota

nota

Adicionar ativos de API a uma revisão (AWS CLI)

Para adicionar ativos de API a uma revisão (AWS CLI):

Editar revisão

Para editar a revisão depois de finalizá-la

Excluir revisão

Para excluir a revisão depois de finalizá-la

Atenção

Etapa 5: publicar um novo produto contendo APIs

Publicação de um novo produto contendo APIs (console)

Para publicar um novo produto contendo APIs

nota

nota

nota

exemplo Chave personalizada

nota

Etapa 6: (Opcional) copiar um produto

nota

Para copiar um produto

Publicar um produto contendo conjuntos de dados do Amazon Redshift

Visão geral

Etapas

Etapa 1: criar um ativo de unidade de compartilhamento de dados do Amazon Redshift

Para criar um ativo de unidade de compartilhamento de dados do Amazon Redshift