Azure File Storage
Microsoft Azure Storage は、クラウド上のデータに対して高度にスケーラブルで持続性があり、高可用なストレージを備えており、モダン アプリケーションのデータ ストレージ ソリューションとして機能します。 File Storage に接続して、Azure Storage アカウント内のファイルの作成、更新、取得、削除などのさまざまな操作を実行します。
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | リージョン |
|---|---|---|
| コピロット スタジオ | Premium | すべての地域 Power Automate |
| ロジック アプリ | Standard | すべての Logic Apps リージョン |
| Power Apps | Premium | すべての Power Apps リージョン |
| Power Automate | Premium | すべての地域 Power Automate |
| お問い合わせ | |
|---|---|
| 名前 | Microsoft |
| URL |
Microsoft LogicApps のサポート Microsoft Power Automate のサポート Microsoft Power Apps のサポート |
| コネクタ メタデータ | |
|---|---|
| Publisher | Microsoft |
| Website | https://azure.microsoft.com/services/storage/files/ |
チャンク機能をサポートするアクション。
これらのアクションを使用して、最大 300 MB のファイルを処理できます。 この機能は既定で有効になっています。
既知の問題と制限事項
- ロジック アプリは、両方が同じリージョンにある場合、ファイアウォールの背後にあるストレージ アカウントに直接アクセスすることはできません。 回避策として、ロジック アプリとストレージ アカウントをさまざまなリージョンに配置できます。 Azure Logic Apps からファイアウォールの背後にあるストレージ アカウントへのアクセスを有効にする方法の詳細については、ファイアウォールの背後にあるストレージ アカウントへのアクセスを参照してください。
ファイル エンドポイントを使用して Azure File コネクタに接続する
パラメーターに完全な Azure Storage ファイル エンドポイント
Azure Storage account name or file endpoint入力します。スキーマを含む完全なエンドポイントを指定する必要があります。次に例を示します。
https://account.file.core.windows.net/-
https://account-secondary.file.core.windows.net/(セカンダリ エンドポイントに接続する場合) - 相対 URL (たとえば、
account.file.core.windows.net) は拒否されます。
特定のストレージ アカウントの Azure Storage ファイル エンドポイントを取得する
このファイル エンドポイントを取得する方法は複数あります。
Azure portal を使用
- Microsoft Azure で、接続する Azure Storage アカウントに移動します
- [
Settingsセクション (左側のブレード) で、Endpoints - ファイル エンドポイントは、
file serviceテキスト ボックスの [ファイル サービス] の下に表示されます。
ストレージ アカウントの使用 - プロパティの取得 REST API 呼び出し
- Azure Storage アカウントの
subscription Idとresource group nameを取得します。 - ストレージ アカウント - プロパティの取得に移動する
- HTTP 呼び出しの右上隅にある [
Try it] ボタンをクリックします - サインイン (ユーザーはストレージ アカウントにアクセスできる必要があります)
- Azure Storage アカウントが配置されている Azure テナントを選択する
- Azure Storage のアカウント名、リソース グループ名を入力し、ストレージ アカウントが存在するサブスクリプションを選択します
- クリック
Run - ファイル エンドポイントは、応答
fileオブジェクトの下primaryEndpointsプロパティにあります
- Azure Storage アカウントの
一般的な制限
| 名前 | 価値 |
|---|---|
| 最大ファイル サイズ (MB 単位) | 50 |
| 帯域幅の時間間隔内でコネクタとの間で転送される最大メガバイト数 (接続ごと) | 1000 |
| 帯域幅の時間間隔 (ミリ秒単位) | 60000 |
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| デフォルト | 接続を作成するためのパラメーター。 | すべてのリージョン | 共有可能 |
デフォルト
適用対象: すべてのリージョン
接続を作成するためのパラメーター。
これは共有可能な接続です。 電源アプリが別のユーザーと共有されている場合は、接続も共有されます。 詳細については、 キャンバス アプリのコネクタの概要 - Power Apps |Microsoft Docs
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| Azure Storage アカウント名またはファイル エンドポイント | 文字列 | コネクタで使用する必要がある Azure Storage アカウントの名前またはファイル エンドポイント。 | 正しい |
| Azure Storage アカウントのアクセス キー | securestring | 有効なプライマリ/セカンダリ Azure Storage アカウント アクセス キーを指定します。 | 正しい |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 600 | 60 秒 |
アクション
| パスを使用してファイル メタデータを取得する |
この操作では、パスを使用してファイル メタデータを取得します。 |
| パスを使用してファイルコンテンツを取得する |
この操作では、パスを使用してファイルの内容を取得します |
| ファイル コンテンツの取得 |
この操作では、ID を使用してファイルの内容を取得します。 |
| ファイルのコピー |
この操作により、ファイルがコピーされます。 |
| ファイルのメタデータを取得する |
この操作では、ファイル ID を使用してファイル メタデータを取得します。 |
| ファイルを一覧表示する |
この操作では、フォルダー内のファイルが一覧表示されます。 |
| ファイルを作成する |
この操作により、ファイルが Azure File Storage にアップロードされます。 |
| ファイルを削除する |
この操作により、ファイルが削除されます。 |
| ファイルを更新する |
この操作では、Azure File Storage 内のファイルが更新されます。 |
| フォルダーへのアーカイブの抽出 |
この操作により、アーカイブ ファイルがフォルダー (例: .zip) に抽出されます。 |
パスを使用してファイル メタデータを取得する
この操作では、パスを使用してファイル メタデータを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ファイルパス
|
path | True | string |
ファイルへの一意のパスを指定する |
戻り値
BLOB のメタデータ
- Body
- BlobMetadata
パスを使用してファイルコンテンツを取得する
この操作では、パスを使用してファイルの内容を取得します
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ファイルパス
|
path | True | string |
ファイルへの一意のパスを指定する |
|
コンテンツ タイプの推論
|
inferContentType | boolean |
拡張機能に基づいてコンテンツ タイプを推論する |
戻り値
ファイルの内容。
- ファイル コンテンツ
- binary
ファイル コンテンツの取得
この操作では、ID を使用してファイルの内容を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
File
|
id | True | string |
コンテンツを取得するファイルを指定する |
|
コンテンツ タイプの推論
|
inferContentType | boolean |
拡張機能に基づいてコンテンツ タイプを推論する |
戻り値
ファイルの内容。
- ファイル コンテンツ
- binary
ファイルのコピー
この操作により、ファイルがコピーされます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ソース URL
|
source | True | string |
ソース ファイルの URL を指定する |
|
変換先ファイルのパス
|
destination | True | string |
ターゲット ファイル名を含む宛先ファイル パスを指定する |
|
上書き。
|
overwrite | boolean |
コピー先ファイルを上書きする必要がありますか (true/false) |
戻り値
BLOB のメタデータ
- Body
- BlobMetadata
ファイルのメタデータを取得する
この操作では、ファイル ID を使用してファイル メタデータを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
File
|
id | True | string |
メタデータを取得するファイルを指定する |
戻り値
BLOB のメタデータ
- Body
- BlobMetadata
ファイルを一覧表示する
この操作では、フォルダー内のファイルが一覧表示されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
フォルダー
|
id | True | string |
フォルダーを指定する |
戻り値
BLOB メタデータのページを表します。
- Body
- BlobMetadataPage
ファイルを作成する
この操作により、ファイルが Azure File Storage にアップロードされます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
フォルダー パス
|
folderPath | True | string |
アップロードするフォルダー パスを指定する |
|
ファイル名
|
name | True | string |
作成するファイルの名前を指定する |
|
ファイル コンテンツ
|
body | True | binary |
アップロードするファイルの内容を指定する |
戻り値
BLOB のメタデータ
- Body
- BlobMetadata
ファイルを削除する
この操作により、ファイルが削除されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
File
|
id | True | string |
削除するファイルを指定する |
ファイルを更新する
この操作では、Azure File Storage 内のファイルが更新されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
File
|
id | True | string |
更新するファイルを指定する |
|
ファイル コンテンツ
|
body | True | binary |
ファイルを更新する内容を指定する |
戻り値
BLOB のメタデータ
- Body
- BlobMetadata
フォルダーへのアーカイブの抽出
この操作により、アーカイブ ファイルがフォルダー (例: .zip) に抽出されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ソース アーカイブ ファイルのパス
|
source | True | string |
アーカイブ ファイルへのパスを指定する |
|
コピー先フォルダーのパス
|
destination | True | string |
アーカイブの内容を抽出する Azure File Storage のパスを指定する |
|
上書き。
|
overwrite | boolean |
宛先ファイルを上書きする必要がありますか (true/false) |
戻り値
- response
- array of BlobMetadata
定義
BlobMetadata
BLOB のメタデータ
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ID (アイディー)
|
Id | string |
ファイルまたはフォルダーの一意の ID。 |
|
名前
|
Name | string |
ファイルまたはフォルダーの名前。 |
|
DisplayName
|
DisplayName | string |
ファイルまたはフォルダーの表示名。 |
|
経路
|
Path | string |
ファイルまたはフォルダーのパス。 |
|
LastModified
|
LastModified | date-time |
ファイルまたはフォルダーが最後に変更された日時。 |
|
サイズ
|
Size | integer |
ファイルまたはフォルダーのサイズ。 |
|
メディアタイプ
|
MediaType | string |
ファイルまたはフォルダーのメディアの種類。 |
|
IsFolder
|
IsFolder | boolean |
BLOB がフォルダーであるかどうかを示すブール値 (true、false)。 |
|
ETag
|
ETag | string |
ファイルまたはフォルダーの etag。 |
|
FileLocator
|
FileLocator | string |
ファイルまたはフォルダーの filelocator。 |
BlobMetadataPage
BLOB メタデータのページを表します。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
value
|
value | array of BlobMetadata |
BLOB メタデータコレクション。 |
binary
これは基本的なデータ型 'バイナリ' です。