共用方式為


File Shares - List

列出所有共用。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default/shares?api-version=2023-05-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default/shares?api-version=2023-05-01&$maxpagesize={$maxpagesize}&$filter={$filter}&$expand={$expand}

URI 參數

名稱 位於 必要 類型 Description
accountName
path True

string

指定資源群組內的記憶體帳戶名稱。 儲存體帳戶名稱長度必須介於 3 到 24 個字元之間,且只能使用數位和小寫字母。

Regex 模式: ^[a-z0-9]+$

resourceGroupName
path True

string

用戶訂用帳戶內的資源組名。 名稱不區分大小寫。

Regex 模式: ^[-\w\._\(\)]+$

subscriptionId
path True

string

目標訂用帳戶的標識碼。

api-version
query True

string

要用於這項作業的 API 版本。

$expand
query

string

選擇性,用來展開共用屬性內的屬性。 有效值為:已刪除、快照集。 應該以具有分隔符 ', 的字串傳遞

$filter
query

string

自選。 指定時,只會列出以篩選開頭的共享名稱。

$maxpagesize
query

string

自選。 指定清單中可包含的共享數目上限。

回應

名稱 類型 Description
200 OK

FileShareItems

確定 -- 列表共用作業已順利完成。

Other Status Codes

CloudError

描述作業失敗原因的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱 Description
user_impersonation 模擬您的用戶帳戶

範例

ListDeletedShares
ListShares
ListShareSnapshots

ListDeletedShares

範例要求

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res9290/providers/Microsoft.Storage/storageAccounts/sto1590/fileServices/default/shares?api-version=2023-05-01&$expand=deleted

範例回覆

{
  "value": [
    {
      "id": "/subscriptions/{subscription-id}/resourceGroups/res9290/providers/Microsoft.Storage/storageAccounts/sto1590/fileServices/default/shares/share1644_1234567890",
      "name": "share1644",
      "type": "Microsoft.Storage/storageAccounts/fileServices/shares",
      "etag": "\"0x8D589847D51C7DE\"",
      "properties": {
        "lastModifiedTime": "2019-05-14T08:20:47Z",
        "shareQuota": 1024,
        "version": "1234567890",
        "deleted": true,
        "deletedTime": "2019-12-14T08:20:47Z",
        "remainingRetentionDays": 30
      }
    },
    {
      "id": "/subscriptions/{subscription-id}/resourceGroups/res9290/providers/Microsoft.Storage/storageAccounts/sto1590/fileServices/default/shares/share4052",
      "name": "share4052",
      "type": "Microsoft.Storage/storageAccounts/fileServices/shares",
      "etag": "\"0x8D589847DAB5AF9\"",
      "properties": {
        "lastModifiedTime": "2019-05-14T08:20:47Z",
        "shareQuota": 1024
      }
    }
  ]
}

ListShares

範例要求

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res9290/providers/Microsoft.Storage/storageAccounts/sto1590/fileServices/default/shares?api-version=2023-05-01

範例回覆

{
  "value": [
    {
      "id": "/subscriptions/{subscription-id}/resourceGroups/res9290/providers/Microsoft.Storage/storageAccounts/sto1590/fileServices/default/shares/share1644",
      "name": "share1644",
      "type": "Microsoft.Storage/storageAccounts/fileServices/shares",
      "etag": "\"0x8D589847D51C7DE\"",
      "properties": {
        "lastModifiedTime": "2019-05-14T08:20:47Z",
        "shareQuota": 1024
      }
    },
    {
      "id": "/subscriptions/{subscription-id}/resourceGroups/res9290/providers/Microsoft.Storage/storageAccounts/sto1590/fileServices/default/shares/share4052",
      "name": "share4052",
      "type": "Microsoft.Storage/storageAccounts/fileServices/shares",
      "etag": "\"0x8D589847DAB5AF9\"",
      "properties": {
        "lastModifiedTime": "2019-05-14T08:20:47Z",
        "shareQuota": 1024
      }
    }
  ],
  "nextLink": "https://sto1590endpoint/subscriptions/{subscription-id}/resourceGroups/res9290/providers/Microsoft.Storage/storageAccounts/sto1590/fileServices/default/shares?api-version=2022-09-01&$maxpagesize=2&$skipToken=/sto1590/share5103"
}

ListShareSnapshots

範例要求

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res9290/providers/Microsoft.Storage/storageAccounts/sto1590/fileServices/default/shares?api-version=2023-05-01&$expand=snapshots

範例回覆

{
  "value": [
    {
      "id": "/subscriptions/{subscription-id}/resourceGroups/res9290/providers/Microsoft.Storage/storageAccounts/sto1590/fileServices/default/shares/share4052",
      "name": "share4052",
      "type": "Microsoft.Storage/storageAccounts/fileServices/shares",
      "etag": "\"0x8D589847DAB5AF9\"",
      "properties": {
        "lastModifiedTime": "2020-10-26T05:47:05.0000000Z",
        "shareQuota": 1024
      }
    },
    {
      "id": "/subscriptions/{subscription-id}/resourceGroups/res9290/providers/Microsoft.Storage/storageAccounts/sto1590/fileServices/default/shares/share4052",
      "name": "share4052",
      "type": "Microsoft.Storage/storageAccounts/fileServices/shares",
      "etag": "\"0x8D589847DAB5AF9\"",
      "properties": {
        "lastModifiedTime": "2020-10-26T05:47:05.0000000Z",
        "shareQuota": 1024,
        "snapshotTime": "2020-10-26T05:48:07.0000000Z"
      }
    }
  ]
}

