Box
Box™ は、ファイルを安全に同期し、簡単な共有を実現するサービスです。 Box に接続してファイルを管理します。 Box でファイルのアップロード、更新、取得、削除など、さまざまなアクションを実行できます。
このコネクタは、次の製品および地域で利用可能です。
| Service | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 中国の地域 - 国防総省 (DoD) |
| Power Automate | 標準 | 以下を除くすべての Power Automate 地域 : - 21 Vianet が運用する中国のクラウド |
| Power Apps | 標準 | 以下を除くすべての Power Apps 地域 : - 21 Vianet が運用する中国のクラウド |
| 連絡先 | |
|---|---|
| 件名 | Microsoft |
| URL | Microsoft LogicApps サポート Microsoft Power Automate サポート Microsoft Power Apps サポート |
| Connector Metadata | |
|---|---|
| 発行者 | マイクロソフト |
| Web サイト | https://www.box.com/ |
| プライバシー ポリシー | https://www.box.com/legal/privacypolicy |
Box API 状態
Box API の停止 を追跡するには、このリソースを使用してください
既知の問題と制限事項
- コネクタはシングル サインオン (SSO) 接続をサポートしていません。代わりに標準接続を使用してください。
- ファイル識別子パラメーターと実際のファイル名を混同しないでください。 Box REST API の制限により、以下の文字を含む無効なファイル識別子 - [\ { } " < >] を使用すると、コネクタの GetawayTimeout エラーが発生する場合があります。
- ルート フォルダーを含め、指定されたパスの各フォルダー (フォルダー パスまたはファイル パス) に、10,000 を超えるアイテムを含めることはできません。
- ファイル ピッカーを使用してフォルダーのファイルを選択すると、結果のパスは '//All Files' で始まる場合があります (例: '//All Files/My Folder/MyFile.txt')。 ルートに新しい 'All Files' フォルダーが作成されないようにするには、このパスを手動で '/My Folder/MyFile.txt' に変更する必要があります。 ルート フォルダーを参照するには、'//All Files' -> '/' のようにスラッシュを 1 つ使用します。
- トリガーは、ほとんどの場合、トリガーは対応するイベントの発生時にほぼすぐに起動しますが、基板となる API の制限によりまれにトリガーの起動の遅延に最大 1 日かかる状況が生じることがあります。 詳細については、(Box イベント API) を参照してください。 その間、ファイルはフォルダに保管しておくことをお勧めします。 そうしないと、トリガー ロジックによってレポートされません。
- ファイルがフォルダに既に存在する場合、同じ名前のファイルの再アップロードは、作成イベントではなく更新イベントと見なされます。
- このコネクタは表形式のコネクタではなくなったため、Excel コネクタを含め、表形式の データ ソース として使用できません。
一般的な制限
| 件名 | 価値 |
|---|---|
| 最大ファイル サイズ (MB) | 75 |
| フォルダー項目の最大数 | 10000 |
| 帯域幅の時間間隔内でコネクタとの間で転送されるメガバイトの最大数 (接続ごと) | 1000 |
| 帯域幅の時間間隔 (ミリ秒単位) | 60000 |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| ID を使用してファイル コンテンツを取得する |
ID を使用して Box からファイル コンテンツを取得します。 |
| ID を使用してファイル メタデータを取得する |
ファイル ID を使用して Box からファイル メタデータを取得します。 |
| アーカイブをフォルダに抽出します |
アーカイブ ファイル を Box のフォルダーに展開します (例: .zip)。 |
| パスを使用してファイル コンテンツを取得 |
パスを使用して Box からファイル コンテンツを取得します。 |
| パスを使用してファイル メタデータを取得 |
パスを使用して Box からファイル メタデータを取得します。 |
| ファイルをコピーする |
Box のファイル パスにファイルをコピーします。 |
| ファイルを作成する |
Box にファイルをアップロードします。 |
| ファイルを削除 |
Box から既存のファイルを削除します。 |
| ファイルを更新する |
Box 内の既存のファイルを更新します。 |
| フォルダー内のファイルとフォルダーを一覧表示する |
Box フォルダー内のファイルとフォルダーを一覧表示します。 |
| ルート フォルダー内のファイルとフォルダーを一覧表示する |
Box ルート フォルダー内のファイルとフォルダーを一覧表示します。 |
ID を使用してファイル コンテンツを取得する
ID を使用して Box からファイル コンテンツを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ファイル ID
|
id | True | string |
Box におけるファイルの一意の識別子。 |
|
コンテンツ タイプの推測
|
inferContentType | boolean |
拡張に基づいてコンテンツ タイプを推測するためのブール値 (true、false)。 |
戻り値
ファイルのコンテンツ。
- ファイル コンテンツ
- binary
ID を使用してファイル メタデータを取得する
ファイル ID を使用して Box からファイル メタデータを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ファイル ID
|
id | True | string |
Box におけるファイルの一意の識別子。 |
戻り値
BLOB メタデータ
- 本文
- BlobMetadata
アーカイブをフォルダに抽出します
アーカイブ ファイル を Box のフォルダーに展開します (例: .zip)。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ソース アーカイブ ファイルのパス
|
source | True | string |
アーカイブ ファイルへのパス。 |
|
宛先フォルダー パス
|
destination | True | string |
アーカイブの内容を抽出するための Box のパス。 |
|
上書き
|
overwrite | boolean |
[true] に設定されている場合、宛先ファイルを上書きします。 |
戻り値
パスを使用してファイル コンテンツを取得
パスを使用して Box からファイル コンテンツを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ファイル パス
|
path | True | string |
Box におけるファイルの一意のパス。 |
|
コンテンツ タイプの推測
|
inferContentType | boolean |
拡張に基づいてコンテンツ タイプを推測するためのブール値 (true、false)。 |
戻り値
ファイルのコンテンツ。
- ファイル コンテンツ
- binary
パスを使用してファイル メタデータを取得
パスを使用して Box からファイル メタデータを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ファイル パス
|
path | True | string |
Box におけるファイルの一意のパス。 |
戻り値
BLOB メタデータ
- 本文
- BlobMetadata
ファイルをコピーする
Box のファイル パスにファイルをコピーします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ソース URL
|
source | True | string |
ソース ファイルへの URL。 |
|
宛先ファイル パス
|
destination | True | string |
ターゲット ファイル名を含む、Box の宛先ファイル パス。 |
|
上書き
|
overwrite | boolean |
[true] に設定されている場合、宛先ファイルを上書きします。 |
戻り値
BLOB メタデータ
- 本文
- BlobMetadata
ファイルを作成する
Box にファイルをアップロードします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
フォルダー パス
|
folderPath | True | string |
ファイルを Box にアップロードするためのフォルダー パス。 |
|
ファイル名
|
name | True | string |
Box で作成するファイルの名前。 |
|
ファイル コンテンツ
|
body | True | binary |
Box にアップロードするファイルのコンテンツ。 |
戻り値
BLOB メタデータ
- 本文
- BlobMetadata
ファイルを削除
Box から既存のファイルを削除します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ファイル ID
|
id | True | string |
Box で削除するファイルの一意の識別子。 |
ファイルを更新する
Box 内の既存のファイルを更新します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ファイル ID
|
id | True | string |
Box で更新するファイルの一意の識別子。 |
|
ファイル コンテンツ
|
body | True | binary |
Box で更新するファイルのコンテンツ。 |
戻り値
BLOB メタデータ
- 本文
- BlobMetadata
フォルダー内のファイルとフォルダーを一覧表示する
Box フォルダー内のファイルとフォルダーを一覧表示します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
フォルダー ID
|
id | True | string |
Box におけるフォルダーの一意の識別子。 |
戻り値
ルート フォルダー内のファイルとフォルダーを一覧表示する
トリガー
| ファイルが作成されたとき (プロパティのみ) (V2) |
この操作は、フォルダーに新しいファイルが作成されたときにフローをトリガーします。 サブフォルダーでファイルが追加および更新されても、トリガーは起動しません。 サブフォルダーをトリガーする必要がある場合は、複数のトリガーを作成する必要があります。 トリガー-> 設定で「分割」オプションを無効にすると、トリガーの実行に成功した場合に「ファイルの一覧」の出力に空の配列が作成されることがあります。 |
| ファイルが作成されたとき (プロパティのみ) [非推奨] |
このアクションは非推奨になりました。 代わりに、ファイルが作成されたとき (プロパティのみ) (V2) を使用してください。
|
| ファイルが作成されたとき [非推奨] |
Box フォルダーに新しいファイルが作成されたときにフローをトリガーします。 サブフォルダーでファイルが追加および更新されても、トリガーは起動しません。 サブフォルダーをトリガーする必要がある場合は、複数のトリガーを作成する必要があります。 |
| ファイルが変更されたとき (プロパティのみ) |
この操作は、ファイルがフォルダー内で変更されたときにフローをトリガーします。 サブフォルダーでファイルが追加および更新されても、トリガーは起動しません。 サブフォルダーをトリガーする必要がある場合は、複数のトリガーを作成する必要があります。 |
| ファイルが変更されたとき (プロパティのみ) (V2) (プレビュー) |
この操作は、ファイルがフォルダー内で変更されたときにフローをトリガーします。 サブフォルダーでファイルが追加および更新されても、トリガーは起動しません。 サブフォルダーをトリガーする必要がある場合は、複数のトリガーを作成する必要があります。 トリガー-> 設定で「分割」オプションを無効にすると、トリガーの実行に成功した場合に「ファイルの一覧」の出力に空の配列が作成されることがあります。 |
| ファイルが変更されたとき [非推奨] |
Box フォルダーでファイルが変更されたときにフローをトリガーします。 サブフォルダーでファイルが追加および更新されても、トリガーは起動しません。 サブフォルダーをトリガーする必要がある場合は、複数のトリガーを作成する必要があります。 |
ファイルが作成されたとき (プロパティのみ) (V2)
この操作は、フォルダーに新しいファイルが作成されたときにフローをトリガーします。 サブフォルダーでファイルが追加および更新されても、トリガーは起動しません。 サブフォルダーをトリガーする必要がある場合は、複数のトリガーを作成する必要があります。 トリガー-> 設定で「分割」オプションを無効にすると、トリガーの実行に成功した場合に「ファイルの一覧」の出力に空の配列が作成されることがあります。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
フォルダー
|
folderId | True | string |
フォルダーの一意識別子です。 |
|
返されるファイルの数
|
maxFileCount | integer |
1回のトリガー実行により返されるファイルの最大数 (1-100)。 [分割] 設定により、トリガーが各アイテムを個別に処理するように強制できることに注意してください。 |
戻り値
BLOB メタデータ
- ファイルの一覧
- BlobMetadata
ファイルが作成されたとき (プロパティのみ) [非推奨]
このアクションは非推奨になりました。 代わりに、ファイルが作成されたとき (プロパティのみ) (V2) を使用してください。
この操作では、フォルダーに新しいファイルが作成されたときにフローをトリガーします。サブフォルダーでファイルが追加/更新された場合、トリガーは起動しません。サブフォルダーでトリガーする必要がある場合は、複数のトリガーを作成する必要があります。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
フォルダー
|
folderId | True | string |
フォルダーの一意識別子です。 |
|
返されるファイルの数
|
maxFileCount | integer |
1回のトリガー実行により返されるファイルの最大数 (1-100)。 [分割] 設定により、トリガーが各アイテムを個別に処理するように強制できることに注意してください。 |
戻り値
BLOB メタデータ
- ファイルの一覧
- BlobMetadata
ファイルが作成されたとき [非推奨]
Box フォルダーに新しいファイルが作成されたときにフローをトリガーします。 サブフォルダーでファイルが追加および更新されても、トリガーは起動しません。 サブフォルダーをトリガーする必要がある場合は、複数のトリガーを作成する必要があります。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
フォルダー ID
|
folderId | True | string |
Box におけるフォルダーの一意の識別子。 |
|
コンテンツ タイプの推測
|
inferContentType | boolean |
拡張に基づいてコンテンツ タイプを推測するためのブール値 (true、false)。 |
戻り値
ファイルのコンテンツ。
- ファイル コンテンツ
- binary
ファイルが変更されたとき (プロパティのみ)
この操作は、ファイルがフォルダー内で変更されたときにフローをトリガーします。 サブフォルダーでファイルが追加および更新されても、トリガーは起動しません。 サブフォルダーをトリガーする必要がある場合は、複数のトリガーを作成する必要があります。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
フォルダー
|
folderId | True | string |
フォルダーを選択する |
|
返されるファイルの数
|
maxFileCount | integer |
1回のトリガー実行により返されるファイルの最大数 (1-100)。 [分割] 設定により、トリガーが各アイテムを個別に処理するように強制できることに注意してください。 |
戻り値
BLOB メタデータ
- ファイルの一覧
- BlobMetadata
ファイルが変更されたとき (プロパティのみ) (V2) (プレビュー)
この操作は、ファイルがフォルダー内で変更されたときにフローをトリガーします。 サブフォルダーでファイルが追加および更新されても、トリガーは起動しません。 サブフォルダーをトリガーする必要がある場合は、複数のトリガーを作成する必要があります。 トリガー-> 設定で「分割」オプションを無効にすると、トリガーの実行に成功した場合に「ファイルの一覧」の出力に空の配列が作成されることがあります。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
フォルダー
|
folderId | True | string |
フォルダーを選択する |
|
返されるファイルの数
|
maxFileCount | integer |
1回のトリガー実行により返されるファイルの最大数 (1-100)。 [分割] 設定により、トリガーが各アイテムを個別に処理するように強制できることに注意してください。 |
戻り値
BLOB メタデータ
- ファイルの一覧
- BlobMetadata
ファイルが変更されたとき [非推奨]
Box フォルダーでファイルが変更されたときにフローをトリガーします。 サブフォルダーでファイルが追加および更新されても、トリガーは起動しません。 サブフォルダーをトリガーする必要がある場合は、複数のトリガーを作成する必要があります。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
フォルダー ID
|
folderId | True | string |
Box におけるフォルダーの一意の識別子。 |
|
コンテンツ タイプの推測
|
inferContentType | boolean |
拡張に基づいてコンテンツ タイプを推測するためのブール値 (true、false)。 |
戻り値
ファイルのコンテンツ。
- ファイル コンテンツ
- binary
定義
BlobMetadata
BLOB メタデータ
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ID
|
Id | string |
ファイルまたはフォルダーの一意 ID。 |
|
件名
|
Name | string |
ファイルまたはフォルダーの名前。 |
|
表示名
|
DisplayName | string |
ファイルまたはフォルダーの表示名。 |
|
パス
|
Path | string |
ファイルまたはフォルダーのパス。 |
|
LastModified
|
LastModified | date-time |
ファイルまたはフォルダーが最後に変更された日時です。 |
|
サイズ
|
Size | integer |
ファイルまたはフォルダーのサイズ。 |
|
MediaType
|
MediaType | string |
ファイルまたはフォルダーのメディア タイプ。 |
|
IsFolder
|
IsFolder | boolean |
BLOB がフォルダーであるかを示すブール値 (true、false)。 |
|
ETag
|
ETag | string |
ファイルまたはフォルダー ETag。 |
|
FileLocator
|
FileLocator | string |
ファイルまたはフォルダーの filelocator。 |
|
LastModifiedBy
|
LastModifiedBy | string |
ファイルまたはフォルダーを最後に変更したユーザーの名前です。 |
バイナリ
これは基本的なデータ型 [バイナリ] です。