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

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# 첨부 파일 API

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

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 45분

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

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

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

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


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

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

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

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

지정된 첨부 파일을 삭제합니다.

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

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

기본 URL: /api/now/attachment/{sys_id}  
주:  
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

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

{#attachment-DELETE__entry__2}

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

{#attachment-DELETE__entry__6}

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

{#attachment-DELETE__entry__10}

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

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "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/1RuriJ1h~LGis5QmeVrYXQ "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'

    ""

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

첨부 파일의 모든 속성을 삭제합니다.
속성이 첨부 파일 속성 \[sys_attachment_attribute\] 테이블에서 삭제됩니다.

### URL 형식 {#attachment-DELETE-attributes__section_jjv_4th_g3c}

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

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

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

{#attachment-DELETE-attributes__entry__2}{#attachment-DELETE-attributes__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
| sys_id | 첨부 파일의 Sys_id입니다. 데이터 유형: 문자열 테이블: 첨부 파일 \[sys_attachment\] |
[표 7. 경로 매개변수]

{#attachment-DELETE-attributes__entry__8}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 8. 쿼리 매개변수]

{#attachment-DELETE-attributes__entry__12}

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

### 헤더

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

| 머리글 | 설명 |
|-|-|
| 없음 |   |
[표 10. 요청 헤더]

{#attachment-DELETE-attributes__table_px3_yth_g3c} {#attachment-DELETE-attributes__entry__20}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 11. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#attachment-DELETE-attributes__table_hvl_brh_g3c__entry__2}{#attachment-DELETE-attributes__entry-400-status-code}{#attachment-DELETE-attributes__entry-404-status-code}

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

{#attachment-DELETE-attributes__table_hvl_brh_g3c}

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

{#attachment-DELETE-attributes__entry__32}

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

### cURL 요청 {#attachment-DELETE-attributes__example_wzh_d5h_g3c}

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

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

응답 본문.

    ""

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

첨부 파일에서 지정된 속성을 삭제합니다.
속성이 첨부 파일 속성 \[sys_attachment_attribute\] 테이블에서 삭제됩니다.

### URL 형식

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

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

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

{#attachment-DELETE-attributes-key__table_oxc_cqh_g3c__entry__2}{#attachment-DELETE-attributes-key__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
| sys_id | 첨부 파일의 Sys_id입니다. 데이터 유형: 문자열 테이블: 첨부 파일 \[sys_attachment\] |
| attribute_key | 속성 키입니다. 데이터 유형: 문자열 테이블: 첨부 파일 속성 \[sys_attachment_attribute\] 열: 키 |
[표 13. 경로 매개변수]

{#attachment-DELETE-attributes-key__table_oxc_cqh_g3c} {#attachment-DELETE-attributes-key__entry__10}

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

{#attachment-DELETE-attributes-key__entry__14}

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

### 헤더

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

| 머리글 | 설명 |
|-|-|
| 없음 |   |
[표 16. 요청 헤더]

{#attachment-DELETE-attributes-key__entry__22}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 17. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#attachment-DELETE-attributes-key__table_hvl_brh_g3c__entry__2}{#attachment-DELETE-attributes-key__entry-400-status-code}{#attachment-DELETE-attributes-key__entry-404-status-code}

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

{#attachment-DELETE-attributes-key__table_hvl_brh_g3c}

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

{#attachment-DELETE-attributes-key__entry__34}

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

### cURL 요청

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

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

응답 본문.

    ""

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

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

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

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

기본 URL: api/now/attachment  
주:  
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

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

{#attachment-GET__entry__2}

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

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

| 이름 | 설명 |
|-|-|
| 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에서 ORDERBY 및 ORDERBYDESC 절을 사용합니다. 예를 들어, `sysparm_query=ORDERBYfile_name^ORDERBYDESCtable_Name` 는 결과를 이름별로 오름차순으로 먼저 정렬한 다음 테이블 이름별로 내림차순으로 정렬합니다. 데이터 유형: 문자열 |
[표 20. 쿼리 매개변수]

{#attachment-GET__entry__14}

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

### 헤더

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

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

{#attachment-GET__entry__22}

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

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "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 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 24. 상태 코드]

### 응답 본문 매개변수(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} {#ariaid-title6}

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

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

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

기본 URL: /api/now/attachment/{sys_id}  
주:  
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

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

{#attachment-GET-sys_id__entry__2}

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

{#attachment-GET-sys_id__entry__6}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 26. 쿼리 매개변수]

{#attachment-GET-sys_id__entry__10}

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

### 헤더

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

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

{#attachment-GET-sys_id__entry__18}

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

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "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 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 30. 상태 코드]

### 응답 본문 매개변수(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"
      }
    }

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

첨부 파일의 모든 속성을 조회합니다.
속성은 첨부 파일 속성 \[sys_attachment_attribute\] 테이블에서 검색됩니다.

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

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

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

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

{#attachment-GET-attributes__entry__2}{#attachment-GET-attributes__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
| sys_id | 첨부 파일의 Sys_id입니다. 데이터 유형: 문자열 테이블: 첨부 파일 \[sys_attachment\] |
[표 31. 경로 매개변수]

{#attachment-GET-attributes__entry__8}

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

{#attachment-GET-attributes__entry__12}

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

### 헤더

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

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

{#attachment-GET-attributes__entry__20}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 35. 응답 헤더]

### 상태 코드 {#attachment-GET-attributes__section_jsv_b3b_g3c}

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#attachment-GET-attributes__table_ksv_b3b_g3c__entry__2}{#attachment-GET-attributes__entry-200-status-code}{#attachment-GET-attributes__entry-400-status-code}{#attachment-GET-attributes__entry-404-status-code}

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

{#attachment-GET-attributes__table_ksv_b3b_g3c}

### 응답 본문 매개변수(JSON 또는 XML) {#attachment-GET-attributes__section_xkm_12b_g3c}

{#attachment-GET-attributes__table_ykm_12b_g3c__entry__2}

| 이름 | 설명 |
|-|-|
| 결과 | 각 속성에 대한 키-값 쌍을 포함하는 객체의 배열입니다. 데이터 유형: 배열 "result": [ { "key": "example_key", "value": "example_value" } ] |
| result.key | 속성 키입니다. 데이터 유형: 문자열 테이블: 첨부 파일 속성 \[sys_attachment_attribute\] 열: 키 |
| 결과.값 | 속성 값입니다. 데이터 유형: 문자열 테이블: 첨부 파일 속성 \[sys_attachment_attribute\] 열: 값 |
[ ]

{#attachment-GET-attributes__table_ykm_12b_g3c}  

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

첨부 파일에서 지정된 속성을 조회합니다.
속성은 첨부 파일 속성 \[sys_attachment_attribute\] 테이블에서 검색됩니다.

### URL 형식

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

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

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

{#attachment-GET-attributes-key__entry__2}{#attachment-GET-attributes-key__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
| sys_id | 첨부 파일의 Sys_id입니다. 데이터 유형: 문자열 테이블: 첨부 파일 \[sys_attachment\] |
| attribute_key | 속성 키입니다. 데이터 유형: 문자열 테이블: 첨부 파일 속성 \[sys_attachment_attribute\] 열: 키 |
[표 37. 경로 매개변수]

{#attachment-GET-attributes-key__entry__10}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 38. 쿼리 매개변수]

{#attachment-GET-attributes-key__entry__14}

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

### 헤더

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

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

{#attachment-GET-attributes-key__entry__22}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 41. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#attachment-GET-attributes-key__entry__26}{#attachment-GET-attributes-key__entry-200-status-code}{#attachment-GET-attributes-key__entry-400-status-code}{#attachment-GET-attributes-key__entry-404-status-code}

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

### 응답 본문 매개변수(JSON 또는 XML) {#attachment-GET-attributes-key__section_evb_gw3_g3c}

{#attachment-GET-attributes-key__table_fvb_gw3_g3c__entry__2}

| 이름 | 설명 |
|-|-|
| 결과 | 속성에 대한 키-값 쌍을 포함하는 객체입니다. 데이터 유형: 객체 "result": { "key": "String", "value": "String" } |
| result.key | 속성 키입니다. 데이터 유형: 문자열 테이블: 첨부 파일 속성 \[sys_attachment_attribute\] 열: 키 |
| 결과.값 | 속성 값입니다. 데이터 유형: 문자열 테이블: 첨부 파일 속성 \[sys_attachment_attribute\] 열: 값 |
[ ]

{#attachment-GET-attributes-key__table_fvb_gw3_g3c}  

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

특정 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  
주:  
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

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

{#attachment-GET-file__entry__2}

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

{#attachment-GET-file__entry__6}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 44. 쿼리 매개변수]

{#attachment-GET-file__entry__10}

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

### 헤더

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

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

{#attachment-GET-file__entry__18}

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

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "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 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 48. 상태 코드]

### 응답 본문 매개변수(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.

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

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

### URL 형식

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

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

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

{#attachment-PATCH__entry__2}{#attachment-PATCH__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
| sys_id | 첨부 파일의 Sys_id입니다. 테이블: 첨부 파일 \[sys_attachment\] 데이터 유형: 문자열 |
[표 49. 경로 매개변수]

{#attachment-PATCH__entry__8}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 50. 쿼리 매개변수]

{#attachment-PATCH__entry__12}

| 이름 | 설명 |
|-|-|
| file_name | 필수 첨부 파일의 새 이름입니다. 데이터 유형: 문자열 |
[표 51. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더

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

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

{#attachment-PATCH__entry__22}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 53. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#attachment-PATCH__entry__26}{#attachment-PATCH__entry-400-status-code}{#attachment-PATCH__entry-401-status-code}

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

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

{#attachment-PATCH__entry__34}

| 이름 | 설명 |
|-|-|
| 오류 | 오류 정보입니다. 이 매개변수는 요청이 실패한 경우에만 반환됩니다. 데이터 유형: 객체 "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 {#ariaid-title11}

지정된 첨부 파일에 속성을 추가합니다.
속성이 첨부 파일 속성 \[sys_attachment_attribute\] 테이블에 추가됩니다.

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

### URL 형식

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

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

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

{#attachment-POST-attributes__entry__2}{#attachment-POST-attributes__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
| sys_id | 첨부 파일의 Sys_id입니다. 데이터 유형: 문자열 테이블: 첨부 파일 \[sys_attachment\] |
[표 55. 경로 매개변수]

{#attachment-POST-attributes__entry__8}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 56. 쿼리 매개변수]

{#attachment-POST-attributes__entry__12}

| 이름 | 설명 |
|-|-|
| 키 | 필수 속성에 사용할 키입니다. 데이터 유형: 문자열 |
| 값 | 필수 속성에 사용할 값입니다. 데이터 유형: 문자열 |
[표 57. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더

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

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

{#attachment-POST-attributes__table_fnw_xy1_g3c} {#attachment-POST-attributes__entry__24}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 59. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#attachment-POST-attributes__entry__28}{#attachment-POST-attributes__entry-400-status-code}{#attachment-POST-attributes__entry-404-status-code}

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

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

{#attachment-POST-attributes__entry__36}

| 이름 | 설명 |
|-|-|
| 결과 | 속성에 대한 키-값 쌍을 포함하는 객체입니다. 데이터 유형: 객체 "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 {#ariaid-title12}

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

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

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

기본 URL: /api/now/attachment/file  
주:  
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

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

{#attachment-POST-file__entry__2}

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

{#attachment-POST-file__entry__6}

| 이름 | 설명 |
|-|-|
| creation_time | 첨부 파일의 생성 날짜 및 시간입니다. 이 매개변수를 사용하면 첨부 파일이 Now Mobile 앱 오프라인 상태이고 나중에 첨부 파일이 기록에 업로드될 때 첨부 파일 생성 시간을 캡처할 수 있습니다. 데이터 유형: 문자열 기본값: 현재 날짜 및 시간입니다. |
| encryption_context | 암호화 컨텍스트 기록의 Sys_id입니다. 지정된 암호화 컨텍스트가 있는 사용자만 첨부 파일에 액세스할 수 있도록 이 매개변수를 지정합니다. 암호화 컨텍스트 기록에 대한 자세한 내용은 다음 문서를 참조하십시오 [Field Encryption](https://www.servicenow.com/docs/access?context=field-encryption&version=australia&pubname=australia-platform-security&ft:locale=en-US). 데이터 유형: 문자열 기본값: 파일이 사용자가 액세스할 수 있는 암호화 컨텍스트를 사용하여 암호화되며, 그렇지 않으면 첨부된 파일이 암호화 컨텍스트로 암호화되지 않습니다. |
| file_name | 필수 첨부 파일을 지정할 이름입니다. 데이터 유형: 문자열 |
| table_name | 필수 파일을 첨부할 테이블의 이름입니다. 데이터 유형: 문자열 |
| table_sys_id | 필수 파일을 첨부하려는 테이블에서 지정된 table_name 기록의 Sys_id입니다. 데이터 유형: 문자열 |
[표 62. 쿼리 매개변수]

{#attachment-POST-file__entry__18}

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

### 헤더

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

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

{#attachment-POST-file__entry__28}

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

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#attachment-POST-file__entry__32}{#attachment-POST-file__entry-500-status-code}

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

### 응답 본문 매개변수(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 | 연결된 첨부 파일의 콘텐츠 유형(예: 이미지 또는 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 | 첨부 파일을 마지막으로 업데이트한 엔터티의 전체 이름입니다. 데이터 유형: 문자열 |
[ ]

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

멀티파트 첨부 파일을 업로드합니다.
멀티파트 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  
주:  
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

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

{#attachment-POST-upload__entry__2}

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

{#attachment-POST-upload__entry__6}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 68. 쿼리 매개변수]

{#attachment-POST-upload__entry__10}

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

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "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로 설정합니다. |
[표 70. 요청 헤더]

{#attachment-POST-upload__entry__20}

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

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "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 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 72. 상태 코드]

### 응답 본문 매개변수(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 | 연결된 첨부 파일의 콘텐츠 유형(예: 이미지 또는 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 | 첨부 파일을 마지막으로 업데이트한 엔터티의 전체 이름입니다. 데이터 유형: 문자열 |
[ ]

{#attachment-POST-upload__table_bbj_pfk_llb}

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

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

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

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

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

첨부 파일에 대한 기존 속성의 값을 업데이트합니다.
속성은 첨부 파일 속성 \[sys_attachment_attribute\] 테이블에서 업데이트됩니다.

### URL 형식

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

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

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

{#attachment-PUT-attributes__entry__2}{#attachment-PUT-attributes__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
| sys_id | 첨부 파일의 Sys_id입니다. 데이터 유형: 문자열 테이블: 첨부 파일 \[sys_attachment\] |
| attribute_key | 속성 키입니다. 데이터 유형: 문자열 테이블: 첨부 파일 속성 \[sys_attachment_attribute\] 열: 키 |
[표 74. 경로 매개변수]

{#attachment-PUT-attributes__entry__10}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 75. 쿼리 매개변수]

{#attachment-PUT-attributes__entry__14}

| 이름 | 설명 |
|-|-|
| 값 | 필수 속성의 새 값입니다. 데이터 유형: 문자열 |
[표 76. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더

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

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

{#attachment-PUT-attributes__table_fnw_xy1_g3c} {#attachment-PUT-attributes__entry__24}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 78. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#attachment-PUT-attributes__table_ksv_b3b_g3c__entry__2}{#attachment-PUT-attributes__entry-200-status-code}{#attachment-PUT-attributes__entry-400-status-code}{#attachment-PUT-attributes__entry-404-status-code}

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

{#attachment-PUT-attributes__table_ksv_b3b_g3c}

### 응답 본문 매개변수(JSON 또는 XML) {#attachment-PUT-attributes__section_smm_qw3_g3c}

{#attachment-PUT-attributes__table_tmm_qw3_g3c__entry__2}

| 이름 | 설명 |
|-|-|
| 결과 | 속성에 대한 키-값 쌍을 포함하는 객체입니다. 데이터 유형: 객체 "result": { "key": "String", "value": "String" } |
| result.key | 속성 키입니다. 데이터 유형: 문자열 테이블: 첨부 파일 속성 \[sys_attachment_attribute\] 열: 키 |
| 결과.값 | 속성 값입니다. 데이터 유형: 문자열 테이블: 첨부 파일 속성 \[sys_attachment_attribute\] 열: 값 |
[ ]

{#attachment-PUT-attributes__table_tmm_qw3_g3c}  

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