---
sourceDocument: オーストラリア API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference

 Release :

    - australia

ft:locale :

    - ja-JP

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) 所要時間：51分

添付ファイル API は、添付ファイルをアップロードしてクエリできるようにするエンドポイントを提供します。

要求ごとに 1 つのファイルをアップロードまたは取得できます。

添付ファイル API は、最大ファイルサイズや許可される添付ファイルタイプなど、アップロードされたファイルに関するシステム制限に従います。これらの設定は、プロパティ com.glide.attachment.max_size、デフォルトで 1024 MB、および glide.attachment.extensions を使用して制御できます。  
注:  
添付ファイル API は、すべてのコンテンツタイプ値 (\*/\*) を受け入れます。添付ファイルをアップロードするときのファイルコンテンツタイプを指定します。コンテンツタイプはファイルメタデータとともに保存されるため、他のツールはファイルを正しく識別して解析できます。

次のビデオでは、 添付ファイル API について詳しく説明しています。


## 添付ファイル API ロールの要件 {#c_AttachmentAPI__section_tby_gn1_xhb}

添付ファイルを作成するには、 ServiceNow での HTTP 要求の認証に使用されるユーザーレコードに、添付ファイル \[sys_attachment\] レコードの作成に必要なロールが必要です。また、インシデントレコードに添付ファイルを追加するための itil ロールなど、ターゲットテーブルのレコードの読み取りと書き込みに必要なロールも必要です。

デフォルトでは、ユーザーが添付ファイルを追加できるロールは 1 つではありません。添付ファイルの追加を明示的に許可するロールを作成し、要求を行うために使用しているユーザーアカウントにこのロールをアサインすることができます。

## 添付ファイル:DELETE /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/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス 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/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#attachment-DELETE__entry__14}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 4. 要求ヘッダー]

