첨부 파일 API

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 45분
  • 첨부 파일 API는 첨부 파일을 업로드하고 쿼리할 수 있는 엔드포인트를 제공합니다.

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

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

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

    다음 비디오에서는 첨부 파일 API에 대한 자세한 내용을 제공합니다.

    첨부 파일 API 역할 요구 사항

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

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

    첨부 파일 - 삭제 /now/attachment/{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입니다.

    데이터 유형: 문자열

    테이블: 첨부 파일 [sys_attachment]

    표 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'
    
    ""

    첨부 파일 - 삭제 /now/attachment/{sys_id}/attributes

    첨부 파일의 모든 속성을 삭제합니다.

    속성이 첨부 파일 속성 [sys_attachment_attribute] 테이블에서 삭제됩니다.

    URL 형식

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

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

    지원되는 요청 매개변수

    표 7. 경로 매개변수
    이름 설명
    api_version 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오.

    데이터 유형: 문자열

    sys_id 첨부 파일의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 첨부 파일 [sys_attachment]

    표 8. 쿼리 매개변수
    이름 설명
    안 함
    표 9. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

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

    표 10. 요청 헤더
    머리글 설명
    없음
    표 11. 응답 헤더
    머리글 설명
    안 함

    상태 코드

    이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

    표 12. 상태 코드
    상태 코드 설명
    204 컨텐츠가 없습니다. 속성이 성공적으로 삭제되었으며 응답 본문에 컨텐츠가 반환되지 않았습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    404 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다.

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

    이름 설명
    없음

    cURL 요청

    이 예에서는 첨부 파일에서 모든 속성을 삭제합니다.

    curl "https://instance.service-now.com/api/now/attachment/a3af695b0a0006871b657c200acf62e0/attributes" \
    --request DELETE \
    --user 'username':'password'

    응답 본문.

    ""

    첨부 파일 - 삭제 /now/attachment/{sys_id}/attributes/{attribute_key}

    첨부 파일에서 지정된 속성을 삭제합니다.

    속성이 첨부 파일 속성 [sys_attachment_attribute] 테이블에서 삭제됩니다.

    URL 형식

    버전이 지정된 URL: /api/now/{api_version}/attachment/{sys_id}/attributes/{attribute_key}

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

    지원되는 요청 매개변수

    표 13. 경로 매개변수
    이름 설명
    api_version 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오.

    데이터 유형: 문자열

    sys_id 첨부 파일의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 첨부 파일 [sys_attachment]

    attribute_key 속성 키입니다.

    데이터 유형: 문자열

    테이블: 첨부 파일 속성 [sys_attachment_attribute]

    열: 키

    표 14. 쿼리 매개변수
    이름 설명
    안 함
    표 15. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

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

    표 16. 요청 헤더
    머리글 설명
    없음
    표 17. 응답 헤더
    머리글 설명
    안 함

    상태 코드

    이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

    표 18. 상태 코드
    상태 코드 설명
    204 컨텐츠가 없습니다. 속성이 성공적으로 삭제되었으며 응답 본문에 컨텐츠가 반환되지 않았습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    404 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다.

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

    이름 설명
    없음

    cURL 요청

    이 예에서는 첨부 파일에서 지정된 속성을 삭제합니다.

    curl "https://instance.service-now.com/api/now/attachment/a3af695b0a0006871b657c200acf62e0/attributes/example_key" \
    --request DELETE \
    --user 'username':'password'

    응답 본문.

    ""

    첨부 파일 - GET /now/attachment

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

    URL 형식

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

    기본 URL: api/now/attachment

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

    지원되는 요청 매개변수

    표 19. 경로 매개변수
    이름 설명
    없음
    표 20. 쿼리 매개변수
    이름 설명
    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)

    인코딩된 쿼리는 정렬 기준을 지원합니다. 특정 필드를 기준으로 응답을 정렬하려면 sysparm_query에서 ORDERBYORDERBYDESC 절을 사용합니다. 예를 들어, sysparm_query=ORDERBYfile_name^ORDERBYDESCtable_Name 는 결과를 이름별로 오름차순으로 먼저 정렬한 다음 테이블 이름별로 내림차순으로 정렬합니다.

    데이터 유형: 문자열

    표 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 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    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}

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

    URL 형식

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

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

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

    지원되는 요청 매개변수

    표 25. 경로 매개변수
    이름 설명
    sys_id 메타데이터를 검색할 첨부 파일 기록의 Sys_id입니다.
    표 26. 쿼리 매개변수
    이름 설명
    안 함
    표 27. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

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

    표 28. 요청 헤더
    머리글 설명
    수용 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다.

    기본값: application/json

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

    상태 코드

    이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

    표 30. 상태 코드
    상태 코드 설명
    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"
      }
    }

    첨부 파일 - GET /now/attachment/{sys_id}/attributes

    첨부 파일의 모든 속성을 조회합니다.

    속성은 첨부 파일 속성 [sys_attachment_attribute] 테이블에서 검색됩니다.

    URL 형식

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

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

    지원되는 요청 매개변수

    표 31. 경로 매개변수
    이름 설명
    api_version 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오.

    데이터 유형: 문자열

    sys_id 첨부 파일의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 첨부 파일 [sys_attachment]

    표 32. 쿼리 매개변수
    이름 설명
    안 함
    표 33. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

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

    표 34. 요청 헤더
    머리글 설명
    수용 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다.

    기본값: application/json

    표 35. 응답 헤더
    머리글 설명
    안 함

    상태 코드

    이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

    표 36. 상태 코드
    상태 코드 설명
    200 성공입니다. 요청이 성공적으로 처리되었습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    404 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다.

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

    이름 설명
    결과 각 속성에 대한 키-값 쌍을 포함하는 객체의 배열입니다.

    데이터 유형: 배열

    "result": [
      {
        "key": "example_key",
        "value": "example_value"
      }
    ]
    result.key 속성 키입니다.

    데이터 유형: 문자열

    테이블: 첨부 파일 속성 [sys_attachment_attribute]

    열: 키

    결과.값 속성 값입니다.

    데이터 유형: 문자열

    테이블: 첨부 파일 속성 [sys_attachment_attribute]

    열: 값

    cURL 요청

    이 예에서는 지정된 첨부 파일의 모든 속성을 검색합니다.

    curl "https://instance.service-now.com/api/now/attachment/a3af695b0a0006871b657c200acf62e0/attributes" \
    --request GET \
    --header "Accept:application/json" \
    --user 'username':'password'

    응답 본문.

    {
      "result": [
        {
          "key": "example_key",
          "value": "example_value"
        },
        {
          "key": "another_key",
          "value": "another_value"
        }
      ]
    }

    첨부 파일 - GET /now/attachment/{sys_id}/attributes/{attribute_key}

    첨부 파일에서 지정된 속성을 조회합니다.

    속성은 첨부 파일 속성 [sys_attachment_attribute] 테이블에서 검색됩니다.

    URL 형식

    버전이 지정된 URL: /api/now/{api_version}/attachment/{sys_id}/attributes/{attribute_key}

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

    지원되는 요청 매개변수

    표 37. 경로 매개변수
    이름 설명
    api_version 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오.

    데이터 유형: 문자열

    sys_id 첨부 파일의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 첨부 파일 [sys_attachment]

    attribute_key 속성 키입니다.

    데이터 유형: 문자열

    테이블: 첨부 파일 속성 [sys_attachment_attribute]

    열: 키

    표 38. 쿼리 매개변수
    이름 설명
    안 함
    표 39. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

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

    표 40. 요청 헤더
    머리글 설명
    수용 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다.

    기본값: application/json

    표 41. 응답 헤더
    머리글 설명
    안 함

    상태 코드

    이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

    표 42. 상태 코드
    상태 코드 설명
    200 성공입니다. 요청이 성공적으로 처리되었습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    404 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다.

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

    이름 설명
    결과 속성에 대한 키-값 쌍을 포함하는 객체입니다.

    데이터 유형: 객체

    "result": { 
       "key": "String",  
       "value": "String"
    }
    result.key 속성 키입니다.

    데이터 유형: 문자열

    테이블: 첨부 파일 속성 [sys_attachment_attribute]

    열: 키

    결과.값 속성 값입니다.

    데이터 유형: 문자열

    테이블: 첨부 파일 속성 [sys_attachment_attribute]

    열: 값

    cURL 요청

    이 예에서는 첨부 파일에서 지정된 속성을 검색합니다.

    curl "https://instance.service-now.com/api/now/attachment/a3af695b0a0006871b657c200acf62e0/attributes/example_key" \
    --request GET \
    --header "Accept:application/json" \
    --user 'username':'password'

    응답 본문.

    {
      "result": {
        "key": "example_key",
        "value": "example_value"
      }
    }

    첨부 파일 - 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 서비스 양식에 추가 버전 정보가 있습니다.

    지원되는 요청 매개변수

    표 43. 경로 매개변수
    이름 설명
    sys_id 이진 데이터를 반환할 첨부 파일 기록의 Sys_id입니다.
    표 44. 쿼리 매개변수
    이름 설명
    안 함
    표 45. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

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

    표 46. 요청 헤더
    머리글 설명
    수용 응답 본문의 데이터 형식입니다. 예를 들어 image/jpeg 또는 image/png 를 사용하여 JPEG 또는 PNG 이미지 파일을 단독으로 허용합니다. 모든 이미지 유형을 허용하려면 image/*를 지정합니다. 모든 파일 형식을 허용하려면 */*를 지정합니다.

    기본값: */*

    표 47. 응답 헤더
    머리글 설명
    X-첨부 파일-메타데이터 크기, 이름 및 파일 형식과 같은 반환된 파일에 대한 메타데이터입니다.

    상태 코드

    이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

    표 48. 상태 코드
    상태 코드 설명
    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.

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

    첨부 파일의 이름을 바꿉니다.

    URL 형식

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

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

    지원되는 요청 매개변수

    표 49. 경로 매개변수
    이름 설명
    api_version 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오.

    데이터 유형: 문자열

    sys_id 첨부 파일의 Sys_id입니다.

    테이블: 첨부 파일 [sys_attachment]

    데이터 유형: 문자열

    표 50. 쿼리 매개변수
    이름 설명
    안 함
    표 51. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    file_name 필수 첨부 파일의 새 이름입니다.

    데이터 유형: 문자열

    헤더

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

    표 52. 요청 헤더
    머리글 설명
    수용 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다.

    기본값: application/json

    콘텐츠-형식 요청 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다.

    기본값: application/json

    표 53. 응답 헤더
    머리글 설명
    안 함

    상태 코드

    이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

    표 54. 상태 코드
    상태 코드 설명
    204 컨텐츠가 없습니다. 첨부 파일의 이름이 성공적으로 변경되었으며 응답 본문에 콘텐츠가 반환되지 않았습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    401 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.

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

    이름 설명
    오류 오류 정보입니다. 이 매개변수는 요청이 실패한 경우에만 반환됩니다.

    데이터 유형: 객체

    "error": {   
       "detail": "String",
       "message": "String"
    }
    오류.상세 정보 요청 실패 원인에 대한 추가 정보입니다.

    데이터 유형: 문자열

    오류.메시지 요청에 실패한 이유를 포함하는 오류 메시지입니다.

    데이터 유형: 문자열

    상태 API 요청의 상태입니다. 이 매개변수는 요청이 실패한 경우에만 반환되므로 가능한 유일한 값은 failure입니다.

    데이터 유형: 문자열

    cURL 요청

    이 예에서는 첨부 파일의 이름을 바꿉니다.

    curl "https://instance.service-now.com/api/now/attachment/a3af695b0a0006871b657c200acf62e0" \
    --request PATCH \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
      \"file_name\": \"new_attachment_name\"        
    }" \
    --user 'username':'password'

    응답 본문.

    ""

    첨부 파일 - POST /now/attachment/{sys_id}/attributes

    지정된 첨부 파일에 속성을 추가합니다.

    속성이 첨부 파일 속성 [sys_attachment_attribute] 테이블에 추가됩니다.

    이 엔드포인트를 사용하여 첨부 파일에 대체 텍스트를 추가할 수 있습니다.

    URL 형식

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

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

    지원되는 요청 매개변수

    표 55. 경로 매개변수
    이름 설명
    api_version 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오.

    데이터 유형: 문자열

    sys_id 첨부 파일의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 첨부 파일 [sys_attachment]

    표 56. 쿼리 매개변수
    이름 설명
    안 함
    표 57. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    필수 속성에 사용할 키입니다.

    데이터 유형: 문자열

    필수 속성에 사용할 값입니다.

    데이터 유형: 문자열

    헤더

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

    표 58. 요청 헤더
    머리글 설명
    수용 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다.

    기본값: application/json

    콘텐츠-형식 요청 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다.

    기본값: application/json

    표 59. 응답 헤더
    머리글 설명
    안 함

    상태 코드

    이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

    표 60. 상태 코드
    상태 코드 설명
    201 만든. 속성이 성공적으로 작성되었습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    404 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다.

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

    이름 설명
    결과 속성에 대한 키-값 쌍을 포함하는 객체입니다.

    데이터 유형: 객체

    "result": { 
       "key": "String",  
       "value": "String"
    }
    result.key 속성 키입니다.

    데이터 유형: 문자열

    테이블: 첨부 파일 속성 [sys_attachment_attribute]

    열: 키

    결과.값 속성 값입니다.

    데이터 유형: 문자열

    테이블: 첨부 파일 속성 [sys_attachment_attribute]

    열: 값

    cURL 요청

    이 예시에서는 첨부 파일에 속성을 추가합니다.

    curl "https://instance.service-now.com/api/now/attachment/a3af695b0a0006871b657c200acf62e0/attributes" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
      \"key\": \"example_key\",  
      \"value\": \"example_value\"
    }" \
    --user 'username':'password'

    응답 본문.

    {
      "result": {
        "key": "example_key",
        "value": "example_value"
      }
    }

    첨부 파일 - POST /now/attachment/file

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

    주:
    연결할 파일은 전달된 요청 매개변수 목록의 마지막 매개변수 뒤에 지정해야 합니다.

    URL 형식

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

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

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

    지원되는 요청 매개변수

    표 61. 경로 매개변수
    이름 설명
    없음
    표 62. 쿼리 매개변수
    이름 설명
    creation_time 첨부 파일의 생성 날짜 및 시간입니다.

    이 매개변수를 사용하면 첨부 파일이 Now Mobile 앱 오프라인 상태이고 나중에 첨부 파일이 기록에 업로드될 때 첨부 파일 생성 시간을 캡처할 수 있습니다.

    데이터 유형: 문자열

    기본값: 현재 날짜 및 시간입니다.

    encryption_context 암호화 컨텍스트 기록의 Sys_id입니다. 지정된 암호화 컨텍스트가 있는 사용자만 첨부 파일에 액세스할 수 있도록 이 매개변수를 지정합니다. 암호화 컨텍스트 기록에 대한 자세한 내용은 다음 문서를 참조하십시오 Field Encryption.

    데이터 유형: 문자열

    기본값: 파일이 사용자가 액세스할 수 있는 암호화 컨텍스트를 사용하여 암호화되며, 그렇지 않으면 첨부된 파일이 암호화 컨텍스트로 암호화되지 않습니다.

    file_name 필수 첨부 파일을 지정할 이름입니다.

    데이터 유형: 문자열

    table_name 필수 파일을 첨부할 테이블의 이름입니다.

    데이터 유형: 문자열

    table_sys_id 필수 파일을 첨부하려는 테이블에서 지정된 table_name 기록의 Sys_id입니다.

    데이터 유형: 문자열

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

    헤더

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

    표 64. 요청 헤더
    머리글 설명
    수용 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다.

    기본값: application/json

    콘텐츠-형식 첨부할 파일의 콘텐츠 유형(예: image/jpeg 또는 */*)입니다. 이 헤더는 첨부 파일을 게시하는 데 필수입니다.
    표 65. 응답 헤더
    머리글 설명
    위치 새 첨부 파일의 URL입니다.

    상태 코드

    이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

    표 66. 상태 코드
    상태 코드 설명
    201 쿼리가 성공적으로 실행되었음을 나타냅니다.
    400 요청에서 하나 이상의 필수 매개변수가 누락되었음을 나타냅니다.
    404 AND 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 또는 픽셀 수.

    result.compressed 첨부 파일이 압축되었는지 여부를 나타내는 플래그입니다.
    가능한 값:
    • 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

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

    멀티파트 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 서비스 양식에 추가 버전 정보가 있습니다.

    지원되는 요청 매개변수

    표 67. 경로 매개변수
    이름 설명
    없음
    표 68. 쿼리 매개변수
    이름 설명
    안 함
    표 69. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

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

    표 70. 요청 헤더
    머리글 설명
    수용 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다.

    기본값: application/json

    콘텐츠-형식 요청의 콘텐츠 유형입니다. multipart POST 메서드를 사용하는 경우 이 값을 multipart/form-data로 설정합니다.
    표 71. 응답 헤더
    머리글 설명
    위치 새 첨부 파일의 URL입니다.

    상태 코드

    이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

    표 72. 상태 코드
    상태 코드 설명
    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 또는 픽셀 수.

    result.compressed 첨부 파일이 압축되었는지 여부를 나타내는 플래그입니다.
    가능한 값:
    • 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 매개변수가 아닌 메시지 본문에 첨부 파일 데이터를 포함합니다. 메시지 본문에 다음 값을 지정해야 합니다.
    표 73. 필수 값
    설명
    콘텐츠-형식 멀티파트 업로드를 위한 메시지 본문에 포함된 파일의 콘텐츠 유형입니다.
    주:
    콘텐츠 형식은 양식 데이터가 아닌 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"
      }
    }

    첨부 파일 - PUT /now/attachment/{sys_id}/attributes/{attribute_key}

    첨부 파일에 대한 기존 속성의 값을 업데이트합니다.

    속성은 첨부 파일 속성 [sys_attachment_attribute] 테이블에서 업데이트됩니다.

    URL 형식

    버전이 지정된 URL: /api/now/{api_version}/attachment/{sys_id}/attributes/{attribute_key}

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

    지원되는 요청 매개변수

    표 74. 경로 매개변수
    이름 설명
    api_version 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오.

    데이터 유형: 문자열

    sys_id 첨부 파일의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 첨부 파일 [sys_attachment]

    attribute_key 속성 키입니다.

    데이터 유형: 문자열

    테이블: 첨부 파일 속성 [sys_attachment_attribute]

    열: 키

    표 75. 쿼리 매개변수
    이름 설명
    안 함
    표 76. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    필수 속성의 새 값입니다.

    데이터 유형: 문자열

    헤더

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

    표 77. 요청 헤더
    머리글 설명
    수용 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다.

    기본값: application/json

    콘텐츠-형식 요청 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다.

    기본값: application/json

    표 78. 응답 헤더
    머리글 설명
    안 함

    상태 코드

    이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

    표 79. 상태 코드
    상태 코드 설명
    200 성공입니다. 요청이 성공적으로 처리되었습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    404 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다.

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

    이름 설명
    결과 속성에 대한 키-값 쌍을 포함하는 객체입니다.

    데이터 유형: 객체

    "result": { 
       "key": "String",  
       "value": "String"
    }
    result.key 속성 키입니다.

    데이터 유형: 문자열

    테이블: 첨부 파일 속성 [sys_attachment_attribute]

    열: 키

    결과.값 속성 값입니다.

    데이터 유형: 문자열

    테이블: 첨부 파일 속성 [sys_attachment_attribute]

    열: 값

    cURL 요청

    이 예시에서는 지정된 첨부 파일의 example_key 속성 값을 업데이트합니다.

    curl "https://instance.service-now.com/api/now/attachment/a3af695b0a0006871b657c200acf62e0/attributes/example_key" \
    --request PUT \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
      \"value\": \"new_value\"
    }" \
    --user 'username':'password'

    응답 본문.

    {
      "result": {
        "key": "example_key",
        "value": "new_value"
      }
    }