定義

名稱 Description
AccessPolicy
CloudError

記憶體服務的錯誤回應。

CloudErrorBody

記憶體服務的錯誤回應。

EnabledProtocols

用於檔案共用的驗證通訊協定。 只能在建立共用時指定。

FileShareItem

列出檔案共享屬性。

FileShareItems

回應架構。 包含傳回的共享清單,如果要求或需要分頁,則為下一頁共用的URL。

LeaseDuration

指定共用上的租用是否為無限或固定的持續時間,只有在共用租用時。

LeaseState

共用的租用狀態。

LeaseStatus

共用的租用狀態。

RootSquashType

屬性僅適用於 NFS 共用。 預設值為 NoRootSquash。

ShareAccessTier

特定共用的存取層。 GpV2 帳戶可以選擇 TransactionOptimized (預設)、經常性存取和非經常性存取。 FileStorage 帳戶可以選擇 [進階]。

SignedIdentifier

AccessPolicy

名稱 類型 Description
expiryTime

string

存取原則的到期時間

permission

string

縮寫許可權的清單。

startTime

string

存取原則的開始時間

CloudError

記憶體服務的錯誤回應。

名稱 類型 Description
error

CloudErrorBody

記憶體服務的錯誤回應。

CloudErrorBody

記憶體服務的錯誤回應。

名稱 類型 Description
code

string

錯誤的識別碼。 程序代碼是不變的,而且是要以程序設計方式取用。

details

CloudErrorBody[]

錯誤的其他詳細數據清單。

message

string

描述錯誤的訊息,適用於在使用者介面中顯示。

target

string

特定錯誤的目標。 例如,錯誤中的屬性名稱。

EnabledProtocols

用於檔案共用的驗證通訊協定。 只能在建立共用時指定。

名稱 類型 Description
NFS

string

SMB

string

FileShareItem

列出檔案共享屬性。

名稱 類型 Description
etag

string

資源 Etag。

id

string

資源的完整資源標識碼。 例如 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

資源的名稱

properties.accessTier

ShareAccessTier

特定共用的存取層。 GpV2 帳戶可以選擇 TransactionOptimized (預設)、經常性存取和非經常性存取。 FileStorage 帳戶可以選擇 [進階]。

properties.accessTierChangeTime

string

表示共用存取層的最後一次修改時間。

properties.accessTierStatus

string

指出存取層是否有暫止轉換。

properties.deleted

boolean

指出是否已刪除共用。

properties.deletedTime

string

已刪除共享的時間。

properties.enabledProtocols

EnabledProtocols

用於檔案共用的驗證通訊協定。 只能在建立共用時指定。

properties.lastModifiedTime

string

傳回上次修改共用的日期和時間。

properties.leaseDuration

LeaseDuration

指定共用上的租用是否為無限或固定的持續時間,只有在共用租用時。

properties.leaseState

LeaseState

共用的租用狀態。

properties.leaseStatus

LeaseStatus

共用的租用狀態。

properties.metadata

object

要與共用建立關聯的名稱/值組做為元數據。

properties.remainingRetentionDays

integer

虛刪除共享的剩餘保留天數。

properties.rootSquash

RootSquashType

屬性僅適用於 NFS 共用。 預設值為 NoRootSquash。

properties.shareQuota

integer

共用的大小上限,以 GB 為單位。 必須大於 0,且小於或等於 5TB (5120)。 對於大型檔案共用,大小上限為 102400。

properties.shareUsageBytes

integer

儲存在共用上的大約數據大小。 請注意,此值可能不會包含最近建立或最近重設大小的檔案。

properties.signedIdentifiers

SignedIdentifier[]

共用上指定的預存存取原則清單。

properties.snapshotTime

string

使用展開參數「快照集」,在清單共用響應中傳回的共用快照集建立時間。

properties.version

string

共用的版本。

type

string

資源的型別。 例如“Microsoft.Compute/virtualMachines” 或 “Microsoft.Storage/storageAccounts”

FileShareItems

回應架構。 包含傳回的共享清單,如果要求或需要分頁,則為下一頁共用的URL。

名稱 類型 Description
nextLink

string

可用來查詢下一頁共用的要求URL。 當要求的共享總數超過頁面大小上限時傳回。

value

FileShareItem[]

傳回的檔案共享清單。

LeaseDuration

指定共用上的租用是否為無限或固定的持續時間,只有在共用租用時。

名稱 類型 Description
Fixed

string

Infinite

string

LeaseState

共用的租用狀態。

名稱 類型 Description
Available

string

Breaking

string

Broken

string

Expired

string

Leased

string

LeaseStatus

共用的租用狀態。

名稱 類型 Description
Locked

string

Unlocked

string

RootSquashType

屬性僅適用於 NFS 共用。 預設值為 NoRootSquash。

名稱 類型 Description
AllSquash

string

NoRootSquash

string

RootSquash

string

ShareAccessTier

特定共用的存取層。 GpV2 帳戶可以選擇 TransactionOptimized (預設)、經常性存取和非經常性存取。 FileStorage 帳戶可以選擇 [進階]。

名稱 類型 Description
Cool

string

Hot

string

Premium

string

TransactionOptimized

string

SignedIdentifier

名稱 類型 Description
accessPolicy

AccessPolicy

存取原則

id

string

預存存取原則的唯一標識符。