Box

Box™ は、ファイルを安全に同期し、簡単な共有を実現するサービスです。 Box に接続してファイルを管理します。 Box でファイルのアップロード、更新、取得、削除など、さまざまなアクションを実行できます。

このコネクタは、次の製品および地域で利用可能です。

Service クラス 地域
Logic Apps 標準 以下を除くすべての Logic Apps 地域 :
     -   Azure 中国の地域
     -   国防総省 (DoD)
Power Automate 標準 以下を除くすべての Power Automate 地域 :
     -   21 Vianet が運用する中国のクラウド
Power Apps 標準 以下を除くすべての Power Apps 地域 :
     -   21 Vianet が運用する中国のクラウド
Connector Metadata
発行者 マイクロソフト
Web サイト https://www.box.com/
プライバシー ポリシー https://www.box.com/legal/privacypolicy

Box API 状態

Box API の停止 を追跡するには、このリソースを使用してください

既知の問題と制限事項

  1. コネクタはシングル サインオン (SSO) 接続をサポートしていません。代わりに標準接続を使用してください。
  2. ファイル識別子パラメーターと実際のファイル名を混同しないでください。 Box REST API の制限により、以下の文字を含む無効なファイル識別子 - [\ { } " < >] を使用すると、コネクタの GetawayTimeout エラーが発生する場合があります。
  3. ルート フォルダーを含め、指定されたパスの各フォルダー (フォルダー パスまたはファイル パス) に、10,000 を超えるアイテムを含めることはできません。
  4. ファイル ピッカーを使用してフォルダーのファイルを選択すると、結果のパスは '//All Files' で始まる場合があります (例: '//All Files/My Folder/MyFile.txt')。 ルートに新しい 'All Files' フォルダーが作成されないようにするには、このパスを手動で '/My Folder/MyFile.txt' に変更する必要があります。 ルート フォルダーを参照するには、'//All Files' -> '/' のようにスラッシュを 1 つ使用します。
  5. トリガーは、ほとんどの場合、トリガーは対応するイベントの発生時にほぼすぐに起動しますが、基板となる API の制限によりまれにトリガーの起動の遅延に最大 1 日かかる状況が生じることがあります。 詳細については、(Box イベント API) を参照してください。 その間、ファイルはフォルダに保管しておくことをお勧めします。 そうしないと、トリガー ロジックによってレポートされません。
  6. ファイルがフォルダに既に存在する場合、同じ名前のファイルの再アップロードは、作成イベントではなく更新イベントと見なされます。
  7. このコネクタは表形式のコネクタではなくなったため、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 におけるフォルダーの一意の識別子。

戻り値

ルート フォルダー内のファイルとフォルダーを一覧表示する

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

ファイルまたはフォルダーを最後に変更したユーザーの名前です。

バイナリ

これは基本的なデータ型 [バイナリ] です。