プロキシ API の設定を更新する
プロキシ API の設定(
クラウド版
)を更新します。
URL
クラウド版
https://sample.cybozu.com/g/api/v1/system/api/admin/proxies/code/プロキシコード
パッケージ版
- Windows 環境
- http://
サーバーの IP アドレスまたはホスト名
/scripts/インストール識別子
/grn.exe/api/v1/system/api/admin/proxies/code/プロキシコード
- Linux 環境
- http://
サーバーの IP アドレスまたはホスト名
/cgi-bin/インストール識別子
/grn.cgi/api/v1/system/api/admin/proxies/code/プロキシコード
パスパラメーター
パラメーター名 |
説明 |
プロキシコード |
設定を更新するプロキシ API のプロキシコード |
HTTP メソッド
PATCH
利用できるバージョン
- クラウド版 Garoon
- パッケージ版 Garoon 5.15 以降
必要なアクセス権
- API に関する基本システムの管理者権限(
クラウド版
)
リクエスト
パラメーター
パラメーター名 |
型 |
必須 |
説明 |
status |
文字列 |
省略可 |
プロキシ API 設定のステータス 次のいずれかの値を指定します。省略すると「INACTIVE」が設定されます。 |
method |
文字列 |
必須 |
HTTP メソッド 次のいずれかの値を指定します。 |
url |
文字列 |
必須 |
「http://」または「https://」で始まる URL |
parameters[].key |
文字列 |
省略可 |
パラメーターのキー |
parameters[].value |
文字列 |
省略可 |
パラメーターの値 |
headers[].key |
文字列 |
省略可 |
ヘッダーのキー |
headers[].value |
文字列 |
省略可 |
ヘッダーの値 |
body[].key |
文字列 |
省略可 |
ボディのキー |
body[].value |
文字列 |
省略可 |
ボディの値 |
リクエストの例
URL
https://sample.cybozu.com/g/api/v1/system/api/admin/proxies/code/sample
ヘッダー
1
2
3
4
|
{
"X-Cybozu-Authorization": "QWRtaW5pc3RyYXRvcjpjeWJvenU=",
"Content-Type": "application/json"
}
|
リクエストヘッダーの詳細は
Garoon REST API の共通仕様 を参照してください。
ボディ
1
2
3
4
5
6
7
8
9
|
{
"url": "https://api.example.com",
"headers": [
{
"key": "Authorization",
"value": "QWRtaW5pc3RyYXRvcjpjeWJvenU="
}
]
}
|
レスポンス
プロパティ
プロパティ名 |
型 |
説明 |
status |
文字列 |
プロキシ API 設定のステータス |
proxyCode |
文字列 |
プロキシコード |
method |
文字列 |
HTTP メソッド |
url |
文字列 |
URL |
parameters[].key |
文字列 |
パラメーターのキー |
parameters[].value |
文字列 |
パラメーターの値 |
headers[].key |
文字列 |
ヘッダーのキー |
headers[].value |
文字列 |
ヘッダーの値 |
body[].key |
文字列 |
ボディのキー |
body[].value |
文字列 |
ボディの値 |
レスポンスの例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
|
{
"status": "ACTIVE",
"proxyCode": "sample",
"method": "PUT",
"url": "https://api.example.com",
"parameters": [
{
"key": "app",
"value": "1203"
}
],
"headers": [
{
"key": "Authorization",
"value": "QWRtaW5pc3RyYXRvcjpjeWJvenU="
},
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": [
{
"key": "id",
"value": "13"
}
]
}
|
サンプルコード
curl を使ったリクエスト
1
2
3
4
5
6
7
8
9
10
11
12
|
curl -X PATCH 'https://sample.cybozu.com/g/api/v1/system/api/admin/proxies/code/sample' \
-H 'X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU=' \
-H 'Content-Type: application/json' \
-d '{
"url": "https://api.example.com",
"headers": [
{
"key": "Authorization",
"value": "QWRtaW5pc3RyYXRvcjpjeWJvenU="
}
]
}
|
1
2
3
4
5
6
7
8
9
10
11
|
const body = {
url: 'https://api.example.com',
headers: [
{
key: 'Authorization',
value: 'QWRtaW5pc3RyYXRvcjpjeWJvenU='
}
]
};
await garoon.api('/api/v1/system/api/admin/proxies/code/sample', 'PATCH', body);
|