Megosztás a következőn keresztül:


File Shares - List

Listák az összes megosztást.

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

URI-paraméterek

Name In Kötelező Típus Description
accountName
path True

string

A tárfiók neve a megadott erőforráscsoporton belül. A tárfiókneveknek 3 és 24 karakter közötti hosszúságúnak kell lenniük, és csak számokat és kisbetűket kell használniuk.

Regex pattern: ^[a-z0-9]+$

resourceGroupName
path True

string

A felhasználó előfizetésében található erőforráscsoport neve. A név megkülönbözteti a kis- és nagybetűket.

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

subscriptionId
path True

string

A cél-előfizetés azonosítója.

api-version
query True

string

A művelethez használandó API-verzió.

$expand
query

string

Nem kötelező, a megosztás tulajdonságainak kibontásához használható. Az érvényes értékek a következők: törölve, pillanatképek. Sztringként kell átadni," elválasztójellel

$filter
query

string

Választható. Ha meg van adva, csak a szűrővel kezdődő megosztásnevek lesznek felsorolva.

$maxpagesize
query

string

Választható. Megadott maximális számú megosztás, amely szerepelhet a listában.

Válaszok

Name Típus Description
200 OK

FileShareItems

OK – A Listamegosztások művelet sikeresen befejeződött.

Other Status Codes

CloudError

Hibaválasz, amely leírja, hogy a művelet miért hiúsult meg.

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation felhasználói fiók megszemélyesítése

Példák

ListDeletedShares
ListShares
ListShareSnapshots

ListDeletedShares

Sample Request

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

Sample Response

{
  "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

Sample Request

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

Sample Response

{
  "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

Sample Request

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

Sample Response

{
  "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"
      }
    }
  ]
}

Definíciók

Name Description
AccessPolicy
CloudError

Hibaválasz a Storage szolgáltatástól.

CloudErrorBody

Hibaválasz a Storage szolgáltatástól.

EnabledProtocols

A fájlmegosztáshoz használt hitelesítési protokoll. Csak megosztás létrehozásakor adható meg.

FileShareItem

A fájlmegosztás tulajdonságai ki vannak sorolva.

FileShareItems

Válaszséma. A visszaadott megosztások listáját tartalmazza, és ha lapozást kérnek vagy igényelnek, a megosztások következő oldalának URL-címe.

LeaseDuration

Azt határozza meg, hogy a megosztás bérlete végtelen vagy rögzített időtartamú-e, csak akkor, ha a megosztást lízingelik.

LeaseState

A megosztás bérletállapota.

LeaseStatus

A megosztás bérletállapota.

RootSquashType

A tulajdonság csak NFS-megosztásra vonatkozik. Az alapértelmezett érték a NoRootSquash.

ShareAccessTier

Adott megosztás hozzáférési szintje. A GpV2-fiók választhat a TransactionOptimized (alapértelmezett), a Gyakori és a Ritka elérésű lehetőségek közül. A FileStorage-fiók választhatja a Premium lehetőséget.

SignedIdentifier

AccessPolicy

Name Típus Description
expiryTime

string

A hozzáférési szabályzat lejárati ideje

permission

string

A rövidített engedélyek listája.

startTime

string

A hozzáférési szabályzat kezdési időpontja

CloudError

Hibaválasz a Storage szolgáltatástól.

Name Típus Description
error

CloudErrorBody

Hibaválasz a Storage szolgáltatástól.

CloudErrorBody

Hibaválasz a Storage szolgáltatástól.

Name Típus Description
code

string

A hiba azonosítója. A kódok invariánsak, és programozott módon használhatók.

details

CloudErrorBody[]

A hibával kapcsolatos további részletek listája.

message

string

A hibát leíró üzenet, amely alkalmas a felhasználói felületen való megjelenítésre.

target

string

Az adott hiba célja. Például a hibás tulajdonság neve.

EnabledProtocols

A fájlmegosztáshoz használt hitelesítési protokoll. Csak megosztás létrehozásakor adható meg.

Name Típus Description
NFS

string

SMB

string

FileShareItem

A fájlmegosztás tulajdonságai ki vannak sorolva.

Name Típus Description
etag

string

Erőforrás-etag.

id

string

Az erőforrás teljes erőforrás-azonosítója. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

Az erőforrás neve

