Share via


File Shares - Create

Létrehoz egy új megosztást a megadott fiók alatt a kérelemtörzsben leírtak szerint. A megosztási erőforrás az adott megosztás metaadatait és tulajdonságait tartalmazza. Nem tartalmazza a megosztás által tartalmazott fájlok listáját.

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

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\._\(\)]+$

shareName
path True

string

A fájlmegosztás neve a megadott tárfiókban. A fájlmegosztások nevének 3 és 63 karakter közötti hosszúságúnak kell lennie, és csak számokat, kisbetűket és kötőjeleket (-) kell használnia. Minden kötőjelet (-) közvetlenül meg kell előzni, és betűvel vagy számmal kell követni.

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: pillanatképek. Sztringként kell átadni," elválasztójellel

Kérelem törzse

Name Típus Description
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.enabledProtocols

EnabledProtocols

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

properties.metadata

object

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

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.signedIdentifiers

SignedIdentifier[]

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

Válaszok

Name Típus Description
200 OK

FileShare

OK – A megosztás már létrejött.

201 Created

FileShare

Létrehozás – A Megosztás létrehozása 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

Create NFS Shares
PutShares
PutShares with Access Tier

Create NFS Shares

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res346/providers/Microsoft.Storage/storageAccounts/sto666/fileServices/default/shares/share1235?api-version=2023-01-01

{
  "properties": {
    "enabledProtocols": "NFS"
  }
}

Sample Response

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res346/providers/Microsoft.Storage/storageAccounts/sto666/fileServices/default/shares/share1235",
  "name": "share1235",
  "type": "Microsoft.Storage/storageAccounts/fileServices/shares",
  "properties": {
    "enabledProtocols": "NFS"
  }
}
{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res346/providers/Microsoft.Storage/storageAccounts/sto666/fileServices/default/shares/share1235",
  "name": "share1235",
  "type": "Microsoft.Storage/storageAccounts/fileServices/shares",
  "properties": {
    "enabledProtocols": "NFS"
  }
}

PutShares

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/fileServices/default/shares/share6185?api-version=2023-01-01

{}

Sample Response

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/fileServices/default/shares/share6185",
  "name": "share6185",
  "type": "Microsoft.Storage/storageAccounts/fileServices/shares"
}
{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/fileServices/default/shares/share6185",
  "name": "share6185",
  "type": "Microsoft.Storage/storageAccounts/fileServices/shares"
}

PutShares with Access Tier

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res346/providers/Microsoft.Storage/storageAccounts/sto666/fileServices/default/shares/share1235?api-version=2023-01-01

{
  "properties": {
    "accessTier": "Hot"
  }
}

Sample Response

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res346/providers/Microsoft.Storage/storageAccounts/sto666/fileServices/default/shares/share1235",
  "name": "share1235",
  "type": "Microsoft.Storage/storageAccounts/fileServices/shares",
  "properties": {
    "accessTier": "Hot"
  }
}
{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res346/providers/Microsoft.Storage/storageAccounts/sto666/fileServices/default/shares/share1235",
  "name": "share1235",
  "type": "Microsoft.Storage/storageAccounts/fileServices/shares",
  "properties": {
    "accessTier": "Hot"
  }
}

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.

FileShare

A fájlmegosztás tulajdonságai, beleértve az azonosítót, az erőforrásnevet, az erőforrástípust és az Etaget.

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

FileShare

A fájlmegosztás tulajdonságai, beleértve az azonosítót, az erőforrásnevet, az erőforrástípust és az Etaget.

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"

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.