Módulos do AWS S3

Os módulos S3 Adobe Workfront Fusion AWS permitem executar operações em seus buckets S3.

Requisitos de acesso

Expanda para visualizar os requisitos de acesso para a funcionalidade neste artigo.

Você deve ter o seguinte acesso para usar a funcionalidade neste artigo:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Pacote do Adobe Workfront Qualquer
Licença do Adobe Workfront

Novo: Padrão

Ou

Atual: trabalho ou superior

Licença do Adobe Workfront Fusion**

Atual: nenhum requisito de licença do Workfront Fusion

Ou

Herdados: Automação e integração do Workfront Fusion for Work

Produto

Novo menu:

  • Selecionar ou pacote do Prime Workfront: sua organização deve comprar o Adobe Workfront Fusion.
  • Pacote do Ultimate Workfront: o Workfront Fusion está incluído.

Ou

Atual: sua organização deve comprar o Adobe Workfront Fusion.

Para obter mais detalhes sobre as informações nesta tabela, consulte Requisitos de acesso na documentação.

Para obter informações sobre licenças do Adobe Workfront Fusion, consulte licenças do Adobe Workfront Fusion.

Pré-requisitos

Para usar os módulos do AWS S3, você deve ter uma conta Amazon Web Service.

Informações da API do AWS S3

O conector AWS S3 usa o seguinte:

URL básica
https://s3.{{parameters.region}}.amazonaws.com
Tag da API
v1.5.21

Conectar o AWS ao Workfront Fusion connect-aws-to-workfront-fusion

Para conectar o AWS S3 ao Workfront Fusion, você deve conectar sua conta do AWS ao Workfront Fusion. Para fazer isso, primeiro será necessário criar um usuário de API no AWS IAM.

  1. Entre na sua conta do AWS IAM.

  2. Navegue até Gerenciamento de Identidade e Acesso > Gerenciamento de Acesso > Usuários.

  3. Clique em Adicionar usuário.

  4. Insira o nome do novo usuário e selecione a opção Acesso programático na seção Tipo de acesso.

  5. Clique em Anexar diretivas existentes diretamente e procure por AmazonS3FullAccess na barra de pesquisa. Clique nela quando ela aparecer, em seguida, clique em Avançar.

  6. Prossiga pelas outras telas de diálogo e clique em Criar Usuário.

  7. Copie a ID da chave de acesso e a chave de acesso secreta fornecidas.

  8. Vá para o Workfront Fusion e abra a caixa de diálogo AWS S3Criar uma conexão do módulo.

  9. Insira a ID da chave de acesso e a chave de acesso secreta da etapa 7 para os respectivos campos e clique em Continuar para estabelecer a conexão.

A conexão foi estabelecida. Você pode prosseguir com a configuração do módulo.

AWS S3 módulos e seus campos

Ao configurar módulos do AWS S3, o Workfront Fusion exibe os campos listados abaixo. Junto com esses, campos AWS S3 adicionais podem ser exibidos, dependendo de fatores como seu nível de acesso no aplicativo ou serviço. Um título em negrito em um módulo indica um campo obrigatório.

Se você vir o botão de mapa acima de um campo ou função, poderá usá-lo para definir variáveis e funções para esse campo. Para obter mais informações, consulte Mapear informações de um módulo para outro.

Alternância de mapa

Ações

Criar bloco

Esse módulo de ação cria um bucket no AWS.

Conexão
Para obter instruções sobre como conectar sua conta do AWS ao Workfront Fusion, consulte Conectar AWS ao Workfront Fusion neste artigo.
Nome
Informe o nome do novo período.
Região
Selecione seu ponto de extremidade regional. Para obter mais informações, consulte pontos de extremidade regionais na documentação do AWS.

Obter arquivo

Esse módulo de ação baixa um arquivo de um bucket.

Conexão
Para obter instruções sobre como conectar sua conta do AWS ao Workfront Fusion, consulte Conectar AWS ao Workfront Fusion neste artigo.
Região
Selecione seu ponto de extremidade regional. Para obter mais informações, consulte pontos de extremidade regionais na documentação AWS.
Compartimento
Selecione o bucket do qual deseja baixar o arquivo.
Caminho
Insira o caminho para o arquivo. Exemplo: /photos/2019/February/image023.jpg.

Fazer uma chamada de API

Esse módulo de ação faz uma chamada personalizada para a API do AWS S3.

Para obter uma discussão detalhada da API Amazon S3, consulte a Amazon S3 Introdução à API REST.

Conexão
Para obter instruções sobre como conectar sua conta do AWS ao Workfront Fusion, consulte Conectar AWS ao Workfront Fusion neste artigo.
Região
Selecione seu ponto de extremidade regional. Para obter mais informações, consulte pontos de extremidade regionais na documentação AWS.
URL
Insira um URL de host. O caminho deve ser relativo a https://s3.<selected-region>.amazonaws.com/.
Método
Selecione o método de solicitação HTTP necessário para configurar a chamada à API. Para obter mais informações, consulte métodos de solicitação HTTP no Adobe Workfront Fusion.
Cabeçalhos

Adicione um cabeçalho de solicitação. Para cada cabeçalho que deseja adicionar, clique em Adicionar item e insira o cabeçalho. Você pode usar os seguintes cabeçalhos de solicitação comuns. Para obter mais cabeçalhos de solicitação consulte a AWS S3 Documentação da API.

