---
sourceDocument: Xanadu API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ko-KR

ft:publication_title :

    - Xanadu API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# 첨부 파일 API

# 첨부 파일 API {#ariaid-title1}

* 릴리스 버전: Xanadu
* 
* 업데이트 날짜 2024년 08월 01일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 26분

첨부 파일 API는 첨부 파일을 업로드하고 쿼리할 수 있는 엔드포인트를 제공합니다.

각 요청과 함께 단일 파일을 업로드하거나 검색할 수 있습니다.

첨부 파일 API는 업로드된 파일에 대한 시스템 제한(예: 최대 파일 크기 및 허용되는 첨부 파일 유형)을 준수합니다. 기본적으로 1024MB 및 com.glide.attachment.max_sizeglide.attachment.extensions.  
주:  
첨부 파일 API는 모든 Content-Type 값(\*/\*)을 허용합니다. 첨부 파일을 업로드할 때 파일 컨텐츠 유형을 지정합니다. 콘텐츠 형식은 파일 메타데이터와 함께 저장되므로 다른 도구에서 파일을 올바르게 식별하고 구문 분석할 수 있습니다.

다음 비디오는 첨부 파일 API에 대한 자세한 정보를 제공합니다.


## 첨부 파일 API 역할 요구 사항 {#c_AttachmentAPI__section_tby_gn1_xhb}

첨부 파일을 만들려면 HTTP 요청을 ServiceNow 인증하는 데 사용되는 사용자 기록에 첨부 파일 \[sys_attachment\] 기록을 만드는 데 필요한 역할이 있어야 합니다. 또한 인시던트 기록에 첨부 파일을 추가하는 itil 역할과 같이 대상 테이블에서 기록을 읽고 쓰는 데 필요한 역할이 있어야 합니다.

기본적으로 사용자가 첨부 파일을 추가할 수 있는 단일 역할은 없습니다. 첨부 파일 추가를 명시적으로 허용하는 역할을 생성한 다음, 요청에 사용되는 사용자 계정에 이 역할을 할당할 수 있습니다.

## 첨부 파일 - DELETE /now/attachment/{sys_id} {#ariaid-title2}

이 메서드는 특정 sys_id 값을 가진 첨부 파일을 삭제합니다.

### URL 형식 {#attachment-DELETE__section_xl1_kft_2mb}

버전이 지정된 URL: /api/now/v1/attachment/{sys_id}

기본 URL: /api/now/attachment/{sys_id}

### 지원되는 요청 매개변수

