API de anexos

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}

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.

Tabela 6. Códigos de status

Código de status	Descrição
204	Indica que a solicitação foi executada com sucesso.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
404	Não encontrado. O item solicitado não foi encontrado.
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
Nenhum(a)

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

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 em 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 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	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.
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 de 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.

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

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.

Tabela 18. Códigos de status

Código de status	Descrição
200	Bem-sucedido. A solicitação foi processada com sucesso.
400	Solicitação Incorreta. Foi detectado um tipo de solicitação incorreto ou solicitação malformada.
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
Anexo de arquivo binário

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ões: /api/now/v1/attachment/{sys_id}

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

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.

Tabela 24. Códigos de status

Código de 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.
404	Indica que o anexo especificado não existe ou que o usuário atual não pode acessá-lo.
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
Metadados específicos para o anexo especificado.

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

Parâmetros de solicitação compatíveis

Tabela 25. Parâmetros de caminho

Nome	Descrição
Nenhum(a)

Tabela 26. Parâmetros de consulta

Nome	Descrição
criptografia_contexto	Sys_id de um registro de contexto de criptografia. Especifique este parâmetro para permitir que somente usuários com o contexto de criptografia especificado acessem o anexo. Para obter informações adicionais sobre registros de contexto de criptografia, consulte Column Level Encryption. Tipo de dados: cadeia de caracteres Padrão: o arquivo é criptografado usando o contexto de criptografia acessível ao usuário, caso contrário, o arquivo anexado não será criptografado com nenhum contexto de criptografia.
file_name	Obrigatório. Nome para dar ao anexo. Tipo de dados: cadeia de caracteres
table_name	Obrigatório. Nome da tabela à qual o arquivo será anexado. Tipo de dados: cadeia de caracteres
table_sys_id	Obrigatório. Sys_id do registro na tabela especificada em table_name ao qual você deseja anexar o arquivo. Tipo de dados: cadeia de caracteres

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.

Tabela 30. Códigos de status

Código de status	Descrição
201	Indica que a consulta foi executada com sucesso.
400	Indica que um ou mais parâmetros obrigatórios estavam ausentes na solicitação.
404	Indica que o registro especificado pelos parâmetros table_name e table_sys_id não existe ou não está acessível para o usuário atual.
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)

Elemento	Descriçã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 válidos: 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.nome_do_arquivo	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

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

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.

Tabela 36. Códigos de status

Código de status	Descrição
201	Indica que a consulta foi executada com sucesso.
400	Solicitação Incorreta. Foi detectado um tipo de solicitação incorreto ou solicitação malformada.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
404	Não encontrado. O item solicitado não foi encontrado.
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)

Elemento	Descriçã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 válidos: 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.nome_do_arquivo	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

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"
  }
}