アクセス許可の作成

Create Permission 操作は、共有レベルでアクセス許可 (セキュリティ記述子) を作成します。 作成されたセキュリティ記述子は、共有内のファイルとディレクトリに使用できます。 この API は、バージョン 2019-02-02 以降で使用できます。

プロトコルの可用性

有効なファイル共有プロトコル	利用できる
SMB
NFS	なし

依頼

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

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

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

URI パラメーター

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

要求ヘッダー

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

要求本文

要求本文に JSON オブジェクトを配置して、セキュリティ記述子を作成します。 JSON オブジェクトには、次のフィールドを含めることができます。

SDDL を使用する場合、セキュリティ記述子の SDDL 文字列形式には、ドメイン相対識別子 (DU、DA、DD など) を含めることはできません。

{
    "permission": "<SDDL>"
}

バージョン 2024-11-04 以降では、必要に応じて、アクセス許可が SDDL 形式であることを明示的に指定できます。

{
    "format": "sddl",
    "permission": "<SDDL>"
}

バージョン 2024-11-04 以降では、base-64 でエンコードされたバイナリ形式でアクセス許可を作成することもできます。 その場合は、形式が "binary"であることを明示的に指定する必要があります。

{
    "format": "binary",
    "permission": "<base64>"
}

要求のサンプル

PUT https://myaccount.file.core.windows.net/myshare?restype=share&comp=filepermission HTTP/1.1  

Request Headers:
x-ms-date: Mon, 27 Jan 2014 22:15:50 GMT
x-ms-version: 2014-02-14
Authorization: SharedKey myaccount:4KdWDiTdA9HmIF9+WF/8WfYOpUrFhieGIT7f0av+GEI=

Request Body:
{"permission": "O:S-1-5-21-2127521184-1604012920-1887927527-21560751G:S-1-5-21-2127521184-1604012920-1887927527-513D:AI(A;;FA;;;SY)(A;;FA;;;BA)(A;;0x1200a9;;;S-1-5-21-397955417-626881126-188441444-3053964)"}

応答

応答には、HTTP 状態コードと一連の応答ヘッダーが含まれます。

状態コード

操作が成功すると、状態コード 201 (Created) が返されます。

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

応答ヘッダー

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

応答本文

何一つ。

認可

書き込みと削除の承認を持つ共有レベルの Shared Access Signature を持つアカウント所有者または呼び出し元のみが、この操作を呼び出すことができます。

備考

ドメインとドメインに参加していないマシン間で SDDL 形式を移植できるようにするには、呼び出し元は、ConvertSecurityDescriptorToStringSecurityDescriptor Windows 関数を使用して、セキュリティ記述子の基本 SDDL 文字列を取得できます。 呼び出し元は、次の表に示す SDDL 表記を正しい SID 値に置き換えることができます。