> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# POST (/ext/unattendedsetup/quickaction)

> POST (/ext/unattendedsetup/quickaction)

# POST (/ext/unattendedsetup/quickaction)

対象の XBOX One 開発機のフロント パネル ボタンのいずれかに割り当てられているスクリプトを変更するか、フロント パネル スクリプトのいずれかを実行します。

* [URI パラメーター](#ID4EX)
* [必須の要求ヘッダー](#ID4E5)
* [必須の要求本文](#ID4EFB)
* [省略可能な要求本文](#ID4EZB)
* [応答](#ID4EMB)

## URI パラメーター

| パラメーター | 型 | 説明 |
| - | - | - |
| ButtonNumber | number | 操作対象のフロント パネル ボタンの番号 (省略可能) です。指定されていない場合は、新しいカスタム スクリプトをコンソールに追加する要求となります。 |
| Name | base64 エンコードされた文字列 | ボタンに適用するスクリプトの名前を示す省略可能な文字列です。指定されていない場合は、代わりに現在 ButtonNumber に関連付けられているスクリプトが実行されます。 |
| IsBuiltIn | boolean | 適用するスクリプトが、システムに付属する組み込みスクリプトか、ユーザーが以前にコンソールに追加したカスタム スクリプトかを示す省略可能なブール値です。 |

## 必須の要求ヘッダー

なし。

## 必須の要求本文

なし。

## 省略可能な要求本文

ButtonNumber が指定されていない場合、この呼び出しには、コンソールに追加するスクリプト ファイルを含むマルチパート準拠の HTTP 本文が必要です。

## 応答

呼び出しが成功し、要求がボタンに関連付けられたアクションの実行だった場合、サービスは次のメンバーを含む JSON オブジェクトを返します。

| メンバー | 型 | 説明 |
| - | - | - |
| Output | string | 要求されたボタンに関連付けられたスクリプトを実行した際の出力です。 |

呼び出しが、ボタンへのスクリプトの適用または新しいカスタム スクリプトの追加であった場合、応答本文はありません。

### HTTP ステータス コード

サービスは、このリソースに対してこのメソッドで行われた要求に応じて、このセクションのいずれかのステータス コードを返します。

| コード | 説明 |
| - | - |
| 200/204 | 操作は成功しました。 |
| 4XX | エラー コード。 |
| 5XX | エラー コード。 |

## 関連項目

##### 親

[/ext/unattendedsetup/quickaction](https://docs.xbox.com/ja-jp/reference/deviceportal/unattendedsetup/uri-extunattendedsetupquickaction.md)


## Related topics

- [GET (/ext/unattendedsetup/quickaction)](https://docs.xbox.com/ja-jp/reference/deviceportal/unattendedsetup/uri-extunattendedsetupquickaction-get.md)
- [/ext/unattendedsetup/quickaction (API の内容)](https://docs.xbox.com/ja-jp/reference/deviceportal/unattendedsetup/uri-extunattendedsetupquickaction.md)
- [POST (/ext/unattendedsetup/apply)](https://docs.xbox.com/ja-jp/reference/deviceportal/unattendedsetup/uri-extunattendedsetupapply-post.md)
- [POST (/ext/unattendedsetup/configure)](https://docs.xbox.com/ja-jp/reference/deviceportal/unattendedsetup/uri-extunattendedsetupconfigure-post.md)
- [POST (/ext/unattendedsetup/test)](https://docs.xbox.com/ja-jp/reference/deviceportal/unattendedsetup/uri-extunattendedsetuptest-post.md)