共有 ACL の取得 (FileREST API) - Azure Files

[アーティクル]
07/19/2023

操作は Get Share ACL 、共有で指定された格納されているアクセスポリシーに関する情報を返します。詳細については、「保存されているアクセスポリシーの定義」を参照してください。

プロトコルの可用性

有効なファイル共有プロトコル	利用可能
SMB
NFS

要求

Get Share ACL 要求の構成は次のとおりです。 HTTPS を使用することをお勧めします。 myaccount をストレージアカウントの名前に置き換えます。

Method	要求 URI	HTTP バージョン
GET/HEAD	`https://myaccount.file.core.windows.net/myshare?restype=share&comp=acl`	HTTP/1.1

URI パラメーター

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

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

要求ヘッダー

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

要求ヘッダー	説明
`Authorization`	必須。承認スキーム、アカウント名、署名を指定します。詳細については、「Azure Storage への要求を承認する」をご覧ください。
`Date or x-ms-date`	すべての承認された要求に必要です。この要求に使用する操作のバージョンを指定します。この操作は、バージョン 2015-02-21 以降でのみ使用できます。詳細については、「Azure Storage サービスのバージョン管理」を参照してください。
`x-ms-version`	すべての承認された要求に必要です。この要求に使用する操作のバージョンを指定します。詳細については、「Azure Storage サービスのバージョン管理」を参照してください。
`x-ms-client-request-id`	省略可能。ログ記録の構成時にログに記録される 1 kibibyte (KiB) 文字制限を使用して、クライアントによって生成された不透明な値を提供します。このヘッダーを使用して、クライアント側のアクティビティとサーバーが受信する要求を関連付けるよう強くお勧めします。詳細については、「Azure Filesの監視」を参照してください。
`x-ms-lease-id:<ID>`	省略可能。バージョン 2020-02-10 以降。ヘッダーが指定されている場合、操作は、ファイル共有のリースが現在アクティブであり、要求で指定されたリース ID がファイル共有のリース ID と一致する場合にのみ実行されます。一致しない場合、操作は状態コード 412 (前提条件失敗) で失敗します。

要求本文

なし。

[応答]

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

状態コード

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

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

応答ヘッダー

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

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

応答本文

共有に対して共有レベルのアクセスポリシーが指定されている場合は、 Get Share ACL 応答本文で署名された識別子とアクセスポリシーを返します。

<?xml version="1.0" encoding="utf-8"?>  
<SignedIdentifiers>  
  <SignedIdentifier>  
    <Id>unique-value</Id>  
    <AccessPolicy>  
      <Start>start-time</Start>  
      <Expiry>expiry-time</Expiry>  
      <Permission>abbreviated-permission-list</Permission>  
    </AccessPolicy>  
  </SignedIdentifier>  
</SignedIdentifiers>

応答のサンプル

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
Transfer-Encoding: chunked  
Date: <date>  
ETag: "0x8CAFB82EFF70C46"  
Last-Modified: <date>  
x-ms-version: 2015-02-21  
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0  
  
<?xml version="1.0" encoding="utf-8"?>  
<SignedIdentifiers>  
  <SignedIdentifier>   
    <Id>MTIzNDU2Nzg5MDEyMzQ1Njc4OTAxMjM0NTY3ODkwMTI=</Id>  
    <AccessPolicy>  
      <Start>2015-07-01T08:49:37.0000000Z</Start>  
      <Expiry>2015-07-02T08:49:37.0000000Z</Expiry>  
      <Permission>rwd</Permission>  
    </AccessPolicy>  
  </SignedIdentifier>  
</SignedIdentifiers>

承認

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

注釈

共有のアクセスポリシーは、そのすべての共有スナップショットにも適用されます。共有スナップショットに対してアクセスポリシーを設定または取得することはできません。アクセスポリシーを取得しようとすると、サービスは状態コード 400 (無効なクエリパラメーター値) を返します。

Get Share ACL