Cabeçalhos HTTP e Campos de Formulário HTML para Usar o Gateway da web

É possível customizar uma solicitação para criar ou recuperar um recurso usando cabeçalhos HTTP ou campos de formulário HTML. Cada parâmetro é mapeado para uma propriedade ou função do IBM® MQ Managed File Transfer.

A convenção HTTP é prefixar cabeçalhos customizados com x- seguidos por um identificador específico do produto. IBM MQ Managed File Transfer usa o identificador do produto fte-.

Para os valores possíveis de cada cabeçalho ou campo de formulário listado na tabela a seguir, consulte o tópico que descreve o comando e o parâmetro equivalente do IBM MQ Managed File Transfer . Por exemplo, o conjunto de valores possíveis para o cabeçalho x-fte-action é o conjunto de valores possíveis para o comando fteCreateTransfer quando usado com o parâmetro -de.
Nome do cabeçalho Nome do campo de formulário Tipos de objeto e verbos suportados Comando e parâmetro da linha de comandos Descrição Exemplo de uso do cabeçalho Exemplo de uso do campo de formulário
x-fte-action action Arquivo (POST) fteCreateTransferência, -de Especifica a ação a ser executada se o arquivo de destino existir. As opções válidas são:
  • overwrite
  • error - Esse é o padrão.
 x-fte-action:overwrite <input type="HIDDEN" name="action" value="overwrite"/>
x-fte-priority priority Arquivo (POST) fteCreateTransferência, -pr Especifica a prioridade da transferência. x-fte-priority:5 <input type="HIDDEN" name="priority" value="5"/>
x-fte-type type Arquivo (POST) fteCreateTransferência, -t Especifica se a transferência será feita no modo binário ou texto. As opções válidas são:
  • texto
  • binary - Esse é o padrão.
 x-fte-type:binary <input type="HIDDEN" name="type" value="binary"/>
x-fte-checksum checksum Arquivo (POST) fteCreateTransferência, -cs Especifica o algoritmo da soma de verificação a ser usada para verificar se a transferência enviou os dados corretamente. As opções válidas são:
  • Nenhum
  • MD5 - Esse é o padrão.
 x-fte-checksum:MD5 <input type="HIDDEN" name="checksum" value="MD5"/>
x-fte-metadata metadata Arquivo (POST) fteCreateTransfer, -md

Especifica os metadados a serem associados à transferência.

O cabeçalho dos metadados ou o campo de formulário pode ser especificado várias vezes em uma única solicitação.

 x-fte-metadata:a=b,c=d,e=f <input type="HIDDEN" name="metadata" value="a=b,c=d,e=f"/>
x-fte-jobname jobname Arquivo (POST) fteCreateTransfer, -jn Especifica o nome da tarefa a ser associada à transferência. x-fte-jobname:BatchOrder_1 <input type="HIDDEN" name="jobname" value="BatchOrder_1"/>
x-fte-postdest postdest Arquivo (POST) fteAnt, em que o script Ant chamado contém um elemento postdst aninhado Especifica um comando para ser executado no agente de destino quando a transferência do arquivo for concluída. Suporta todos os atributos disponíveis para uma chamada de programa. Para obter mais detalhes desses atributos, consulte o tópico Elementos Aninhados de Chamada de Programa 

x-fte-postdest:
[command=virus_scan.sh,
type=executable,
successrc=0]


<input type="HIDDEN" 
name="postdest" 
value="[command=
virus_scan.sh, 
type=executable,
successrc=0]"/>
x-fte-postdest-args postdest-args Arquivo (POST) fteAnt, em que o script Ant chamado especifica elementos arg em um elemento postdst

Especifica um ou mais argumentos a serem passados para um comando se um comando tiver sido especificado usando o cabeçalho x-fte-postdest. Apenas válido se o atributo type especificado no cabeçalho x-fte-postdest for executable. Suporta todos os atributos disponíveis para uma chamada de programa. Para obter mais detalhes desses atributos, consulte o tópico Elementos Aninhados de Chamada de Programa..

 x-fte-postdest-args:[argument1, argument2] <input type="HIDDEN" name="postdest-args" value="[argument1, argument2]"/>
x-fte-postdest-properties postdest-properties Arquivo (POST) fteAnt, em que o script Ant chamado especifica elementos property em um elemento postdst

Especifica uma ou mais propriedades a serem passadas para um script Ant se um script Ant tiver sido especificado usando o cabeçalho x-fte-postdest. Apenas válido se o atributo type especificado no cabeçalho x-fte-postdest for antscript. Suporta todos os atributos disponíveis para uma chamada de programa. Para obter mais detalhes desses atributos, consulte o tópico Elementos Aninhados de Chamada de Programa..

 

x-fte-
postdest-properties
:[scanspeed=fast,
resultoutput=scan.log]


<input type="HIDDEN" 
name=
"postdest-properties" 
value="[scanspeed=fast,
resultoutput=
scan.log]"/>
x-fte-postdest-targets postdest-targets Arquivo (POST) fteAnt, em que o script Ant chamado especifica elementos target em um elemento postdst

Especifica um ou mais destinos para execução a partir de um script Ant se um script Ant tiver sido especificado usando o cabeçalho x-fte-postdest. Apenas válido se o atributo type especificado no cabeçalho x-fte-postdest for antscript. Para obter mais detalhes, consulte o tópico Elementos Aninhados de Chamada do Programa

 x-fte-postdest-targets:[scanfile] <input type="HIDDEN" name="postdest-targets" value="[scanfile]"/>
x-fte-include-file-in-response Nenhum Arquivo (EXCLUIR) Nenhum

Especifica se o arquivo excluído é incluído na resposta HTTP. O padrão é false.

 x-fte-include-file-in-response:true

Especifica se o arquivo excluído é incluído na resposta HTTP. O padrão é false.

 Nenhum
x-fte-check-integrity Nenhum Espaço no arquivo (GET) Nenhum

Em uma solicitação para revisar o conteúdo de um espaço no arquivo, especifica que uma verificação de integridade deve ser executada nos arquivos de espaço no arquivo. Em uma solicitação para listar todos os espaço no arquivo, especifica que uma verificação de integridade deve ser executada na raiz de espaço no arquivo. O padrão é false.

 x-fte-check-integrity:true Nenhum
x-fte-csrf-token csrf-token Arquivo (POST, DELETE)

Espaço de arquivo (POST, DELETE)

 Nenhum

Especifica o JSESSIONID atual que o Gateway da web deve comparar com seu próprio JSESSIONID em uma solicitação para criar ou excluir um arquivo, ou para criar, excluir ou modificar um espaço no arquivo. Isso fornecerá proteção contra ataques cross-site request forgery (CSRF) se a proteção contra CSRF estiver ativada no Gateway da web.

 

x-fte-csrf-token:
E324D3C64E6B4662
0843C88A25B4C32D


<input type="HIDDEN" 
name="csrf-token" 
value="E324D3C64E6B4
6620843C88A25B4C32D"/>