共有を作成する

  • [アーティクル]

この操作によりCreate Share、指定したアカウントの下に新しいAzure Files共有が作成されます。 この API は完全にサポートされていますが、これはレガシ管理 API です。 代わりに、Azure Storage リソース プロバイダー (Microsoft.Storage) によって提供される ファイル共有 - 作成を使用することをお勧めします。 Azure Storage リソース プロバイダーを使用してプログラムでリソースを FileShare 操作する方法の詳細については、「 FileShares に対する操作」を参照してください。

同じ名前の共有が既に存在する場合、操作は失敗します。 共有リソースには、その共有のメタデータとプロパティが含まれます。 共有に含まれるファイルの一覧は含まれません。

プロトコルの可用性

有効なファイル共有プロトコル 使用可能
サーバー メッセージ ブロック (SMB) はい
Network File System (NFS) はい

要求

次に示すように、要求を Create Share 構築できます。 HTTPS を使用することをお勧めします。

Method 要求 URI HTTP バージョン
PUT https://myaccount.file.core.windows.net/myshare?restype=share HTTP/1.1

次のように、要求 URI に表示されるパス コンポーネントを独自のパス コンポーネントに置き換えます。

パス コンポーネント 説明
myaccount ご利用のストレージ アカウントの名前。
myshare ファイル共有の名前。 名前には小文字のみを含めることができます。

パスの名前付けの制限の詳細については、「 名前と参照共有、ディレクトリ、ファイル、およびメタデータ」を参照してください。

URI パラメーター

次の追加パラメーターを要求 URI に指定できます。

パラメーター 説明
timeout 省略可能。 timeout パラメーターは、秒単位で表されます。 詳細については、「 ファイル サービス操作のタイムアウトを設定する」を参照してください。

要求ヘッダー

必須の要求ヘッダーと省略可能な要求ヘッダーを次の表に示します。

要求ヘッダー 説明
Authorization 必須。 承認スキーム、アカウント名、署名を指定します。 詳細については、「Azure Storage への要求を承認する」をご覧ください。
Date または x-ms-date 必須。 要求の世界協定時刻 (UTC) を指定します。 詳細については、「Azure Storage への要求を承認する」をご覧ください。
x-ms-version すべての承認された要求に必要です。 この要求に使用する操作のバージョンを指定します。 詳細については、「 Azure Storage サービスのバージョン管理」を参照してください。
x-ms-meta-name:value 省略可能。 共有にメタデータとして関連付ける名前と値のペアを指定します。

メタデータ名は 、C# 識別子の名前付け規則に従う必要があります。
x-ms-share-quota 省略可能。 バージョン 2015-02-21 以降でサポートされています。 共有の最大サイズをギビバイト (GiB) 単位で指定します。
x-ms-access-tier 省略可能。 バージョン 2019-12-12 以降でサポートされています。 共有のアクセス層を指定します。 有効な値は TransactionOptimized、Hot、Cool です。 ファイル共有層の詳細については、「Azure Files ストレージ層」を参照してください。
x-ms-enabled-protocols: <SMB \| NFS> 省略可能。 バージョン 2019-07-07 以降でサポートされています。 共有で有効なプロトコルを指定します。 指定されていない場合、既定値は SMB です。

- SMB: 共有にアクセスできるのは、SMBv3.0、SMBv2.1、REST です。
- NFS: 共有には NFSv4.1 からアクセスできます。 このオプションには Premium アカウントが必要です。
x-ms-root-squash: <NoRootSquash \| RootSquash \| AllSquash> 省略可能。 NFS のみ。 バージョン 2019-07-07 以降でサポートされています。 NFS が有効になっている場合の共有のルート スカッシュ動作を指定します。 指定しない場合、既定値は NoRootSquash です。