{#attachment-DELETE__entry__18}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 5. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#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'

    ""

## 添付ファイル:DELETE /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/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#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/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#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'

応答本文。

    ""

## 添付ファイル:DELETE /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/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#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/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#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/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。

### サポートされている要求パラメーター

{#attachment-GET__entry__2}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 19. パスパラメーター]

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

| 名前 | 説明 |
|-|-|
| sysparm_limit | ページネーションに適用する制限。 注: `sysparm_limit`値が異常に大きいと、システムのパフォーマンスに影響を与える可能性があります。 データタイプ：文字列 デフォルト：1000 |
| sysparm_offset | クエリから除外するレコードの数。パラメーターで指定した数よりも多くのレコードを取得するには、このパラメーターを使用しますsysparm_limit たとえば、 sysparm_limit が 500 に設定されていても、クエリーする追加のレコードがある場合、 sysparm_offset パラメーター値 500 を指定すると、2 番目のレコードセットを取得できます。 データタイプ：文字列 デフォルト：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/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#attachment-GET__entry__18}{#attachment-GET__accept-RESTAPI}

| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
[表 : 22. 要求ヘッダー]

{#attachment-GET__entry__22}

| ヘッダー | 説明 |
|-|-|
| Content-Type | 応答のコンテンツタイプ。メタデータ要求の場合、これは添付ファイルのコンテンツタイプではなく、メタデータのコンテンツタイプです。 |
| 「リンク」 | 添付ファイルをダウンロードするためのリンク。 |
[表 : 23. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#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/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス 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/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#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}

| ヘッダー | 説明 |
|-|-|
| Content-Type | 応答のコンテンツタイプ。メタデータ要求の場合、これは添付ファイルのコンテンツタイプではなく、メタデータのコンテンツタイプです。 |
[表 : 29. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#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/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#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/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#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 | 各属性のキーと値のペアを含むオブジェクトのアレイ。 データタイプ：アレイ "result": [ { "key": "example_key", "value": "example_value" } ] |
| result.key | 属性キー。 データタイプ：文字列 テーブル:添付ファイル属性 \[sys_attachment_attribute\] 列:キー |
| result.value | 属性値。 データタイプ：文字列 テーブル:添付ファイル属性 \[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/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#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/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#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 | 属性のキーと値のペアを含むオブジェクト。 データタイプ: オブジェクト "result": { "key": "String", "value": "String" } |
| result.key | 属性キー。 データタイプ：文字列 テーブル:添付ファイル属性 \[sys_attachment_attribute\] 列:キー |
| result.value | 属性値。 データタイプ：文字列 テーブル:添付ファイル属性 \[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/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス 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/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#attachment-GET-file__entry__14}

| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。たとえば、 `image/jpeg` または `image/png` を使用して、JPEG または PNG 画像ファイルを排他的に受け入れます。すべての画像タイプを許可するには、 `image/*` を指定します。任意のファイルタイプを許可するには、 `*/*` を指定します。 デフォルト値:\*/\* |
[表 : 46. 要求ヘッダー]

{#attachment-GET-file__entry__18}

| ヘッダー | 説明 |
|-|-|
| X-Attachment-Metadata | サイズ、名前、ファイルタイプなど、返されたファイルに関するメタデータ。 |
[表 : 47. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#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/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#attachment-PATCH__entry__16}{#attachment-PATCH__accept-RESTAPI}{#attachment-PATCH__content_type-RESTAPI}

| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
| Content-Type | 要求本文のデータ形式。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
[表 : 52. 要求ヘッダー]

{#attachment-PATCH__entry__22}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 53. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#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" } |
| error.detail | 要求が失敗した理由に関するその他の詳細。 データタイプ：文字列 |
| error.message | 要求が失敗した理由を含むエラーメッセージ。 データタイプ：文字列 |
| status | 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}

| 名前 | 説明 |
|-|-|
| key | 必須です。属性に使用するキー。 データタイプ：文字列 |
| value | 必須です。属性に使用する値。 データタイプ：文字列 |
[表 : 57. 要求本文パラメーター (XML または JSON)]

### ヘッダー

次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#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 |
| Content-Type | 要求本文のデータ形式。サポートされるタイプ：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/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#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 | 属性のキーと値のペアを含むオブジェクト。 データタイプ: オブジェクト "result": { "key": "String", "value": "String" } |
| result.key | 属性キー。 データタイプ：文字列 テーブル:添付ファイル属性 \[sys_attachment_attribute\] 列:キー |
| result.value | 属性値。 データタイプ：文字列 テーブル:添付ファイル属性 \[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/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス 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/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#attachment-POST-file__entry__22}{#attachment-POST-file__accept-RESTAPI}

| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
| Content-Type | 添付するファイルのコンテンツタイプ (image/jpeg や \*/\* など)。このヘッダーは、添付ファイルを投稿するために必須です。 |
[表 : 64. 要求ヘッダー]

{#attachment-POST-file__entry__28}

| ヘッダー | 説明 |
|-|-|
| ロケーション | 新しい添付ファイルの URL。 |
[表 : 65. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#attachment-POST-file__entry__32}{#attachment-POST-file__entry-500-status-code}

| ステータスコード | 説明 |
|-|-|
| 201 | クエリが正常に実行されたことを示します。 |
| 400 | 要求に 1 つ以上の必須パラメーターがなかったことを示します。 |
| 404 | table_nameで指定されたレコードとtable_sys_idパラメーターが存在しないか、現在のユーザーがアクセスできないことを示します。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
[表 : 66. ステータスコード]

### 応答本文のパラメーター (JSON または XML)

{#attachment-POST-file__table_kbr_qck_llb__entry__2}

| 要素 | 説明 |
|-|-|
| result | 要求された添付ファイルのメタデータ。 データタイプ: オブジェクト "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 | ServiceNowインスタンスの添付ファイルのダウンロード URL。 データタイプ：文字列 |
| 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/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス 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/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#attachment-POST-upload__entry__14}{#attachment-POST-upload__accept-RESTAPI}

| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
| Content-Type | 要求のコンテンツタイプ。multipart POST メソッドを使用する場合は、この値を multipart/form-data に設定します。 |
[表 : 70. 要求ヘッダー]

{#attachment-POST-upload__entry__20}

| ヘッダー | 説明 |
|-|-|
| ロケーション | 新しい添付ファイルの URL。 |
[表 : 71. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#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 | 要求された添付ファイルのメタデータ。 データタイプ: オブジェクト "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 | ServiceNowインスタンスの添付ファイルのダウンロード URL。 データタイプ：文字列 |
| 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}

### POST マルチパート必須値 {#attachment-POST-upload__section_tk4_1ft_2mb}

添付ファイルをアップロードするマルチパート POST 要求を送信する場合は、URL パラメーターではなく、メッセージ本文に添付ファイルデータを含めます。メッセージ本文で次の値を指定する必要があります。{#attachment-POST-upload__table_p1v_nnj_js__entry__2}

| 値 | 説明 |
|-|-|
| Content-Type | マルチパートアップロードのメッセージ本文に含まれるファイルのコンテンツタイプ。 注: Content-Type は、フォームデータ内ではなく、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}

| 名前 | 説明 |
|-|-|
| value | 必須です。属性の新しい値。 データタイプ：文字列 |
[表 : 76. 要求本文パラメーター (XML または JSON)]

### ヘッダー

次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#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 |
| Content-Type | 要求本文のデータ形式。サポートされるタイプ：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/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#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 | 属性のキーと値のペアを含むオブジェクト。 データタイプ: オブジェクト "result": { "key": "String", "value": "String" } |
| result.key | 属性キー。 データタイプ：文字列 テーブル:添付ファイル属性 \[sys_attachment_attribute\] 列:キー |
| result.value | 属性値。 データタイプ：文字列 テーブル:添付ファイル属性 \[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"
      }
    }