File Shares - Get
Získá vlastnosti zadané sdílené složky.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default/shares/{shareName}?api-version=2023-01-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default/shares/{shareName}?api-version=2023-01-01&$expand={$expand}
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
account
|
path | True |
string |
Název účtu úložiště v rámci zadané skupiny prostředků. Názvy účtů úložiště musí mít délku 3 až 24 znaků a musí používat jenom číslice a malá písmena. Regex pattern: |
resource
|
path | True |
string |
Název skupiny prostředků v rámci předplatného uživatele. V názvu se rozlišují malá a velká písmena. Regex pattern: |
share
|
path | True |
string |
Název sdílené složky v rámci zadaného účtu úložiště. Názvy sdílených složek musí mít délku 3 až 63 znaků a musí obsahovat pouze číslice, malá písmena a pomlčky (-). Každá pomlčka (-) musí bezprostředně předcházet písmenu nebo číslici. |
subscription
|
path | True |
string |
ID cílového předplatného. |
api-version
|
query | True |
string |
Verze rozhraní API, která se má použít pro tuto operaci. |
$expand
|
query |
string |
Volitelné, slouží k rozbalení vlastností ve vlastnostech sdílené složky. Platné hodnoty jsou: statistiky. Měl by být předán jako řetězec s oddělovačem ','. |
Hlavička požadavku
Name | Vyžadováno | Typ | Description |
---|---|---|---|
x-ms-snapshot |
string |
Volitelné– slouží k načtení vlastností snímku. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
OK – Operace získání sdílení se úspěšně dokončila. |
|
Other Status Codes |
Chybová odpověď popisující, proč operace selhala. |
Zabezpečení
azure_auth
Tok Azure Active Directory OAuth2
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | zosobnění uživatelského účtu |
Příklady
Get |
Get |
GetShares
Sample Request
GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res9871/providers/Microsoft.Storage/storageAccounts/sto6217/fileServices/default/shares/share1634?api-version=2023-01-01
Sample Response
{
"id": "/subscriptions/{subscription-id}/resourceGroups/res9871/providers/Microsoft.Storage/storageAccounts/sto6217/fileServices/default/shares/share1634",
"name": "share1634",
"type": "Microsoft.Storage/storageAccounts/fileServices/shares",
"etag": "\"0x8D592D74CC20EBA\"",
"properties": {
"lastModifiedTime": "2019-05-26T05:06:14Z",
"shareQuota": 1024
}
}
GetShareStats
Sample Request
GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res9871/providers/Microsoft.Storage/storageAccounts/sto6217/fileServices/default/shares/share1634?api-version=2023-01-01&$expand=stats
Sample Response
{
"id": "/subscriptions/{subscription-id}/resourceGroups/res9871/providers/Microsoft.Storage/storageAccounts/sto6217/fileServices/default/shares/share1634",
"name": "share1634",
"type": "Microsoft.Storage/storageAccounts/fileServices/shares",
"etag": "\"0x8D592D74CC20EBA\"",
"properties": {
"lastModifiedTime": "2019-05-26T05:06:14Z",
"shareQuota": 1024,
"shareUsageBytes": 652945
}
}
Definice
Name | Description |
---|---|
Access |
|
Cloud |
Chybová odpověď ze služby Storage. |
Cloud |
Chybová odpověď ze služby Storage. |
Enabled |
Ověřovací protokol, který se používá pro sdílenou složku. Lze zadat pouze při vytváření sdílené složky. |
File |
Vlastnosti sdílené složky, včetně ID, názvu prostředku, typu prostředku, značky Etag. |
Lease |
Určuje, jestli má zapůjčení sdílené složky neomezenou nebo pevnou dobu trvání, jenom když je sdílená složka zapůjčená. |
Lease |
Stav zapůjčení sdílené složky |
Lease |
Stav zapůjčení sdílené složky |
Root |
Vlastnost je určená jenom pro sdílenou složku NFS. Výchozí hodnota je NoRootSquash. |
Share |
Úroveň přístupu pro konkrétní sdílenou složku. Účet GpV2 si může vybrat mezi TransactionOptimized (výchozí), Horkou a Studenou. Účet FileStorage může zvolit Premium. |
Signed |
AccessPolicy
Name | Typ | Description |
---|---|---|
expiryTime |
string |
Čas vypršení platnosti zásad přístupu |
permission |
string |
Seznam zkrácených oprávnění |
startTime |
string |
Počáteční čas zásad přístupu |
CloudError
Chybová odpověď ze služby Storage.
Name | Typ | Description |
---|---|---|
error |
Chybová odpověď ze služby Storage. |
CloudErrorBody
Chybová odpověď ze služby Storage.
Name | Typ | Description |
---|---|---|
code |
string |
Identifikátor chyby. Kódy jsou neutrální a mají být využívány programově. |
details |
Seznam dalších podrobností o chybě |
|
message |
string |
Zpráva popisující chybu, která má být vhodná k zobrazení v uživatelském rozhraní. |
target |
string |
Cíl konkrétní chyby. Například název vlastnosti v chybě. |
EnabledProtocols
Ověřovací protokol, který se používá pro sdílenou složku. Lze zadat pouze při vytváření sdílené složky.
Name | Typ | Description |
---|---|---|
NFS |
string |
|
SMB |
string |
FileShare
Vlastnosti sdílené složky, včetně ID, názvu prostředku, typu prostředku, značky Etag.
Name | Typ | Description |
---|---|---|
etag |
string |
Značka ETag prostředku. |
id |
string |
Plně kvalifikované ID prostředku Příklad : /subscriptions/{id_předplatného}/resourceGroups/{název_skupiny_prostředků}/providers/{resourceProviderNamespace}/{typ_prostředku}/{název_prostředku} |
name |
string |
Název prostředku |
properties.accessTier |
Úroveň přístupu pro konkrétní sdílenou složku. Účet GpV2 si může vybrat mezi TransactionOptimized (výchozí), Horkou a Studenou. Účet FileStorage může zvolit Premium. |
|
properties.accessTierChangeTime |
string |
Označuje čas poslední změny úrovně přístupu sdílené složky. |
properties.accessTierStatus |
string |
Označuje, jestli čeká na přechod na úroveň přístupu. |
properties.deleted |
boolean |
Určuje, jestli byla sdílená složka odstraněna. |
properties.deletedTime |
string |
Čas odstranění sdílené složky. |
properties.enabledProtocols |
Ověřovací protokol, který se používá pro sdílenou složku. Lze zadat pouze při vytváření sdílené složky. |
|
properties.lastModifiedTime |
string |
Vrátí datum a čas poslední změny sdílené složky. |
properties.leaseDuration |
Určuje, jestli má zapůjčení sdílené složky neomezenou nebo pevnou dobu trvání, jenom když je sdílená složka zapůjčená. |
|
properties.leaseState |
Stav zapůjčení sdílené složky |
|
properties.leaseStatus |
Stav zapůjčení sdílené složky |
|
properties.metadata |
object |
Pár název-hodnota, který se přidruží ke sdílené složce jako metadata. |
properties.remainingRetentionDays |
integer |
Zbývající dny uchovávání pro sdílenou složku, která byla odstraněna obnovitelně. |
properties.rootSquash |
Vlastnost je určená jenom pro sdílenou složku NFS. Výchozí hodnota je NoRootSquash. |
|
properties.shareQuota |
integer |
Maximální velikost sdílené složky v gigabajtech Musí být větší než 0 a menší nebo roven 5 TB (5120). Maximální velikost velkých sdílených složek je 102400. |
properties.shareUsageBytes |
integer |
Přibližná velikost dat uložených ve sdílené složce Všimněte si, že tato hodnota nemusí zahrnovat všechny nedávno vytvořené soubory nebo soubory s nedávno změněnou velikostí. |
properties.signedIdentifiers |
Seznam uložených zásad přístupu zadaných ve sdílené složce |
|
properties.snapshotTime |
string |
Čas vytvoření snímku sdílené složky vrácený v odpovědi sdílených složek seznamu s rozbalením parametru "snímky". |
properties.version |
string |
Verze sdílené složky. |
type |
string |
Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts |
LeaseDuration
Určuje, jestli má zapůjčení sdílené složky neomezenou nebo pevnou dobu trvání, jenom když je sdílená složka zapůjčená.
Name | Typ | Description |
---|---|---|
Fixed |
string |
|
Infinite |
string |
LeaseState
Stav zapůjčení sdílené složky
Name | Typ | Description |
---|---|---|
Available |
string |
|
Breaking |
string |
|
Broken |
string |
|
Expired |
string |
|
Leased |
string |
LeaseStatus
Stav zapůjčení sdílené složky
Name | Typ | Description |
---|---|---|
Locked |
string |
|
Unlocked |
string |
RootSquashType
Vlastnost je určená jenom pro sdílenou složku NFS. Výchozí hodnota je NoRootSquash.
Name | Typ | Description |
---|---|---|
AllSquash |
string |
|
NoRootSquash |
string |
|
RootSquash |
string |
ShareAccessTier
Úroveň přístupu pro konkrétní sdílenou složku. Účet GpV2 si může vybrat mezi TransactionOptimized (výchozí), Horkou a Studenou. Účet FileStorage může zvolit Premium.
Name | Typ | Description |
---|---|---|
Cool |
string |
|
Hot |
string |
|
Premium |
string |
|
TransactionOptimized |
string |
SignedIdentifier
Name | Typ | Description |
---|---|---|
accessPolicy |
Zásady přístupu |
|
id |
string |
Jedinečný identifikátor uložených zásad přístupu. |