---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# API de anexos

# API de anexos {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 16 min. de leitura

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 {#c_AttachmentAPI__section_tby_gn1_xhb}

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} {#ariaid-title2}

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

### Formato da URL {#attachment-DELETE__section_xl1_kft_2mb}

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

{#attachment-DELETE__entry__2}

| Nome | Descrição |
|-|-|
| sys_id | Valor de Sys_id do anexo a ser excluído. Tipo de dados: cadeia de caracteres |
[Tabela 1. Parâmetros de caminho]

{#attachment-DELETE__entry__6}

| Nome | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 2. Parâmetros de consulta]

{#attachment-DELETE__entry__10}

| Nome | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 3. Parâmetros do corpo da solicitação (XML ou JSON)]

### 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](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles.").
{#attachment-DELETE__entry__14}

| Cabeçalho | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 4. Cabeçalhos da solicitação]

{#attachment-DELETE__entry__18}

| Cabeçalho | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 5. Cabeçalhos de resposta]

### 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](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles.").
{#attachment-DELETE__entry__22}{#attachment-DELETE__entry-401-status-code}{#attachment-DELETE__entry-404-status-code}{#attachment-DELETE__entry-500-status-code}

| 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. |
[Tabela 6. Códigos de status]

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

{#attachment-DELETE__entry__32}

| 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 {#ariaid-title3}

Retorna os metadados de vários anexos.

### Formato da URL {#attachment-GET__section_efx_gw4_dmb}

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

URL padrão: api/now/attachment

### Parâmetros de solicitação compatíveis

{#attachment-GET__entry__2}

| Nome | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 7. Parâmetros de caminho]

{#attachment-GET__entry__6}{#attachment-GET__row_sysparm_offset}

| 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 8. Parâmetros de consulta]

{#attachment-GET__entry__14}

| Nome | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 9. Parâmetros do corpo da solicitação (XML ou JSON)]

### 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](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles.").
{#attachment-GET__entry__18}{#attachment-GET__accept-RESTAPI}

| 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 10. Cabeçalhos da solicitação]

{#attachment-GET__entry__22}

| 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. |
[Tabela 11. Cabeçalhos de resposta]

### 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](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles.").
{#attachment-GET__entry__28}{#attachment-GET__entry-200-status-code}{#attachment-GET__entry-401-status-code}{#attachment-GET__entry-500-status-code}

| 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. |
[Tabela 12. Códigos de status]

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

{#attachment-GET__entry__36}

| 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 {#ariaid-title4}

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

### Formato da URL {#attachment-GET-file__section_apn_ybk_2mb}

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

{#attachment-GET-file__entry__2}

| Nome | Descrição |
|-|-|
| sys_id | Sys_id do registro de anexo do qual os dados binários serão retornados. |
[Tabela 13. Parâmetros de caminho]

{#attachment-GET-file__entry__6}

| Nome | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 14. Parâmetros de consulta]

{#attachment-GET-file__entry__10}

| Nome | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 15. Parâmetros do corpo da solicitação (XML ou JSON)]

### 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](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles.").
{#attachment-GET-file__entry__14}

| 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 16. Cabeçalhos da solicitação]

{#attachment-GET-file__entry__18}

| Cabeçalho | Descrição |
|-|-|
| X-Anexo-Metadados | Metadados sobre o arquivo retornado, como tamanho, nome e tipo de arquivo. |
[Tabela 17. Cabeçalhos de resposta]

### 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](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles.").
{#attachment-GET-file__entry__22}{#attachment-GET-file__entry-200-status-code}{#attachment-GET-file__entry-400-status-code}{#attachment-GET-file__entry-401-status-code}{#attachment-GET-file__entry-500-status-code}

| 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. |
[Tabela 18. Códigos de status]

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

{#attachment-GET-file__entry__32}

| 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} {#ariaid-title5}

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

### Formato da URL {#attachment-GET-sys_id__section_wmy_pyj_2mb}

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

{#attachment-GET-sys_id__entry__2}

| Nome | Descrição |
|-|-|
| sys_id | Sys_id do registro de anexo para o qual os metadados serão recuperados. |
[Tabela 19. Parâmetros de caminho]

{#attachment-GET-sys_id__entry__6}

| Nome | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 20. Parâmetros de consulta]

{#attachment-GET-sys_id__entry__10}

| Nome | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 21. Parâmetros do corpo da solicitação (XML ou JSON)]

### 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](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles.").
{#attachment-GET-sys_id__entry__14}{#attachment-GET-sys_id__accept-RESTAPI}

| 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 22. Cabeçalhos da solicitação]

{#attachment-GET-sys_id__entry__18}

| 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. |
[Tabela 23. Cabeçalhos de resposta]

### 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](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles.").
{#attachment-GET-sys_id__entry__22}{#attachment-GET-sys_id__entry-200-status-code}{#attachment-GET-sys_id__entry-401-status-code}{#attachment-GET-sys_id__entry-500-status-code}

| 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. |
[Tabela 24. Códigos de status]

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

{#attachment-GET-sys_id__entry__32}

| 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 {#ariaid-title6}

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 {#attachment-POST-file__section_phs_45s_2mb}

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

{#attachment-POST-file__entry__2}

| Nome | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 25. Parâmetros de caminho]

{#attachment-POST-file__entry__6}

| 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](https://www.servicenow.com/docs/access?context=column-level-encryption-landing&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US). 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 26. Parâmetros de consulta]

{#attachment-POST-file__entry__16}

| Nome | Descrição |
|-|-|
| \<String\> | Caminho para o arquivo binário a ser anexado ao registro especificado. |
[Tabela 27. Parâmetros do corpo da solicitação (XML ou JSON)]

### 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](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles.").
{#attachment-POST-file__entry__20}{#attachment-POST-file__accept-RESTAPI}

| 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 28. Cabeçalhos da solicitação]

{#attachment-POST-file__entry__26}

| Cabeçalho | Descrição |
|-|-|
| Local | URL do novo anexo. |
[Tabela 29. Cabeçalhos de resposta]

### 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](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles.").
{#attachment-POST-file__entry__30}{#attachment-POST-file__entry-500-status-code}

| 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. |
[Tabela 30. Códigos de status]

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

{#attachment-POST-file__table_kbr_qck_llb__entry__2}

| 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. {#attachment-POST-file__ul_ev1_fmk_jlb} 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 |
[ ]

{#attachment-POST-file__table_kbr_qck_llb}  

### 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 {#ariaid-title7}

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 {#attachment-POST-upload__section_jby_v2t_2mb}

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

{#attachment-POST-upload__entry__2}

| Nome | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 31. Parâmetros de caminho]

{#attachment-POST-upload__entry__6}

| Nome | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 32. Parâmetros de consulta]

{#attachment-POST-upload__entry__10}

| Nome | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 33. Parâmetros do corpo da solicitação (XML ou JSON)]

### 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](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles.").
{#attachment-POST-upload__entry__14}{#attachment-POST-upload__accept-RESTAPI}

| 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 34. Cabeçalhos da solicitação]

{#attachment-POST-upload__entry__20}

| Cabeçalho | Descrição |
|-|-|
| Local | URL do novo anexo. |
[Tabela 35. Cabeçalhos de resposta]

### 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](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles.").
{#attachment-POST-upload__entry__24}{#attachment-POST-upload__entry-400-status-code}{#attachment-POST-upload__entry-401-status-code}{#attachment-POST-upload__entry-404-status-code}{#attachment-POST-upload__entry-500-status-code}

| 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. |
[Tabela 36. Códigos de status]

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

{#attachment-POST-upload__table_bbj_pfk_llb__entry__2}

| 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. {#attachment-POST-upload__ul_ev1_fmk_jlb} 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 |
[ ]

{#attachment-POST-upload__table_bbj_pfk_llb}

### Valores obrigatórios de várias partes de POST {#attachment-POST-upload__section_tk4_1ft_2mb}

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:{#attachment-POST-upload__table_p1v_nnj_js__entry__2}

| 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 |
[Tabela 37. Valores obrigatórios]

{#attachment-POST-upload__table_p1v_nnj_js}  

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