O Workfront Fusion adiciona cabeçalhos de autorização automaticamente.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 layout-auto
Nome do cabeçalho Descrição
Tamanho do Conteúdo Comprimento da mensagem (sem os cabeçalhos) de acordo com RFC 2616. Este cabeçalho é necessário para PUTs e operações que carregam XML, como log e ACLs.
Tipo de Conteúdo O tipo de conteúdo do recurso, caso o conteúdo da solicitação esteja no corpo. Exemplo: text/plain.
Content-MD5 O digest MD5 de 128 bits codificado em base64 da mensagem (sem os cabeçalhos) de acordo com a RFC 1864. Esse cabeçalho pode ser usado como uma verificação de integridade da mensagem para verificar se os dados são os mesmos que foram enviados originalmente. Embora seja opcional, recomendamos usar o mecanismo Content-MD5 como uma verificação de integridade completa. Para obter mais informações sobre a autenticação de solicitação do REST, consulte Solicitações de autenticação e autenticação REST na documentação do AWS.
Data A data e a hora atuais de acordo com o solicitante. Exemplo: Wed, 01 Mar 2006 12:00:00 GMT. Ao especificar o cabeçalho Authorization , você deve especificar o cabeçalho x-amz-date ou Date .
Esperar

Quando seu aplicativo usa 100-continue, ele não envia o corpo da solicitação até que receba uma confirmação. Se a mensagem for rejeitada com base nos cabeçalhos, o corpo da mensagem não será enviado. Esse cabeçalho só poderá ser usado se você estiver enviando um corpo.

Valores Válidos: 100-continue

Host

Para solicitações de estilo de caminho, o valor é s3.amazonaws.com. Para solicitações de estilo virtual, o valor é BucketName.s3.amazonaws.com. Para obter mais informações, consulte Hospedagem virtual na documentação do AWS.

Esse cabeçalho é necessário para HTTP 1.1 (a maioria dos kits de ferramentas adiciona esse cabeçalho automaticamente); opcional para solicitações HTTP/1.0.

x-amz-content-sha256 Ao usar a assinatura versão 4 para autenticar a solicitação, este cabeçalho fornece um hash da carga da solicitação. Ao carregar um objeto em partes, defina o valor como STREAMING-AWS4-HMAC-SHA256-PAYLOAD para indicar que a assinatura cobre apenas cabeçalhos e que não há carga útil. Para obter mais informações, consulte Cálculos de assinatura para o cabeçalho de autorização na documentação do AWS.
data-x-amz A data e a hora atuais de acordo com o solicitante. Exemplo: Wed, 01 Mar 2006 12:00:00 GMT. Ao especificar o cabeçalho Authorization , você deve especificar o cabeçalho x-amz-date ou Date . Se você especificar ambos, o valor especificado para o cabeçalho x-amz-date terá prioridade.
x-amz-security-token

Esse cabeçalho pode ser usado nos seguintes cenários:

  • Forneça tokens de segurança para Amazon DevPay operações. Cada solicitação que usa Amazon DevPay requer dois cabeçalhos x-amz-security-token: um para o token do produto e um para o token do usuário. Quando Amazon S3 recebe uma solicitação autenticada, ele compara a assinatura computada com a assinatura fornecida. Cabeçalhos multivalores formatados incorretamente usados para calcular uma assinatura podem causar problemas de autenticação.
  • Forneça um token de segurança ao usar credenciais de segurança temporárias. Ao fazer solicitações usando credenciais de segurança temporárias obtidas do IAM, você deve fornecer um token de segurança usando esse cabeçalho. Para saber mais sobre credenciais de segurança temporárias, acesse Fazer solicitações.

Este cabeçalho é necessário para solicitações que usam Amazon DevPay e solicitações que são assinadas usando credenciais de segurança temporárias.

Cadeia de Consulta
Adicione as cadeias de caracteres de consulta desejadas, como parâmetros ou campos de formulário.
Corpo

Adicione o conteúdo do corpo para a chamada à API na forma de um objeto JSON padrão.

Observação:

Ao usar instruções condicionais como if em seu JSON, coloque as aspas fora da instrução condicional.

Carregar arquivo

Esse módulo de ação faz upload de um arquivo para um bucket do AWS S3.

Conexão
Para obter instruções sobre como conectar sua conta do AWS ao Workfront Fusion, consulte Conectar AWS ao Workfront Fusion neste artigo.
Região
Selecione seu ponto de extremidade regional. Para obter mais informações, consulte pontos de extremidade regionais na documentação AWS.
Pasta
Especifique a pasta de destino para a qual você deseja fazer upload de um arquivo.
arquivo Source
Selecione um arquivo de origem de um módulo anterior ou mapeie o nome e os dados do arquivo de origem.
Cabeçalhos (opcional)

Para cada cabeçalho que você deseja adicionar, clique em Adicionar item e insira a chave e o valor do cabeçalho.

Para os cabeçalhos disponíveis, consulte PutObject na documentação do AWS.

Pesquisas

Listar Arquivos

Retorna uma lista de arquivos de um local especificado.

Conexão
Para obter instruções sobre como conectar sua conta do AWS ao Workfront Fusion, consulte Conectar AWS ao Workfront Fusion neste artigo.
Região
Selecione seu ponto de extremidade regional. Para obter mais informações, consulte pontos de extremidade regionais na documentação AWS.
Compartimento
Selecione o bucket Amazon S3 que você deseja pesquisar arquivos.
Prefixo
Insira um caminho para uma pasta na qual pesquisar arquivos, como workfrontfusion/work.

Listar pastas

Retorna uma lista de pastas de um local especificado.

Conexão
Para obter instruções sobre como conectar sua conta do AWS ao Workfront Fusion, consulte Conectar AWS ao Workfront Fusion neste artigo.
Região
Selecione seu ponto de extremidade regional. Para obter mais informações, consulte pontos de extremidade regionais na documentação AWS.
Compartimento
Selecione o bucket Amazon S3 que deseja pesquisar pastas.
Prefixo (opcional)
Caminho para uma pasta na qual pesquisar pastas, como workfrontfusion/work.
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3