- NoRootSquash: ルート スカッシュをオフにします。
- RootSquash: uid/gid 0 からの要求を匿名 uid/gid にマップします。
- AllSquash: すべての uid と gid を匿名ユーザーにマップします。
x-ms-client-request-id 省略可能。 ログ記録の構成時にログに記録される 1 kibibyte (KiB) 文字制限を使用して、クライアントによって生成された不透明な値を提供します。 このヘッダーを使用して、クライアント側のアクティビティとサーバーが受信する要求を関連付けるよう強くお勧めします。 詳細については、「Azure Filesの監視」を参照してください。

要求本文

[なし] :

要求のサンプル

PUT https://myaccount.file.core.windows.net/myshare?restype=share HTTP/1.1  
  
Request Headers:  
x-ms-version: 2020-02-10  
x-ms-date: <date>  
x-ms-meta-Name: StorageSample  
x-ms-enabled-protocols: NFS
x-ms-root-squash: RootSquash
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=

Response

応答には、HTTP 状態コードおよび一連の応答ヘッダーが含まれています。

status code

操作が正常に終了すると、状態コード 201 (Created) が返されます。

詳細については、「 状態とエラー コード」を参照してください。

応答ヘッダー

この操作の応答には、次のヘッダーが含まれています。 応答には、追加の標準 HTTP ヘッダーも含まれる場合があります。 すべての標準ヘッダーは 、HTTP/1.1 プロトコル仕様に準拠しています。

応答ヘッダー 説明
ETag 共有のバージョンを表す値を引用符で囲んで格納します。
Last-Modified 共有が最後に変更された日時を返します。 日付形式は RFC 1123 に従います。 詳細については、「 ヘッダーの日付/時刻値を表す」を参照してください。

共有またはそのプロパティやメタデータを変更する操作を行うと、最終更新時刻が更新されます。 ファイルに対する操作は、共有の最終変更時刻には影響しません。
x-ms-request-id 要求を一意に識別し、それを使用して要求のトラブルシューティングを行うことができます。 詳細については、「API 操作のトラブルシューティング」を参照してください。
x-ms-version 要求の実行に使用されたAzure Filesバージョンを示します。
Date サービスによって生成される UTC 日付/時刻値。応答が開始された時刻を示します。
x-ms-client-request-id 要求と対応する応答のトラブルシューティングに使用できます。 このヘッダーの値は、要求に存在し、その値に 1,024 文字以下の ASCII 文字が含まれている場合、ヘッダーの値 x-ms-client-request-id と等しくなります。 ヘッダーが x-ms-client-request-id 要求に存在しない場合は、応答に存在しません。

応答本文

[なし] :

応答のサンプル

Response Status:  
HTTP/1.1 201 Created  
  
Response Headers:  
Transfer-Encoding: chunked  
Date: <date>  
ETag: "0x8CB14C3E29B7E82"  
Last-Modified: <date>  
x-ms-version: 2020-02-10  
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0

承認

この操作を呼び出すことができるのはアカウント所有者のみです。

注釈

共有はストレージ アカウント内にすぐに作成されます。 ある共有を別の共有内に入れ子にすることはできません。

共有を作成するときに、要求に 1 つ以上のメタデータ ヘッダーを含めることで、共有のメタデータを指定できます。 メタデータ ヘッダーは、x-ms-meta-name:value という形式です。

を呼び出 Create Shareすときに同じ名前の共有が削除されている場合、サーバーは状態コード 409 (競合) を返し、追加のエラー情報は共有が削除されていることを示します。

共有サイズ クォータを使用して、共有に格納されるファイルのサイズを制限できます。 クォータによってスナップショットのサイズが制限されることはありません。 ストレージ アカウントの課金サイズの計算に使用されるファイルに関連付けられているオーバーヘッドは、クォータには考慮されません。

共有上のファイルのサイズの合計が共有に設定されているクォータを超えると、ファイルのサイズを増やそうとすると失敗し、空でない新しいファイル (REST 経由) の作成は失敗します。 空のファイルは引き続き作成できます。

クォータの変更または設定は課金には影響しません。 ファイルのサイズとオーバーヘッドに対して引き続き課金されます。

こちらもご覧ください

Azure Files共有に対する操作