Módulos do AWS S3

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

Requisitos de acesso

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

Adobe Workfront plano*
Pro ou superior
Adobe Workfront licença*
Plano, Trabalho
Adobe Workfront Fusion licença**

Requisito de licença atual: nenhum requisito de licença Workfront Fusion.

Ou

Requisito de licença herdada: Workfront Fusion para Automação e Integração do Trabalho

Produto

Requisito atual do produto: se você tiver o plano Select ou Prime Adobe Workfront, sua organização deve comprar Adobe Workfront Fusion e Adobe Workfront para usar a funcionalidade descrita neste artigo. Workfront Fusion está incluído no plano Workfront do Ultimate.

Ou

Requisito de produto herdado: sua organização deve comprar o Adobe Workfront Fusion e o Adobe Workfront para usar a funcionalidade descrita neste artigo.

Para saber que plano, tipo de licença ou acesso você tem, contate o administrador do Workfront.

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

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 base
https://s3.{{parameter.region}}.amazonaws.com
Tag da API
v1.5.21

Conectar AWS a Workfront Fusion connect-aws-to-workfront-fusion

Para conectar AWS S3 a 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 Workfront Fusion e abra a caixa de diálogo Criar uma conexão do módulo AWS S3.

  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 em Adobe Workfront Fusion.

Ações

Criar bloco

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 a discussão de pontos de extremidade regionais na documentação do AWS.

Obter arquivo

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 a discussão de 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.

Carregar arquivo

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 a discussão de pontos de extremidade regionais na documentação AWS.
Pasta (opcional)
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)
Inserir cabeçalhos de solicitação. Cabeçalhos disponíveis podem ser encontrados na documentação AWS S3 - PUT object.

Fazer uma chamada de API

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 a discussão de pontos de extremidade regionais na documentação AWS.
URL
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 os métodos de solicitação HTTP em Adobe Workfront Fusion.
Cabeçalhos

Adicione um cabeçalho de solicitação. 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.

Workfront Fusion O 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. Esse 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, vá para a Autenticação do REST no Amazon Guia do Desenvolvedor do Serviço de Armazenamento Simples.
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 no Amazon Guia do Desenvolvedor do Serviço de Armazenamento Simples.

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: Transferindo carga em várias partes (Carregamento fragmentado) (AWS Versão de assinatura 4).
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.

Nota:

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

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 a discussão de pontos de extremidade regionais na documentação AWS.
Compartimento
Selecione o bucket Amazon S3 que você deseja pesquisar arquivos.
Prefixo (opcional)
Caminho para uma pasta na qual procurar arquivos, por exemplo, 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 a discussão de pontos de extremidade regionais na documentação do AWS.
Compartimento
Selecione o bucket Amazon S3 que deseja pesquisar pastas.
Prefixo (opcional)
Caminho para uma pasta na qual pesquisar pastas, por exemplo, workfrontfusion/work.
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43