{#attachment-DELETE__entry__2}

| 이름 | 설명 |
|-|-|
| sys_id | 삭제할 첨부 파일의 Sys_id 값입니다. 데이터 유형: 문자열 |
[표 1. 경로 매개변수]

{#attachment-DELETE__entry__6}

| 이름 | 설명 |
|-|-|
| 없음 |   |
[표 2. 쿼리 매개변수]

{#attachment-DELETE__entry__10}

| 이름 | 설명 |
|-|-|
| 없음 |   |
[표 3. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에서 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를](https://servicenow-prod.fluidtopics.net/JHL64oGR2SkU25ZTkfHy7g "REST(REpresentational State Transfer)는 웹상의 컴퓨터 시스템 간에 표준을 제공하여 서로 보다 쉽게 통신할 수 있게 지원하는 단순한 상태 비저장 아키텍처입니다.") 참조하세요.
{#attachment-DELETE__entry__14}

| 헤더 | 설명 |
|-|-|
| 없음 |   |
[표 4. 요청 헤더]

{#attachment-DELETE__entry__18}

| 헤더 | 설명 |
|-|-|
| 없음 |   |
[표 5. 응답 헤더]

### 상태 코드

다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용할 수 있는 상태 코드 목록은 [REST API HTTP 응답 코드를](https://servicenow-prod.fluidtopics.net/JHL64oGR2SkU25ZTkfHy7g "REST(REpresentational State Transfer)는 웹상의 컴퓨터 시스템 간에 표준을 제공하여 서로 보다 쉽게 통신할 수 있게 지원하는 단순한 상태 비저장 아키텍처입니다.") 참조하세요.
{#attachment-DELETE__entry__22}{#attachment-DELETE__entry-401-status-code}{#attachment-DELETE__entry-404-status-code}{#attachment-DELETE__entry-500-status-code}

| 상태 코드 | 설명 |
|-|-|
| 204 | 요청이 성공적으로 실행되었음을 나타냅니다. |
| 401 | 승인되지 않았습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 6. 상태 코드]

### 응답 본문 매개변수(JSON 또는 XML)

{#attachment-DELETE__entry__32}

| 이름 | 설명 |
|-|-|
| 없음 |   |
[ ]

### cURL 요청

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

    ""

## 첨부 파일 - GET /now/attachment {#ariaid-title3}

여러 첨부 파일에 대한 메타데이터를 반환합니다.

### URL 형식 {#attachment-GET__section_efx_gw4_dmb}

버전이 지정된 URL: api/now/v1/attachment

기본 URL: api/now/attachment

### 지원되는 요청 매개변수

{#attachment-GET__entry__2}

| 이름 | 설명 |
|-|-|
| 없음 |   |
[표 7. 경로 매개변수]

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

| 이름 | 설명 |
|-|-|
| sysparm_limit | 페이지 매김에 적용할 제한입니다. 주: `sysparm_limit` 값이 비정상적으로 크면 시스템 성능에 영향을 줄 수 있습니다. 데이터 유형: 문자열 기본값: 1000 |
| sysparm_offset | 쿼리에서 제외할 기록 수입니다. 이 매개변수를 사용하여 `sysparm_limit`에 지정된 것보다 많은 기록을 가져옵니다. 예를 들어 `sysparm_limit` 500으로 설정되어 있지만 쿼리하려는 추가 레코드가 있는 경우 `sysparm_offset` 값 500을 지정하여 두 번째 레코드 집합을 가져올 수 있습니다. 데이터 유형: 문자열 기본값: 0 |
| sysparm_query | 인코딩된 쿼리입니다. 첨부 파일 API에 대한 쿼리는 첨부 파일 \[sys_attachment\] 테이블을 기준으로 합니다. 예: (sysparm_query=file_name=attachment.doc) 인코딩된 쿼리는 order by를 지원합니다. 특정 필드를 기준으로 응답을 정렬하려면 sysparm_query에서 ORDERBY 및 ORDERBYDESC 절을 사용합니다. 예를 들어 `sysparm_query=ORDERBYfile_name^ORDERBYDESCtable_Name` 는 먼저 이름을 기준으로 결과를 오름차순으로 정렬한 다음 테이블 이름을 기준으로 내림차순으로 정렬합니다. 데이터 유형: 문자열 |
[표 8. 쿼리 매개변수]

{#attachment-GET__entry__14}

| 이름 | 설명 |
|-|-|
| 없음 |   |
[표 9. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에서 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를](https://servicenow-prod.fluidtopics.net/JHL64oGR2SkU25ZTkfHy7g "REST(REpresentational State Transfer)는 웹상의 컴퓨터 시스템 간에 표준을 제공하여 서로 보다 쉽게 통신할 수 있게 지원하는 단순한 상태 비저장 아키텍처입니다.") 참조하세요.
{#attachment-GET__entry__18}{#attachment-GET__accept-RESTAPI}

| 헤더 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
[표 10. 요청 헤더]

{#attachment-GET__entry__22}

| 헤더 | 설명 |
|-|-|
| 컨텐츠-형식 | 응답의 콘텐츠 유형입니다. 메타데이터 요청의 경우 첨부 파일의 콘텐츠 유형이 아니라 메타데이터의 콘텐츠 유형입니다. |
| 링크 | 첨부 파일을 다운로드하는 링크. |
[표 11. 응답 헤더]

### 상태 코드

다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용할 수 있는 상태 코드 목록은 [REST API HTTP 응답 코드를](https://servicenow-prod.fluidtopics.net/JHL64oGR2SkU25ZTkfHy7g "REST(REpresentational State Transfer)는 웹상의 컴퓨터 시스템 간에 표준을 제공하여 서로 보다 쉽게 통신할 수 있게 지원하는 단순한 상태 비저장 아키텍처입니다.") 참조하세요.
{#attachment-GET__entry__28}{#attachment-GET__entry-200-status-code}{#attachment-GET__entry-401-status-code}{#attachment-GET__entry-500-status-code}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 401 | 승인되지 않았습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 12. 상태 코드]

### 응답 본문 매개변수(JSON 또는 XML)

{#attachment-GET__entry__36}

| 이름 | 설명 |
|-|-|
| 반환되는 정보는 선택한 첨부 파일에 따라 다릅니다. |   |
[ ]

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

## 첨부 파일 - GET /now/attachment/{sys_id}/file {#ariaid-title4}

특정 sys_id 값이 있는 이진 첨부 파일을 반환합니다.

### URL 형식 {#attachment-GET-file__section_apn_ybk_2mb}

버전이 지정된 URL: /api/now/v1/attachment/{sys_id}/file

기본 URL: /api/now/attachment/{sys_id}/file

### 지원되는 요청 매개변수

{#attachment-GET-file__entry__2}

| 이름 | 설명 |
|-|-|
| sys_id | 이진 데이터를 반환할 첨부 파일 기록의 Sys_id입니다. |
[표 13. 경로 매개변수]

{#attachment-GET-file__entry__6}

| 이름 | 설명 |
|-|-|
| 없음 |   |
[표 14. 쿼리 매개변수]

{#attachment-GET-file__entry__10}

| 이름 | 설명 |
|-|-|
| 없음 |   |
[표 15. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에서 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를](https://servicenow-prod.fluidtopics.net/JHL64oGR2SkU25ZTkfHy7g "REST(REpresentational State Transfer)는 웹상의 컴퓨터 시스템 간에 표준을 제공하여 서로 보다 쉽게 통신할 수 있게 지원하는 단순한 상태 비저장 아키텍처입니다.") 참조하세요.
{#attachment-GET-file__entry__14}

| 헤더 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 예를 들어 `image/jpeg` 또는 `image/png` 를 사용하여 JPEG 또는 PNG 이미지 파일만 허용합니다. 모든 이미지 유형을 허용하려면 `image/*`를 지정합니다. 모든 파일 형식을 허용하려면 `*/*`를 지정합니다. 기본값:\*/\* |
[표 16. 요청 헤더]

{#attachment-GET-file__entry__18}

| 헤더 | 설명 |
|-|-|
| X-첨부 파일-메타데이터 | 반환된 파일에 대한 메타데이터(예: 크기, 이름 및 파일 형식)입니다. |
[표 17. 응답 헤더]

### 상태 코드

다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용할 수 있는 상태 코드 목록은 [REST API HTTP 응답 코드를](https://servicenow-prod.fluidtopics.net/JHL64oGR2SkU25ZTkfHy7g "REST(REpresentational State Transfer)는 웹상의 컴퓨터 시스템 간에 표준을 제공하여 서로 보다 쉽게 통신할 수 있게 지원하는 단순한 상태 비저장 아키텍처입니다.") 참조하세요.
{#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}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. |
| 401 | 승인되지 않았습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 18. 상태 코드]

### 응답 본문 매개변수(JSON 또는 XML)

{#attachment-GET-file__entry__32}

| 이름 | 설명 |
|-|-|
| 이진 파일 첨부 |   |
[ ]

### cURL 요청

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

    Binary response not shown.

## 첨부 파일 - GET /now/attachment/{sys_id} {#ariaid-title5}

특정 sys_id 값이 있는 첨부 파일에 대한 메타데이터를 반환합니다.

### URL 형식 {#attachment-GET-sys_id__section_wmy_pyj_2mb}

버전이 지정된 URL: /api/now/v1/attachment/{sys_id}

기본 URL: /api/now/attachment/{sys_id}

### 지원되는 요청 매개변수

{#attachment-GET-sys_id__entry__2}

| 이름 | 설명 |
|-|-|
| sys_id | 메타데이터를 검색할 첨부 파일 기록의 Sys_id입니다. |
[표 19. 경로 매개변수]

{#attachment-GET-sys_id__entry__6}

| 이름 | 설명 |
|-|-|
| 없음 |   |
[표 20. 쿼리 매개변수]

{#attachment-GET-sys_id__entry__10}

| 이름 | 설명 |
|-|-|
| 없음 |   |
[표 21. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에서 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를](https://servicenow-prod.fluidtopics.net/JHL64oGR2SkU25ZTkfHy7g "REST(REpresentational State Transfer)는 웹상의 컴퓨터 시스템 간에 표준을 제공하여 서로 보다 쉽게 통신할 수 있게 지원하는 단순한 상태 비저장 아키텍처입니다.") 참조하세요.
{#attachment-GET-sys_id__entry__14}{#attachment-GET-sys_id__accept-RESTAPI}

| 헤더 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
[표 22. 요청 헤더]

{#attachment-GET-sys_id__entry__18}

| 헤더 | 설명 |
|-|-|
| 컨텐츠-형식 | 응답의 콘텐츠 유형입니다. 메타데이터 요청의 경우 첨부 파일의 콘텐츠 유형이 아니라 메타데이터의 콘텐츠 유형입니다. |
[표 23. 응답 헤더]

### 상태 코드

다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용할 수 있는 상태 코드 목록은 [REST API HTTP 응답 코드를](https://servicenow-prod.fluidtopics.net/JHL64oGR2SkU25ZTkfHy7g "REST(REpresentational State Transfer)는 웹상의 컴퓨터 시스템 간에 표준을 제공하여 서로 보다 쉽게 통신할 수 있게 지원하는 단순한 상태 비저장 아키텍처입니다.") 참조하세요.
{#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}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 401 | 승인되지 않았습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 404 | 지정된 첨부 파일이 없거나 현재 사용자가 액세스할 수 없음을 나타냅니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 24. 상태 코드]

### 응답 본문 매개변수(JSON 또는 XML)

{#attachment-GET-sys_id__entry__32}

| 이름 | 설명 |
|-|-|
| 지정된 첨부 파일과 관련된 메타데이터입니다. |   |
[ ]

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

## 첨부 파일 - POST /now/attachment/file {#ariaid-title6}

지정된 이진 파일을 지정된 기록에 첨부 파일로 업로드합니다.
주:  
첨부할 파일은 전달된 요청 매개변수 목록의 마지막 매개변수 뒤에 지정되어야 합니다.

### URL 형식 {#attachment-POST-file__section_phs_45s_2mb}

버전이 지정된 URL: /api/now/v1/attachment/file

기본 URL: /api/now/attachment/file

### 지원되는 요청 매개변수

{#attachment-POST-file__entry__2}

| 이름 | 설명 |
|-|-|
| 없음 |   |
[표 25. 경로 매개변수]

{#attachment-POST-file__entry__6}

| 이름 | 설명 |
|-|-|
| encryption_context | 암호화 컨텍스트 기록의 Sys_id입니다. 지정된 암호화 컨텍스트를 가진 사용자만 첨부 파일에 접근할 수 있도록 하려면 이 매개변수를 지정하십시오. 암호화 컨텍스트 기록에 대한 자세한 내용은 다음 문서를 참조하십시오 [Column Level Encryption](https://www.servicenow.com/docs/access?context=column-level-encryption-landing&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US). 데이터 유형: 문자열 기본적으로 파일은 사용자가 액세스할 수 있는 암호화 컨텍스트를 사용하여 암호화되며, 그렇지 않으면 첨부 파일이 암호화 컨텍스트로 암호화되지 않습니다. |
| file_name | 필수 첨부 파일을 지정할 이름입니다. 데이터 유형: 문자열 |
| table_name | 필수 파일을 첨부할 테이블의 이름입니다. 데이터 유형: 문자열 |
| table_sys_id | 필수 파일을 첨부하려는 지정된 table_name 테이블의 기록 Sys_id입니다. 데이터 유형: 문자열 |
[표 26. 쿼리 매개변수]

{#attachment-POST-file__entry__16}

| 이름 | 설명 |
|-|-|
| \<문자열\> | 지정된 기록에 첨부할 이진 파일의 경로입니다. |
[표 27. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에서 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를](https://servicenow-prod.fluidtopics.net/JHL64oGR2SkU25ZTkfHy7g "REST(REpresentational State Transfer)는 웹상의 컴퓨터 시스템 간에 표준을 제공하여 서로 보다 쉽게 통신할 수 있게 지원하는 단순한 상태 비저장 아키텍처입니다.") 참조하세요.
{#attachment-POST-file__entry__20}{#attachment-POST-file__accept-RESTAPI}

| 헤더 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
| 컨텐츠-형식 | 첨부할 파일의 컨텐츠 유형입니다(예: image/jpeg 또는 \*/\*). 이 헤더는 첨부 파일을 게시하는 데 필수입니다. |
[표 28. 요청 헤더]

{#attachment-POST-file__entry__26}

| 헤더 | 설명 |
|-|-|
| 위치 | 새 첨부 파일의 URL입니다. |
[표 29. 응답 헤더]

### 상태 코드

다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용할 수 있는 상태 코드 목록은 [REST API HTTP 응답 코드를](https://servicenow-prod.fluidtopics.net/JHL64oGR2SkU25ZTkfHy7g "REST(REpresentational State Transfer)는 웹상의 컴퓨터 시스템 간에 표준을 제공하여 서로 보다 쉽게 통신할 수 있게 지원하는 단순한 상태 비저장 아키텍처입니다.") 참조하세요.
{#attachment-POST-file__entry__30}{#attachment-POST-file__entry-500-status-code}

| 상태 코드 | 설명 |
|-|-|
| 201 | 쿼리가 성공적으로 실행되었음을 나타냅니다. |
| 400 | 요청에서 하나 이상의 필수 매개변수가 누락되었음을 나타냅니다. |
| 404 | 및 table_sys_id 매개변수로 table_name 지정된 기록이 없거나 현재 사용자가 액세스할 수 없음을 나타냅니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 30. 상태 코드]

### 응답 본문 매개변수(JSON 또는 XML)

{#attachment-POST-file__table_kbr_qck_llb__entry__2}

| 요소 | 설명 |
|-|-|
| 결과 | 요청된 첨부 파일의 메타데이터입니다. 데이터 유형: 객체 "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" } |
| result.average_image_color | 첨부 파일이 이미지인 경우 모든 색상의 합계입니다. 데이터 유형: 문자열 단위: RGB 또는 픽셀 수. |
| result.compressed | 첨부 파일이 압축되었는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 파일이 압축되었습니다. * false: 파일이 압축되지 않았습니다. {#attachment-POST-file__ul_ev1_fmk_jlb} 데이터 유형: 문자열 |
| result.content_type | 연결된 첨부 파일의 콘텐츠 유형(예: image 또는 jpeg 또는 application/x-shockwave-flash)입니다. 데이터 유형: 문자열 |
| result.created_by_name | 첨부 파일을 처음 생성한 엔터티의 전체 이름입니다. 데이터 유형: 문자열 |
| result.download_link | 인스턴스에 있는 첨부 파일의 URL을 다운로드합니다 ServiceNow . 데이터 유형: 문자열 |
| result.file_name | 첨부 파일의 이름입니다. 데이터 유형: 문자열 |
| result.image_height | 이미지 파일인 경우 이미지의 높이입니다. 데이터 유형: 문자열 단위: 픽셀 |
| result.image_width | 이미지 파일인 경우 이미지의 너비입니다. 데이터 유형: 문자열 단위: 픽셀 |
| result.size_bytes | 첨부 파일의 크기입니다. 데이터 유형: 문자열 단위: 바이트 |
| result.size_compressed | 압축된 첨부 파일의 크기입니다. 파일이 압축되지 않은 경우 비어 있습니다. 데이터 유형: 문자열 단위: 바이트 |
| result.sys_created_by 님 | 첨부 파일을 처음 만든 엔터티입니다. 데이터 유형: 문자열 |
| result.sys_created_on | 첨부 파일이 인스턴스에 처음 저장된 날짜 및 시간입니다. 데이터 유형: 문자열 |
| result.sys_id | 첨부 파일의 Sys_id입니다. 데이터 유형: 문자열 |
| result.sys_mod_count | 첨부 파일이 수정된(인스턴스에 업로드된) 횟수입니다. 데이터 유형: 문자열 |
| result.sys_tags | 첨부 파일과 연결된 시스템 태그입니다. 데이터 유형: 문자열 |
| result.sys_업데이트_기준 | 첨부 파일을 마지막으로 업데이트한 엔터티입니다. 데이터 유형: 문자열 |
| result.sys_updated_on | 첨부 파일이 마지막으로 업데이트된 날짜 및 시간입니다. 데이터 유형: 문자열 |
| result.table_name | 첨부 파일이 연결된 테이블의 이름입니다. 데이터 유형: 문자열 |
| result.table_sys_id | 첨부 파일과 연결된 테이블의 Sys_id입니다. 데이터 유형: 문자열 |
| result.updated_by_name | 첨부 파일을 마지막으로 업데이트한 엔터티의 전체 이름입니다. 데이터 유형: 문자열 |
[ ]

{#attachment-POST-file__table_kbr_qck_llb}  

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

## 첨부 파일 - POST /now/attachment/upload {#ariaid-title7}

멀티파트 첨부 파일을 업로드합니다.
multipart POST 메서드는 매개 변수를 허용하지 않습니다. 테이블 이름을 지정하고 양식 본문 내에서 sys_id 값을 기록해야 합니다. multipart/form-data 요청 샘플은 cURL 예제를 참조하세요.  
중요사항:  
멀티파트 POST를 사용하는 경우 파일 내용이 메시지의 마지막 부분에만 포함되어 있는지 확인합니다. 이전 부분에는 테이블 이름 및 기록 sys_id와 같은 메타데이터만 포함되어야 했습니다.

### URL 형식 {#attachment-POST-upload__section_jby_v2t_2mb}

버전이 지정된 URL: /api/now/v1/attachment/upload

기본 URL: /api/now/attachment/upload

### 지원되는 요청 매개변수

{#attachment-POST-upload__entry__2}

| 이름 | 설명 |
|-|-|
| 없음 |   |
[표 31. 경로 매개변수]

{#attachment-POST-upload__entry__6}

| 이름 | 설명 |
|-|-|
| 없음 |   |
[표 32. 쿼리 매개변수]

{#attachment-POST-upload__entry__10}

| 이름 | 설명 |
|-|-|
| 없음 |   |
[표 33. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에서 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를](https://servicenow-prod.fluidtopics.net/JHL64oGR2SkU25ZTkfHy7g "REST(REpresentational State Transfer)는 웹상의 컴퓨터 시스템 간에 표준을 제공하여 서로 보다 쉽게 통신할 수 있게 지원하는 단순한 상태 비저장 아키텍처입니다.") 참조하세요.
{#attachment-POST-upload__entry__14}{#attachment-POST-upload__accept-RESTAPI}

| 헤더 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
| 컨텐츠-형식 | 요청의 콘텐츠 유형입니다. multipart POST 메서드를 사용할 때 이 값을 multipart/form-data로 설정합니다. |
[표 34. 요청 헤더]

{#attachment-POST-upload__entry__20}

| 헤더 | 설명 |
|-|-|
| 위치 | 새 첨부 파일의 URL입니다. |
[표 35. 응답 헤더]

### 상태 코드

다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용할 수 있는 상태 코드 목록은 [REST API HTTP 응답 코드를](https://servicenow-prod.fluidtopics.net/JHL64oGR2SkU25ZTkfHy7g "REST(REpresentational State Transfer)는 웹상의 컴퓨터 시스템 간에 표준을 제공하여 서로 보다 쉽게 통신할 수 있게 지원하는 단순한 상태 비저장 아키텍처입니다.") 참조하세요.
{#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}

| 상태 코드 | 설명 |
|-|-|
| 201 | 쿼리가 성공적으로 실행되었음을 나타냅니다. |
| 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. |
| 401 | 승인되지 않았습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 36. 상태 코드]

### 응답 본문 매개변수(JSON 또는 XML)

{#attachment-POST-upload__table_bbj_pfk_llb__entry__2}

| 요소 | 설명 |
|-|-|
| 결과 | 요청된 첨부 파일의 메타데이터입니다. 데이터 유형: 객체 "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" } |
| result.average_image_color | 첨부 파일이 이미지인 경우 모든 색상의 합계입니다. 데이터 유형: 문자열 단위: RGB 또는 픽셀 수. |
| result.compressed | 첨부 파일이 압축되었는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 파일이 압축되었습니다. * false: 파일이 압축되지 않았습니다. {#attachment-POST-upload__ul_ev1_fmk_jlb} 데이터 유형: 문자열 |
| result.content_type | 연결된 첨부 파일의 콘텐츠 유형(예: image 또는 jpeg 또는 application/x-shockwave-flash)입니다. 데이터 유형: 문자열 |
| result.created_by_name | 첨부 파일을 처음 생성한 엔터티의 전체 이름입니다. 데이터 유형: 문자열 |
| result.download_link | 인스턴스에 있는 첨부 파일의 URL을 다운로드합니다 ServiceNow . 데이터 유형: 문자열 |
| result.file_name | 첨부 파일의 이름입니다. 데이터 유형: 문자열 |
| result.image_height | 이미지 파일인 경우 이미지의 높이입니다. 데이터 유형: 문자열 단위: 픽셀 |
| result.image_width | 이미지 파일인 경우 이미지의 너비입니다. 데이터 유형: 문자열 단위: 픽셀 |
| result.size_bytes | 첨부 파일의 크기입니다. 데이터 유형: 문자열 단위: 바이트 |
| result.size_compressed | 압축된 첨부 파일의 크기입니다. 파일이 압축되지 않은 경우 비어 있습니다. 데이터 유형: 문자열 단위: 바이트 |
| result.sys_created_by 님 | 첨부 파일을 처음 만든 엔터티입니다. 데이터 유형: 문자열 |
| result.sys_created_on | 첨부 파일이 인스턴스에 처음 저장된 날짜 및 시간입니다. 데이터 유형: 문자열 |
| result.sys_id | 첨부 파일의 Sys_id입니다. 데이터 유형: 문자열 |
| result.sys_mod_count | 첨부 파일이 수정된(인스턴스에 업로드된) 횟수입니다. 데이터 유형: 문자열 |
| result.sys_tags | 첨부 파일과 연결된 시스템 태그입니다. 데이터 유형: 문자열 |
| result.sys_업데이트_기준 | 첨부 파일을 마지막으로 업데이트한 엔터티입니다. 데이터 유형: 문자열 |
| result.sys_updated_on | 첨부 파일이 마지막으로 업데이트된 날짜 및 시간입니다. 데이터 유형: 문자열 |
| result.table_name | 첨부 파일이 연결된 테이블의 이름입니다. 데이터 유형: 문자열 |
| result.table_sys_id | 첨부 파일과 연결된 테이블의 Sys_id입니다. 데이터 유형: 문자열 |
| result.updated_by_name | 첨부 파일을 마지막으로 업데이트한 엔터티의 전체 이름입니다. 데이터 유형: 문자열 |
[ ]

{#attachment-POST-upload__table_bbj_pfk_llb}

### POST 다중 파트 필수 값 {#attachment-POST-upload__section_tk4_1ft_2mb}

첨부 파일을 업로드하기 위해 멀티파트 POST 요청을 보낼 때 URL 매개 변수가 아닌 메시지 본문에 첨부 파일 데이터를 포함합니다. 메시지 본문에 다음 값을 지정해야 합니다.{#attachment-POST-upload__table_p1v_nnj_js__entry__2}

| 값 | 설명 |
|-|-|
| 컨텐츠-형식 | 멀티파트 업로드를 위해 메시지 본문에 포함된 파일의 콘텐츠 유형입니다. 주: Content-Type은 양식 데이터가 아닌 POST 메시지의 파일 부분 내에서 정의되어야 합니다. 다중 파트 메시지의 예는 샘플 POST 다중 파트 메시지를 참조하십시오. 데이터 유형: 문자열 |
| table_name | 파일을 첨부할 테이블의 이름입니다. 데이터 유형: 문자열 |
| table_sys_id | 파일을 첨부할 지정된 테이블의 기록 Sys_id입니다. 데이터 유형: 문자열 |
[표 37. 필수 값]

{#attachment-POST-upload__table_p1v_nnj_js}  

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