properties.accessTier

ShareAccessTier

Adott megosztás hozzáférési szintje. A GpV2-fiók választhat a TransactionOptimized (alapértelmezett), a Gyakori és a Ritka elérésű lehetőségek közül. A FileStorage-fiók választhatja a Premium lehetőséget.

properties.accessTierChangeTime

string

A megosztási hozzáférési szint utolsó módosítási idejét jelzi.

properties.accessTierStatus

string

Azt jelzi, hogy van-e függőben lévő áttűnés a hozzáférési szinthez.

properties.deleted

boolean

Azt jelzi, hogy a megosztás törölve lett-e.

properties.deletedTime

string

A megosztás törlésének időpontja.

properties.enabledProtocols

EnabledProtocols

A fájlmegosztáshoz használt hitelesítési protokoll. Csak megosztás létrehozásakor adható meg.

properties.lastModifiedTime

string

A megosztás utolsó módosításának dátumát és időpontját adja vissza.

properties.leaseDuration

LeaseDuration

Azt határozza meg, hogy a megosztás bérlete végtelen vagy rögzített időtartamú-e, csak akkor, ha a megosztást lízingelik.

properties.leaseState

LeaseState

A megosztás bérletállapota.

properties.leaseStatus

LeaseStatus

A megosztás bérletállapota.

properties.metadata

object

Egy név-érték pár, amely metaadatként társítja a megosztást.

properties.remainingRetentionDays

integer

A helyreállíthatóan törölt megosztás hátralévő megőrzési napjai.

properties.rootSquash

RootSquashType

A tulajdonság csak NFS-megosztásra vonatkozik. Az alapértelmezett érték a NoRootSquash.

properties.shareQuota

integer

A megosztás maximális mérete gigabájtban. 0-nál nagyobbnak és 5 TB-nál kisebbnek (5120) kell lennie. Nagyméretű fájlmegosztások esetén a maximális méret 102400.

properties.shareUsageBytes

integer

A megosztáson tárolt adatok hozzávetőleges mérete. Vegye figyelembe, hogy ez az érték nem feltétlenül tartalmazza az összes nemrég létrehozott vagy nemrég átméretezett fájlt.

properties.signedIdentifiers

SignedIdentifier[]

A megosztáson megadott tárolt hozzáférési szabályzatok listája.

properties.snapshotTime

string

A megosztás pillanatképének létrehozási ideje a listamegosztások válaszában a "pillanatképek" kibontásával.

properties.version

string

A megosztás verziója.

type

string

Az erőforrás típusa. Például "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts"

FileShareItems

Válaszséma. A visszaadott megosztások listáját tartalmazza, és ha lapozást kérnek vagy igényelnek, a megosztások következő oldalának URL-címe.

Name Típus Description
nextLink

string

Kérelem URL-címe, amely a megosztások következő oldalának lekérdezéséhez használható. Akkor adja vissza, ha a kért megosztások teljes száma meghaladja a maximális oldalméretet.

value

FileShareItem[]

A visszaadott fájlmegosztások listája.

LeaseDuration

Azt határozza meg, hogy a megosztás bérlete végtelen vagy rögzített időtartamú-e, csak akkor, ha a megosztást lízingelik.

Name Típus Description
Fixed

string

Infinite

string

LeaseState

A megosztás bérletállapota.

Name Típus Description
Available

string

Breaking

string

Broken

string

Expired

string

Leased

string

LeaseStatus

A megosztás bérletállapota.

Name Típus Description
Locked

string

Unlocked

string

RootSquashType

A tulajdonság csak NFS-megosztásra vonatkozik. Az alapértelmezett érték a NoRootSquash.

Name Típus Description
AllSquash

string

NoRootSquash

string

RootSquash

string

ShareAccessTier

Adott megosztás hozzáférési szintje. A GpV2-fiók választhat a TransactionOptimized (alapértelmezett), a Gyakori és a Ritka elérésű lehetőségek közül. A FileStorage-fiók választhatja a Premium lehetőséget.

Name Típus Description
Cool

string

Hot

string

Premium

string

TransactionOptimized

string

SignedIdentifier

Name Típus Description
accessPolicy

AccessPolicy

Hozzáférési szabályzat

id

string

A tárolt hozzáférési szabályzat egyedi azonosítója.