A API de anexos fornece endpoints que permitem carregar e consultar anexos de arquivo.

Você pode carregar ou recuperar um único arquivo com cada solicitação.

A API de anexos respeita todas as limitações do sistema em arquivos carregados, como tamanho máximo de arquivo e tipos de anexo permitidos. Você pode controlar essas configurações usando as propriedades com.glide.attachment.max_size, 1024 MB por padrão e glide.attachment.extensions.

Nota: A API de anexos aceita todos os valores de tipo de conteúdo (*/*). Especifique o tipo de conteúdo do arquivo ao carregar um anexo. O tipo de conteúdo é armazenado com metadados de arquivo, permitindo que outras ferramentas identifiquem e analisem corretamente o arquivo.

O vídeo a seguir fornece mais informações sobre a API de anexos :

Requisitos de função da API de anexos

Para criar anexos, o registro de usuário usado para autenticar a solicitação HTTP com ServiceNow deve ter todas as funções necessárias para criar registros de Anexo [sys_attachment]. Ele também deve ter todas as funções necessárias para ler e gravar registros na tabela de destino, como a função itil para adicionar anexos a registros de incidentes.

Por padrão, não há uma função única que permita que um usuário adicione anexos. Você pode criar uma função para permitir explicitamente a adição de anexos e atribuir essa função à conta de usuário que está sendo usada para fazer a solicitação.

Anexo - DELETE /now/attachment/{sys_id}

Este método exclui o anexo com um valor de sys_id específico.

Formato da URL

URL com controle de versão: /api/now/v1/attachment/{sys_id}

URL padrão: /api/now/attachment/{sys_id}

Nota: As versões disponíveis são especificadas no Explorador de REST API. Para REST APIs com script, há informações adicionais sobre a versão no formulário Serviço REST com script.

Parâmetros de solicitação compatíveis

Tabela 1. Parâmetros de caminho
Nome Descrição
sys_id Valor de Sys_id do anexo a ser excluído.

Tipo de dados: cadeia de caracteres
Tabela 2. Parâmetros de consulta
Nome Descrição
Nenhum(a)
Tabela 3. Parâmetros do corpo da solicitação (XML ou JSON)
Nome Descrição
Nenhum(a)

Cabeçalhos

Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos de REST API compatíveis.

Tabela 4. Cabeçalhos da solicitação
Cabeçalho Descrição
Nenhum(a)
Tabela 5. Cabeçalhos de resposta
Cabeçalho Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de códigos de status possíveis usados na REST API, consulte Códigos de resposta HTTP de REST API.

Parâmetros do corpo da resposta (JSON ou XML)

Nome Descrição
Nenhum(a)

Exemplo: Solicitação de cURL

curl "https://instance.servicenow.com/api/now/attachment/615ea769c0a80166001cf5f2367302f5" \
--request DELETE \
--user 'username':'password'

""

Anexo - GET /now/attachment

Retorna os metadados de vários anexos.

Formato da URL

URL com controle de versão: api/now/v1/attachment

URL padrão: api/now/attachment

Nota: As versões disponíveis são especificadas no Explorador de REST API. Para REST APIs com script, há informações adicionais sobre a versão no formulário Serviço REST com script.

Parâmetros de solicitação compatíveis

Tabela 7. Parâmetros de caminho
Nome Descrição
Nenhum(a)
Tabela 8. Parâmetros de consulta
Nome Descrição
sysparm_limit Limite a ser aplicado na paginação.
Nota: Valores de sysparm_limit incomumente grandes podem afetar o desempenho do sistema.

Tipo de dados: cadeia de caracteres

Padrão: 1000
sysparm_offset Número de registros a serem excluídos da consulta. Use este parâmetro para obter mais registros do que o especificado no parâmetro sysparm_limit. Por exemplo, se sysparm_limit estiver definido como 500, mas houver registros adicionais que você deseja consultar, você poderá especificar um valor de parâmetro sysparm_offset de 500 para obter o segundo conjunto de registros.

Tipo de dados: cadeia de caracteres

Padrão: 0
sysparm_query Consulta codificada. As consultas para a API de anexos são relativas à tabela Anexos [sys_attachment].

Por exemplo: (sysparm_query=file_name=attachment.doc)

A consulta codificada fornece suporte para ordenar por. Para classificar respostas com base em determinados campos, use as cláusulas ORDERBY e ORDERBYDESC em sysparm_query. Por exemplo, sysparm_query=ORDERBYfile_name^ORDERBYDESCtable_Name ordena os resultados em ordem crescente por nome primeiro e, em seguida, em ordem decrescente por nome da tabela.

Tipo de dados: cadeia de caracteres
Tabela 9. Parâmetros do corpo da solicitação (XML ou JSON)
Nome Descrição
Nenhum(a)

Cabeçalhos

Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos de REST API compatíveis.

Tabela 10. Cabeçalhos da solicitação
Cabeçalho Descrição
Aceitar Formato de dados do corpo da resposta. Tipos compatíveis: application/json ou application/xml.

Padrão: application/json
Tabela 11. Cabeçalhos de resposta
Cabeçalho Descrição
Tipo de conteúdo Tipo de conteúdo da resposta. Para solicitações de metadados, este é o tipo de conteúdo dos metadados, não o tipo de conteúdo dos arquivos de anexo.
Link Links para baixar os anexos.

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de códigos de status possíveis usados na REST API, consulte Códigos de resposta HTTP de REST API.

Tabela 12. Códigos de status
Código do status Descrição
200 Bem-sucedido. A solicitação foi processada com sucesso.
401 Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
500 Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro.

Parâmetros do corpo da resposta (JSON ou XML)

Nome Descrição
As informações retornadas dependem dos anexos selecionados.

Exemplo: Solicitação de cURL

curl "https://instance.servicenow.com/api/now/attachment?sysparm_limit=1" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

{
  "result": [
    {
      "table_sys_id": "5054b6f8c0a800060056addcf551ecf8",
      "size_bytes": "462",
      "download_link": "https://instance.service-now.com/api/now/attachment/615ea769c0a80166001cf5f2367302f5/file",
      "sys_updated_on": "2009-05-21 04:12:21",
      "sys_id": "615ea769c0a80166001cf5f2367302f5",
      "image_height": "",
      "sys_created_on": "2009-05-21 04:12:21",
      "file_name": "blocks.swf",
      "sys_created_by": "glide.maint",
      "compressed": "true",
      "average_image_color": "",
      "sys_updated_by": "glide.maint",
      "sys_tags": "",
      "table_name": "content_block_programmatic",
      "image_width": "",
      "sys_mod_count": "0",
      "content_type": "application/x-shockwave-flash",
      "size_compressed": "485"
    }
  ]
}

Anexo - GET /now/attachment/{sys_id}/file

Retorna o anexo de arquivo binário com um valor de sys_id específico.

Formato da URL

URL com controle de versão: /api/now/v1/attachment/{sys_id}/file

URL padrão: /api/now/attachment/{sys_id}/file

Nota: As versões disponíveis são especificadas no Explorador de REST API. Para REST APIs com script, há informações adicionais sobre a versão no formulário Serviço REST com script.

Parâmetros de solicitação compatíveis

Tabela 13. Parâmetros de caminho
Nome Descrição
sys_id Sys_id do registro de anexo do qual os dados binários serão retornados.
Tabela 14. Parâmetros de consulta
Nome Descrição
Nenhum(a)
Tabela 15. Parâmetros do corpo da solicitação (XML ou JSON)
Nome Descrição
Nenhum(a)

Cabeçalhos

Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos de REST API compatíveis.

Tabela 16. Cabeçalhos da solicitação
Cabeçalho Descrição
Aceitar Formato de dados do corpo da resposta. Por exemplo, use image/jpeg ou image/png para aceitar exclusivamente arquivos de imagem JPEG ou PNG. Para permitir todos os tipos de imagem, especifique image/*; para permitir qualquer tipo de arquivo, especifique */*.

Padrão: */*
Tabela 17. Cabeçalhos de resposta
Cabeçalho Descrição
X-Anexo-Metadados Metadados sobre o arquivo retornado, como tamanho, nome e tipo de arquivo.

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de códigos de status possíveis usados na REST API, consulte Códigos de resposta HTTP de REST API.

Parâmetros do corpo da resposta (JSON ou XML)

Nome Descrição
Anexo de arquivo binário

Exemplo: Solicitação de cURL

curl "https://instance.servicenow.com/api/now/attachment/615ea769c0a80166001cf5f2367302f5/file" \
--request GET \
--header "Accept:*/*" \
--user "username":"password"
Binary response not shown.

Anexo - GET /now/attachment/{sys_id}

Retorna os metadados do arquivo de anexo com um valor sys_id específico.

Formato da URL

URL com controle de versão: /api/now/v1/attachment/{sys_id}

URL padrão: /api/now/attachment/{sys_id}

Nota: As versões disponíveis são especificadas no Explorador de REST API. Para REST APIs com script, há informações adicionais sobre a versão no formulário Serviço REST com script.

Parâmetros de solicitação compatíveis

Tabela 19. Parâmetros de caminho
Nome Descrição
sys_id Sys_id do registro de anexo para o qual os metadados serão recuperados.
Tabela 20. Parâmetros de consulta
Nome Descrição
Nenhum(a)
Tabela 21. Parâmetros do corpo da solicitação (XML ou JSON)
Nome Descrição
Nenhum(a)

Cabeçalhos

Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos de REST API compatíveis.

Tabela 22. Cabeçalhos da solicitação
Cabeçalho Descrição
Aceitar Formato de dados do corpo da resposta. Tipos compatíveis: application/json ou application/xml.

Padrão: application/json
Tabela 23. Cabeçalhos de resposta
Cabeçalho Descrição
Tipo de conteúdo O tipo de conteúdo da resposta. Para solicitações de metadados, este é o tipo de conteúdo dos metadados, não o tipo de conteúdo dos arquivos de anexo.

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de códigos de status possíveis usados na REST API, consulte Códigos de resposta HTTP de REST API.

Parâmetros do corpo da resposta (JSON ou XML)

Nome Descrição
Metadados específicos para o anexo especificado.

Exemplo: Solicitação de cURL

curl "https://instance.servicenow.com/api/now/attachment/615ea769c0a80166001cf5f2367302f5" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"
{
  "result": {
    "table_sys_id": "5054b6f8c0a800060056addcf551ecf8",
    "size_bytes": "462",
    "download_link": "https://instance.service-now.com/api/now/attachment/615ea769c0a80166001cf5f2367302f5/file",
    "sys_updated_on": "2009-05-21 04:12:21",
    "sys_id": "615ea769c0a80166001cf5f2367302f5",
    "image_height": "",
    "sys_created_on": "2009-05-21 04:12:21",
    "file_name": "blocks.swf",
    "sys_created_by": "glide.maint",
    "compressed": "true",
    "average_image_color": "",
    "sys_updated_by": "glide.maint",
    "sys_tags": "",
    "table_name": "content_block_programmatic",
    "image_width": "",
    "sys_mod_count": "0",
    "content_type": "application/x-shockwave-flash",
    "size_compressed": "485"
  }
}

Anexo - POST /now/attachment/file

Carrega um arquivo binário especificado como um anexo para um registro especificado.

Nota: O arquivo a ser anexado deve ser especificado após o último parâmetro na lista de parâmetros de solicitação passada.

Formato da URL

URL com controle de versão: /api/now/v1/attachment/file

URL padrão: /api/now/attachment/file

Nota: As versões disponíveis são especificadas no Explorador de REST API. Para REST APIs com script, há informações adicionais sobre a versão no formulário Serviço REST com script.

Parâmetros de solicitação compatíveis

Tabela 25. Parâmetros de caminho
Nome Descrição
Nenhum(a)
Tabela 27. Parâmetros do corpo da solicitação (XML ou JSON)
Nome Descrição
<String> Caminho para o arquivo binário a ser anexado ao registro especificado.

Cabeçalhos

Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos de REST API compatíveis.

Tabela 28. Cabeçalhos da solicitação
Cabeçalho Descrição
Aceitar Formato de dados do corpo da resposta. Tipos compatíveis: application/json ou application/xml.

Padrão: application/json
Tipo de conteúdo Tipo de conteúdo do arquivo a ser anexado, como imagem/jpeg ou */*. Este cabeçalho é obrigatório para publicar anexos de arquivo.
Tabela 29. Cabeçalhos de resposta
Cabeçalho Descrição
Local URL do novo anexo.

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de códigos de status possíveis usados na REST API, consulte Códigos de resposta HTTP de REST API.

Parâmetros do corpo da resposta (JSON ou XML)

ElementoDescrição
resultado Metadados do anexo solicitado.

Tipo de dados: objeto

"result": {
  "average_image_color": "String",
  "compressed": "String", 
  "content_type": "String",
  "created_by_name": "String",
  "download_link": "String",
  "file_name": "String",
  "image_height": "String",
  "image_width": "String",
  "size_bytes": "String",
  "size_compressed": "String",
  "sys_created_by": "String",
  "sys_created_on": "String",
  "sys_id": "String",
  "sys_mod_count": "String",
  "sys_tags": "String",
  "sys_updated_by": "String",
  "sys_updated_on": "String",
  "table_name": "String",
  "table_sys_id": "String",
  "updated_by_name": "String"
}
resultado.average_image_color Se o anexo for uma imagem, a soma de todas as cores.

Tipo de dados: cadeia de caracteres

Unidade: RGB ou número de pixels.
resultado.compactado Sinalizador que indica se o arquivo de anexo foi compactado.
Valores possíveis:
  • verdadeiro: o arquivo foi compactado.
  • falso: o arquivo não foi compactado.

Tipo de dados: cadeia de caracteres
resultado.content_type Tipo de conteúdo do arquivo de anexo associado, como imagem, jpeg ou aplicação/x-shockondas-flash.

Tipo de dados: cadeia de caracteres
resultado.criado_por_nome Nome completo da entidade que criou originalmente o arquivo de anexo.

Tipo de dados: cadeia de caracteres
resultado.download_link URL de download do anexo na instância ServiceNow.

Tipo de dados: cadeia de caracteres
resultado.file_name Nome do arquivo do anexo.

Tipo de dados: cadeia de caracteres
resultado.imagem_altura Se for um arquivo de imagem, a altura da imagem.

Tipo de dados: cadeia de caracteres

Unidade: pixels
resultado.image_width Se for um arquivo de imagem, a largura da imagem.

Tipo de dados: cadeia de caracteres

Unidade: pixels
resultado.tamanho_bytes Tamanho do anexo.

Tipo de dados: cadeia de caracteres

Unidade: bytes
resultado.tamanho_compactado Tamanho do arquivo de anexo compactado. Se o arquivo não estiver compactado, vazio.

Tipo de dados: cadeia de caracteres

Unidade: bytes
resultado.sys_created_by Entidade que criou originalmente o arquivo de anexo.

Tipo de dados: cadeia de caracteres
resultado.sys_created_on Data e hora em que o arquivo de anexo foi salvo inicialmente na instância.

Tipo de dados: cadeia de caracteres
resultado.sys_id Sys_id do arquivo de anexo.

Tipo de dados: cadeia de caracteres
resultado.sys_mod_count Número de vezes que o arquivo de anexo foi modificado (carregado para a instância).

Tipo de dados: cadeia de caracteres
resultado.sys_tags Quaisquer marcadores do sistema associados ao arquivo de anexo.

Tipo de dados: cadeia de caracteres
resultado.sys_updated_by Entidade que atualizou o arquivo de anexo pela última vez.

Tipo de dados: cadeia de caracteres
resultado.sys_updated_on Data e hora em que o arquivo de anexo foi atualizado pela última vez.

Tipo de dados: cadeia de caracteres
resultado.table_name Nome da tabela à qual o anexo está associado.

Tipo de dados: cadeia de caracteres
result.table_sys_id Sys_id da tabela associada ao anexo.

Tipo de dados: cadeia de caracteres
resultado.atualizado_por_nome Nome completo da entidade que atualizou o arquivo de anexo pela última vez.

Tipo de dados: cadeia de caracteres

Exemplo: Solicitação de cURL

curl "https://instance.servicenow.com/api/now/attachment/file?table_name=incident&table_sys_id=d71f7935c0a8016700802b64c67c11c6&file_name=Issue_screenshot" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type: image/jpeg" \
--user "username":"password" \
--data-binary "@ location of the file on file system"
{
  "result": {
    "table_sys_id": "d71f7935c0a8016700802b64c67c11c6",
    "size_bytes": "36597",
    "download_link": "https://instance.servicenow.com/api/now/attachment/6ea10fe64f411200adf9f8e18110c739/file",
    "sys_updated_on": "2016-01-22 15:14:07",
    "sys_id": "6ea10fe64f411200adf9f8e18110c739",
    "image_height": "",
    "sys_created_on": "2016-01-22 15:14:07",
    "file_name": "Issue_screenshot",
    "sys_created_by": "admin",
    "compressed": "true",
    "average_image_color": "",
    "sys_updated_by": "admin",
    "sys_tags": "",
    "table_name": "incident",
    "image_width": "",
    "sys_mod_count": "0",
    "content_type": "image/jpeg",
    "size_compressed": "25130"
  }
}

Anexo - POST /now/attachment/upload

Carrega um anexo de arquivo de várias partes.

O método POST multipartes não aceita nenhum parâmetro. Você deve especificar o nome da tabela e os valores de sys_id do registro no corpo do formulário. Consulte o exemplo de cURL para obter uma amostra de uma solicitação de dados de formulário/várias partes.

Importante: Ao usar POST multipartes, certifique-se de que o conteúdo do arquivo esteja contido somente na parte final da mensagem. As partes anteriores devem conter apenas metadados, como nome da tabela e registro sys_id.

Formato da URL

URL com controle de versão: /api/now/v1/attachment/upload

URL padrão: /api/now/attachment/upload

Nota: As versões disponíveis são especificadas no Explorador de REST API. Para REST APIs com script, há informações adicionais sobre a versão no formulário Serviço REST com script.

Parâmetros de solicitação compatíveis

Tabela 31. Parâmetros de caminho
Nome Descrição
Nenhum(a)
Tabela 32. Parâmetros de consulta
Nome Descrição
Nenhum(a)
Tabela 33. Parâmetros do corpo da solicitação (XML ou JSON)
Nome Descrição
Nenhum(a)

Cabeçalhos

Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos de REST API compatíveis.

Tabela 34. Cabeçalhos da solicitação
Cabeçalho Descrição
Aceitar Formato de dados do corpo da resposta. Tipos compatíveis: application/json ou application/xml.

Padrão: application/json
Tipo de conteúdo Tipo de conteúdo da solicitação. Defina este valor como multipart/form-data ao usar o método POST multipart.
Tabela 35. Cabeçalhos de resposta
Cabeçalho Descrição
Local URL do novo anexo.

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de códigos de status possíveis usados na REST API, consulte Códigos de resposta HTTP de REST API.

Parâmetros do corpo da resposta (JSON ou XML)

ElementoDescrição
resultado Metadados do anexo solicitado.

Tipo de dados: objeto

"result": {
  "average_image_color": "String",
  "compressed": "String", 
  "content_type": "String",
  "created_by_name": "String",
  "download_link": "String",
  "file_name": "String",
  "image_height": "String",
  "image_width": "String",
  "size_bytes": "String",
  "size_compressed": "String",
  "sys_created_by": "String",
  "sys_created_on": "String",
  "sys_id": "String",
  "sys_mod_count": "String",
  "sys_tags": "String",
  "sys_updated_by": "String",
  "sys_updated_on": "String",
  "table_name": "String",
  "table_sys_id": "String",
  "updated_by_name": "String"
}
resultado.average_image_color Se o anexo for uma imagem, a soma de todas as cores.

Tipo de dados: cadeia de caracteres

Unidade: RGB ou número de pixels.
resultado.compactado Sinalizador que indica se o arquivo de anexo foi compactado.
Valores possíveis:
  • verdadeiro: o arquivo foi compactado.
  • falso: o arquivo não foi compactado.

Tipo de dados: cadeia de caracteres
resultado.content_type Tipo de conteúdo do arquivo de anexo associado, como imagem, jpeg ou aplicação/x-shockondas-flash.

Tipo de dados: cadeia de caracteres
resultado.criado_por_nome Nome completo da entidade que criou originalmente o arquivo de anexo.

Tipo de dados: cadeia de caracteres
resultado.download_link URL de download do anexo na instância ServiceNow.

Tipo de dados: cadeia de caracteres
resultado.file_name Nome do arquivo do anexo.

Tipo de dados: cadeia de caracteres
resultado.imagem_altura Se for um arquivo de imagem, a altura da imagem.

Tipo de dados: cadeia de caracteres

Unidade: pixels
resultado.image_width Se for um arquivo de imagem, a largura da imagem.

Tipo de dados: cadeia de caracteres

Unidade: pixels
resultado.tamanho_bytes Tamanho do anexo.

Tipo de dados: cadeia de caracteres

Unidade: bytes
resultado.tamanho_compactado Tamanho do arquivo de anexo compactado. Se o arquivo não estiver compactado, vazio.

Tipo de dados: cadeia de caracteres

Unidade: bytes
resultado.sys_created_by Entidade que criou originalmente o arquivo de anexo.

Tipo de dados: cadeia de caracteres
resultado.sys_created_on Data e hora em que o arquivo de anexo foi salvo inicialmente na instância.

Tipo de dados: cadeia de caracteres
resultado.sys_id Sys_id do arquivo de anexo.

Tipo de dados: cadeia de caracteres
resultado.sys_mod_count Número de vezes que o arquivo de anexo foi modificado (carregado para a instância).

Tipo de dados: cadeia de caracteres
resultado.sys_tags Quaisquer marcadores do sistema associados ao arquivo de anexo.

Tipo de dados: cadeia de caracteres
resultado.sys_updated_by Entidade que atualizou o arquivo de anexo pela última vez.

Tipo de dados: cadeia de caracteres
resultado.sys_updated_on Data e hora em que o arquivo de anexo foi atualizado pela última vez.

Tipo de dados: cadeia de caracteres
resultado.table_name Nome da tabela à qual o anexo está associado.

Tipo de dados: cadeia de caracteres
result.table_sys_id Sys_id da tabela associada ao anexo.

Tipo de dados: cadeia de caracteres
resultado.atualizado_por_nome Nome completo da entidade que atualizou o arquivo de anexo pela última vez.

Tipo de dados: cadeia de caracteres

Valores obrigatórios de várias partes de POST

Ao enviar uma solicitação POST de várias partes para carregar um anexo de arquivo, inclua os dados do anexo no corpo da mensagem, não nos parâmetros de URL. Você deve especificar estes valores no corpo da mensagem:
Tabela 37. Valores obrigatórios
Valor Descrição
Tipo de conteúdo Tipo de conteúdo do arquivo, incluído no corpo da mensagem para carregamentos de várias partes.
Nota: O tipo de conteúdo deve ser definido na parte do arquivo da mensagem POST, não nos dados do formulário. Consulte a amostra de mensagem multipartes POST para obter um exemplo de uma mensagem multipartes.

Tipo de dados: cadeia de caracteres
table_name Nome da tabela à qual você deseja anexar o arquivo.

Tipo de dados: cadeia de caracteres
table_sys_id Sys_id do registro na tabela especificada à qual você deseja anexar o arquivo.

Tipo de dados: cadeia de caracteres

Exemplo: Solicitação de cURL

curl "https://instance.servicenow.com/api/now/attachment/upload" \
--request POST \
--header "Accept:application/json"\
--user "username":"password"\
--header "Content-Type:multipart/form-data"\
 -F 'table_name=incident' \
 -F 'table_sys_id=d71f7935c0a8016700802b64c67c11c6'\
 -F 'uploadFile=@ location of the file on file system'
\
{
  "result": {
    "table_sys_id": "d71f7935c0a8016700802b64c67c11c6",
    "size_bytes": "36597",
    "download_link": "https://instance.service-now.com/api/now/attachment/994adbc64f511200adf9f8e18110c796/file",
    "sys_updated_on": "2016-02-02 14:00:21",
    "sys_id": "994adbc64f511200adf9f8e18110c796",
    "image_height": "",
    "sys_created_on": "2016-02-02 14:00:21",
    "file_name": "banner-CS0001345_v1_1.jpeg",
    "sys_created_by": "admin",
    "compressed": "true",
    "average_image_color": "",
    "sys_updated_by": "admin",
    "sys_tags": "",
    "table_name": "incident",
    "image_width": "",
    "sys_mod_count": "0",
    "content_type": "image/jpeg",
    "size_compressed": "25130"
  }
}