メインコンテンツへスキップ
PUT
「Box SDKのバージョニング戦略について詳しく学ぶ。」

承認

Authorization
string
header
必須

The access token received from the authorization server in the OAuth 2.0 flow.

ヘッダー

box-version
enum<string>
必須

Version header.

利用可能なオプション:
2026.0

パスパラメータ

shuttle_subject_mapping_id
string
必須

Shuttleサブジェクトマッピングの一意の識別子。

ボディ

application/json

既存のShuttleサブジェクトマッピングを更新するために使用するリクエスト本文。リクエスト本文で指定されたフィールドのみが変更されます。job_id、id、type、source、discovered_subject_id、revisionは変更できません。

is_subject_skipped
boolean

移行時にこのサブジェクトをスキップするかどうか。

例:

true

target
Shuttleターゲットサブジェクトの入力 · object

マッピング先のBoxターゲット。スキップするサブジェクトの場合にのみnullに設定します。マッピングが有効な状態でnullに設定すると、検証に失敗します。is_subject_skippedのみを更新する場合、既存のターゲットが維持されます。

例:

レスポンス

更新されたShuttleサブジェクトマッピングを返します。

ShuttleサブジェクトマッピングのStandard版の表示。サブジェクトマッピングは、検出されたソースサブジェクトをBoxのユーザーまたはグループに対応付けるか、そのサブジェクトをスキップ対象として設定します。

id
string
必須

Shuttleサブジェクトマッピングの一意の識別子。

例:

"6a3ba7b12ea17bc9461eeace"

type
enum<string>
必須

値は常にshuttle_subject_mappingになります。

利用可能なオプション:
shuttle_subject_mapping
例:

"shuttle_subject_mapping"

job_id
string
必須

このマッピングが属しているShuttleジョブの一意の識別子。

例:

"6a3ba68e810d9156194530a1"

is_subject_skipped
boolean
必須

移行時にこのサブジェクトをスキップするかどうか。

例:

false

source
Shuttleサブジェクト · object
必須

マッピング対象のソースサブジェクト。

discovered_subject_id
string | null

このマッピングの対象となる、検出されたサブジェクトの一意の識別子。このフィールドが追跡されるようになる前に作成された従来のマッピングではnull。

例:

"6a3ba7c02ea17bc9461eeacf"

revision
integer<int32> | null

このマッピングの解決に使用された検出要件のリビジョン。従来のマッピングではnull。

例:

3

target
Shuttleターゲットサブジェクト · object

Boxのターゲットサブジェクト。サブジェクトをスキップする場合、またはまだ割り当てられていない場合はnull。

例:
最終更新日 2026年11月4日