첨부 파일 API

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

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

첨부 파일 API는 업로드된 파일에 대한 시스템 제한사항(예: 최대 파일 크기 및 허용되는 첨부 파일 형식)을 준수합니다. 이러한 설정은 속성 com.glide.attachment.max_size, 기본적으로 1024MB 및 glide.attachment.extensions를 사용하여 제어할 수 있습니다.

주:

첨부 파일 API는 모든 Content-Type 값(*/*)을 허용합니다. 첨부 파일을 업로드할 때 파일 컨텐츠 유형을 지정합니다. 콘텐츠 형식은 파일 메타데이터와 함께 저장되므로 다른 도구에서 파일을 올바르게 식별하고 구문 분석할 수 있습니다.

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

첨부 파일 API 역할 요구 사항

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

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

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

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

URL 형식

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

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

주:

사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

지원되는 요청 매개변수

표 1. 경로 매개변수

이름	설명
sys_id	삭제할 첨부 파일의 Sys_id 값입니다. 데이터 유형: 문자열

표 2. 쿼리 매개변수

이름	설명
안 함

표 3. 요청 본문 매개변수(XML 또는 JSON)

이름	설명
안 함

머리글

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하세요.

표 4. 요청 헤더

헤더	설명
안 함

표 5. 응답 헤더

헤더	설명
없음

상태 코드

다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.

표 6. 상태 코드

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

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

이름	설명
안 함

cURL 요청

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

""

첨부 파일 - GET /now/attachment

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

URL 형식

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

기본 URL: api/now/attachment

주:

사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

지원되는 요청 매개변수

표 7. 경로 매개변수

이름	설명
없음

표 8. 쿼리 매개변수

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

표 9. 요청 본문 매개변수(XML 또는 JSON)

이름	설명
안 함

머리글

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하세요.

표 10. 요청 헤더

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

표 11. 응답 헤더

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

상태 코드

다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.

표 12. 상태 코드

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

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

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

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

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

URL 형식

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

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

주:

사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

지원되는 요청 매개변수

표 13. 경로 매개변수

이름	설명
sys_id	이진 데이터를 반환할 첨부 파일 기록의 Sys_id입니다.

표 14. 쿼리 매개변수

이름	설명
안 함

표 15. 요청 본문 매개변수(XML 또는 JSON)

이름	설명
안 함

머리글

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하세요.

표 16. 요청 헤더

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

표 17. 응답 헤더

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

상태 코드

다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.

표 18. 상태 코드

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

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

이름	설명
이진 파일 첨부

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}

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

URL 형식

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

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

주:

사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

지원되는 요청 매개변수

표 19. 경로 매개변수

이름	설명
sys_id	메타데이터를 검색할 첨부 파일 기록의 Sys_id입니다.

표 20. 쿼리 매개변수

이름	설명
안 함

표 21. 요청 본문 매개변수(XML 또는 JSON)

이름	설명
안 함

머리글

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하세요.

표 22. 요청 헤더

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

표 23. 응답 헤더

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

상태 코드

다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.

표 24. 상태 코드

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

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

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

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

지정된 이진 파일을 지정된 기록에 첨부 파일로 업로드합니다.

주:

첨부할 파일은 전달된 요청 매개변수 목록의 마지막 매개변수 뒤에 지정되어야 합니다.

URL 형식

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

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

주:

사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

지원되는 요청 매개변수

표 25. 경로 매개변수

이름	설명
없음

표 26. 쿼리 매개변수

이름	설명
creation_time	첨부 파일의 생성 날짜 및 시간입니다. 이 매개변수를 사용하여 가 Now Mobile 앱 오프라인 상태이고 나중에 첨부 파일이 기록에 업로드될 때 첨부 파일 생성 시간을 캡처합니다. 데이터 유형: 문자열 기본값: 현재 날짜 및 시간입니다.
encryption_context	암호화 컨텍스트 기록의 Sys_id. 지정된 암호화 컨텍스트를 가진 사용자만 첨부 파일에 액세스할 수 있도록 이 매개변수를 지정합니다. 암호화 컨텍스트 기록에 대한 자세한 내용은 다음 문서를 참조하십시오 Field Encryption. 데이터 유형: 문자열 기본값: 파일은 사용자가 액세스할 수 있는 암호화 컨텍스트를 사용하여 암호화되며, 그렇지 않으면 첨부 파일이 암호화 컨텍스트로 암호화되지 않습니다.
file_name	필수 첨부 파일을 지정할 이름입니다. 데이터 유형: 문자열
table_name	필수 파일을 첨부할 테이블의 이름입니다. 데이터 유형: 문자열
table_sys_id	필수 파일을 첨부할 테이블에 지정된 table_name 기록의 Sys_id입니다. 데이터 유형: 문자열

표 27. 요청 본문 매개변수(XML 또는 JSON)

이름	설명
<문자열>	지정된 기록에 첨부할 이진 파일의 경로입니다.

머리글

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하세요.

표 28. 요청 헤더

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

표 29. 응답 헤더

헤더	설명
위치	새 첨부 파일의 URL입니다.

상태 코드

다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.

표 30. 상태 코드

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

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

요소	설명
결과	요청된 첨부 파일의 메타데이터입니다. 데이터 유형: 객체 "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 또는 픽셀 수.
결과.압축됨	첨부 파일이 압축되었는지 여부를 나타내는 플래그입니다. 가능한 값: true: 파일이 압축되었습니다. false: 파일이 압축되지 않았습니다. 데이터 유형: 문자열
result.content_type	연결된 첨부 파일의 콘텐츠 유형입니다(예: 이미지, 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_updated_by	첨부 파일을 마지막으로 업데이트한 엔터티입니다. 데이터 유형: 문자열
result.sys_updated_on	첨부 파일이 마지막으로 업데이트된 날짜 및 시간입니다. 데이터 유형: 문자열
result.table_name	첨부 파일이 연결된 테이블의 이름입니다. 데이터 유형: 문자열
result.table_sys_id	첨부 파일과 연결된 테이블의 Sys_id입니다. 데이터 유형: 문자열
result.updated_by_name	첨부 파일을 마지막으로 업데이트한 엔터티의 전체 이름입니다. 데이터 유형: 문자열

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

다중 파트 첨부 파일을 업로드합니다.

multipart POST 메서드는 매개 변수를 허용하지 않습니다. 테이블 이름을 지정하고 양식 본문 내에 sys_id 값을 기록해야 합니다. multipart/form-data 요청 샘플은 cURL 예제를 참조하십시오.

중요사항:

다중 파트 POST를 사용하는 경우 파일 내용이 메시지의 마지막 부분에만 포함되어 있는지 확인합니다. 이전 부분에는 테이블 이름 및 기록 sys_id와 같은 메타데이터만 포함되어야 합니다.

URL 형식

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

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

주:

사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

지원되는 요청 매개변수

표 31. 경로 매개변수

이름	설명
없음

표 32. 쿼리 매개변수

이름	설명
안 함

표 33. 요청 본문 매개변수(XML 또는 JSON)

이름	설명
안 함

머리글

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하세요.

표 34. 요청 헤더

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

표 35. 응답 헤더

헤더	설명
위치	새 첨부 파일의 URL입니다.

상태 코드

다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.

표 36. 상태 코드

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

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

요소	설명
결과	요청된 첨부 파일의 메타데이터입니다. 데이터 유형: 객체 "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 또는 픽셀 수.
결과.압축됨	첨부 파일이 압축되었는지 여부를 나타내는 플래그입니다. 가능한 값: true: 파일이 압축되었습니다. false: 파일이 압축되지 않았습니다. 데이터 유형: 문자열
result.content_type	연결된 첨부 파일의 콘텐츠 유형입니다(예: 이미지, 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_updated_by	첨부 파일을 마지막으로 업데이트한 엔터티입니다. 데이터 유형: 문자열
result.sys_updated_on	첨부 파일이 마지막으로 업데이트된 날짜 및 시간입니다. 데이터 유형: 문자열
result.table_name	첨부 파일이 연결된 테이블의 이름입니다. 데이터 유형: 문자열
result.table_sys_id	첨부 파일과 연결된 테이블의 Sys_id입니다. 데이터 유형: 문자열
result.updated_by_name	첨부 파일을 마지막으로 업데이트한 엔터티의 전체 이름입니다. 데이터 유형: 문자열

다중 파트 게시 필수 값

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

표 37. 필수 값

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

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