# プロファイルプロキシを一括変更

複数のブラウザープロファイルにプロキシを紐付けます。
- **前提条件**
：
`envIds`
 または
`uniqueIds`
 の少なくとも一方を指定します。
`proxyId`
 を指定する場合、それがチーム内に既に存在していなければならず、存在しなければ自動作成されるのではなく呼び出しが拒否されます。
- **副作用**
：各プロファイルに
`proxyId`
 を書き込みます。デフォルトでは、
`proxyId`
 を省略または
`0`
 にした場合、接続情報が完全に一致する既存のプロキシが再利用され、一致するものがなければ
**呼び出し元のチームに新しいプロキシレコードが作成されます**
。
- **完了シグナル**
：同期的です。起動中のブラウザーは起動時のプロキシを使い続けます。
- **リトライ**
：同じ
`proxyId`
 の再紐付けは冪等ですが、生の接続情報を含む呼び出しを繰り返すと、重複排除が外れるたびに新しいプロキシレコードが作られる可能性があります。

文書化されたビジネスエラー: `19106`, `19193`, `14023`。 各コードの意味は [Error Codes](/ja/api-reference/getting-started/error-codes) を参照してください。どの操作でも共通コードが返る場合があります。

Endpoint: POST /api/env/setProxy/batch
Version: 2026-09-05

## Request fields (application/json):

  - `envIds` (array)
    シリアルID付きのものを1つ選択してください。1つは必須です。

  - `proxy` (object, required)
    環境ごとにバインドされているプロキシを変更するために使用します。proxyId が指定されている場合は、その ID で表されるプロキシにバインドします。指定されていない場合は、新しく追加されたプロキシにバインドします。プロキシ情報が変更されていない場合は、再バインドは発生しません (proxyIp、proxyPort、proxyType、または proxyProvider のいずれかに変更があった場合は、新しいプロキシとみなされ、再バインドが成功します)。

  - `proxy.skipDuplicateProxy` (boolean)
    既存の `proxyId` を指定せずに接続情報を渡す場合に適用されます。 `true` の場合は一致するプロキシを再利用し、一致するものがなければ新規作成します。`false` の場合は一致するプロキシがあっても新規作成します。

  - `proxy.city` (string, required)
    市

  - `proxy.state` (string, required)
    州/県

  - `proxy.country` (string, required)
    国（具体的な国コードは付録を参照）。proxyProviderが16/17/18の場合に必須。

  - `proxy.encryptionType` (integer, required)
    暗号化方式。proxyProviderが11の場合、空にすることはできません。1: aes-128-gcm、2: aes-192-gcm、3: aes-256-gcm、4: aes-128-cfb、5: aes-192-cfb、6: aes-256-cfb、7: aes-128-ctr、8: aes-192-ctr、9: aes-256-ctr、10: rc4-md5、11: chacha20-ietf、12: xchacha20、13: chacha20-ietf-poly1305、14: xchacha20-ietf-poly1305

  - `proxy.proxyId` (string, required)
    プロキシID

  - `proxy.proxyIp` (string, required)
    プロキシIPアドレス。proxyProviderが16/17/18の場合は空欄でも構いません。それ以外の場合は必須です。

  - `proxy.proxyPort` (integer, required)
    プロキシポート（1～65535の数字のみ使用可能）。proxyProviderが16/17/18の場合は空欄でも構いません。それ以外の場合は必須です。

  - `proxy.proxyType` (integer, required)
    プロキシの種類。0: http、1: https。proxyProviderが7/8の場合は空にすることはできません。

  - `proxy.proxyProvider` (string, required)
    プロキシ種別 0: http、1: https、2: socks5、3: ssh、4: Oxylabs、5: Proxys.io、7: Luminati、8: Lumauto、9: Oxylabsauto、10: Trojan、11: Shadowsocks、13: ABCPROXY、14: LunaProxy、15: IPHTML、16: PiaProxy、17: 922S5、18: 360Proxy

  - `proxy.proxyName` (string, required)
    プロキシ名（最大600文字）

  - `proxy.password` (string, required)
    パスワード（最大100文字）

  - `proxy.refreshUrl` (string, required)
    URLを更新

  - `proxy.ipMonitor` (boolean, required)
    IPアドレス変更監視を有効にしますか？ true：オン、false：オフ

  - `proxy.ipChangeAction` (integer, required)
    IPアドレス変更監視：0：アクセスをブロック、1：警告

  - `proxy.username` (string, required)
    ユーザー名（最大200文字）

  - `uniqueIds` (array)
    環境IDを含むものを選択してください（必須項目です）

## Response 200:

  - `200` (unknown)
    成功。`data` は単一の boolean 値です。

## Response 200 fields (application/json):

  - `code` (integer)

  - `msg` (string | null)

  - `data` (boolean)

  - `requestId` (string, required)

