File Shares - Get
Ruft Eigenschaften einer angegebenen Freigabe ab.
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}
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
account
|
path | True |
string |
Der Name des Speicherkontos innerhalb der angegebenen Ressourcengruppe. Speicherkontonamen müssen zwischen 3 und 24 Zeichen lang sein und dürfen nur Zahlen und Kleinbuchstaben enthalten. Regex pattern: |
resource
|
path | True |
string |
Der Name der Ressourcengruppe im Abonnement des Benutzers. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet. Regex pattern: |
share
|
path | True |
string |
Der Name der Dateifreigabe innerhalb des angegebenen Speicherkontos. Dateinamen müssen zwischen 3 und 63 Zeichen lang sein und nur Zahlen, Kleinbuchstaben und Bindestriche (-) verwenden. Direkt vor und nach jedem Bindestrich (-) muss ein Buchstabe oder eine Ziffer stehen. |
subscription
|
path | True |
string |
Hierbei handelt es sich um die ID des Zielabonnements. |
api-version
|
query | True |
string |
Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version. |
$expand
|
query |
string |
Optional, wird verwendet, um die Eigenschaften innerhalb der Eigenschaften der Freigabe zu erweitern. Gültige Werte sind: Stats. Sollte als Zeichenfolge mit Trennzeichen "," übergeben werden. |
Anforderungsheader
Name | Erforderlich | Typ | Beschreibung |
---|---|---|---|
x-ms-snapshot |
string |
Optional, wird zum Abrufen von Eigenschaften einer Momentaufnahme verwendet. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
OK : Der Freigabevorgang wurde erfolgreich abgeschlossen. |
|
Other Status Codes |
Fehlerantwort mit Beschreibung des Grunds für den Fehler. |
Sicherheit
azure_auth
Azure Active Directory-OAuth2-Flow
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Beschreibung |
---|---|
user_impersonation | Identitätswechsel Ihres Benutzerkontos |
Beispiele
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
}
}
Definitionen
Name | Beschreibung |
---|---|
Access |
|
Cloud |
Eine Fehlerantwort des Speicherdiensts. |
Cloud |
Eine Fehlerantwort des Speicherdiensts. |
Enabled |
Das Authentifizierungsprotokoll, das für die Dateifreigabe verwendet wird. Kann nur beim Erstellen einer Freigabe angegeben werden. |
File |
Eigenschaften der Dateifreigabe, einschließlich ID, Ressourcenname, Ressourcentyp, Etag. |
Lease |
Gibt an, ob die Lease für eine Freigabe von unendlicher oder fester Dauer ist, nur wenn die Freigabe geleast wird. |
Lease |
Leasestatus der Aktie. |
Lease |
Die Lease-status der Aktie. |
Root |
Die Eigenschaft gilt nur für die NFS-Freigabe. Der Standardwert ist NoRootSquash. |
Share |
Zugriffsebene für eine bestimmte Freigabe. GpV2-Konto kann zwischen TransactionOptimized (Standard), Hot und Cool wählen. Das FileStorage-Konto kann Premium auswählen. |
Signed |
AccessPolicy
Name | Typ | Beschreibung |
---|---|---|
expiryTime |
string |
Ablaufzeit der Zugriffsrichtlinie |
permission |
string |
Liste der abgekürzten Berechtigungen. |
startTime |
string |
Startzeit der Zugriffsrichtlinie |
CloudError
Eine Fehlerantwort des Speicherdiensts.
Name | Typ | Beschreibung |
---|---|---|
error |
Eine Fehlerantwort des Speicherdiensts. |
CloudErrorBody
Eine Fehlerantwort des Speicherdiensts.
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollten programmgesteuert verwendet werden. |
details |
Eine Liste mit zusätzlichen Details zum Fehler. |
|
message |
string |
Eine Meldung, die den Fehler beschreibt, der für die Anzeige in einer Benutzeroberfläche geeignet sein soll. |
target |
string |
Das Ziel des jeweiligen Fehlers. Beispiel: Der Name der -Eigenschaft im Fehler. |
EnabledProtocols
Das Authentifizierungsprotokoll, das für die Dateifreigabe verwendet wird. Kann nur beim Erstellen einer Freigabe angegeben werden.
Name | Typ | Beschreibung |
---|---|---|
NFS |
string |
|
SMB |
string |
FileShare
Eigenschaften der Dateifreigabe, einschließlich ID, Ressourcenname, Ressourcentyp, Etag.
Name | Typ | Beschreibung |
---|---|---|
etag |
string |
Ressourcen-Etag. |
id |
string |
Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Der Name der Ressource |
properties.accessTier |
Zugriffsebene für eine bestimmte Freigabe. GpV2-Konto kann zwischen TransactionOptimized (Standard), Hot und Cool wählen. Das FileStorage-Konto kann Premium auswählen. |
|
properties.accessTierChangeTime |
string |
Gibt den Zeitpunkt der letzten Änderung für die Freigabezugriffsebene an. |
properties.accessTierStatus |
string |
Gibt an, ob ein Übergang für die Zugriffsebene aussteht. |
properties.deleted |
boolean |
Gibt an, ob die Freigabe gelöscht wurde. |
properties.deletedTime |
string |
Der gelöschte Zeitpunkt, wenn die Freigabe gelöscht wurde. |
properties.enabledProtocols |
Das Authentifizierungsprotokoll, das für die Dateifreigabe verwendet wird. Kann nur beim Erstellen einer Freigabe angegeben werden. |
|
properties.lastModifiedTime |
string |
Gibt das Datum und die Uhrzeit der letzten Änderung der Freigabe zurück. |
properties.leaseDuration |
Gibt an, ob die Lease für eine Freigabe von unendlicher oder fester Dauer ist, nur wenn die Freigabe geleast wird. |
|
properties.leaseState |
Leasestatus der Aktie. |
|
properties.leaseStatus |
Die Lease-status der Aktie. |
|
properties.metadata |
object |
Ein Name-Wert-Paar, das der Freigabe als Metadaten zugeordnet wird. |
properties.remainingRetentionDays |
integer |
Verbleibende Aufbewahrungstage für freigaben, die vorläufig gelöscht wurden. |
properties.rootSquash |
Die Eigenschaft gilt nur für die NFS-Freigabe. Der Standardwert ist NoRootSquash. |
|
properties.shareQuota |
integer |
Die maximale Größe der Freigabe in Gigabyte. Muss größer als 0 und kleiner gleich 5 TB (5120) sein. Für große Dateifreigaben beträgt die maximale Größe 102400. |
properties.shareUsageBytes |
integer |
Die ungefähre Größe der in der Freigabe gespeicherten Daten. Beachten Sie, dass dieser Wert möglicherweise nicht alle kürzlich erstellten oder kürzlich geänderten Dateien enthält. |
properties.signedIdentifiers |
Liste der gespeicherten Zugriffsrichtlinien, die in der Freigabe angegeben sind. |
|
properties.snapshotTime |
string |
Die Erstellungszeit der Freigabe Momentaufnahme in der Antwort von Listenfreigaben mit dem Erweiterungsparam "Momentaufnahmen" zurückgegeben. |
properties.version |
string |
Die Version der Freigabe. |
type |
string |
Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts" |
LeaseDuration
Gibt an, ob die Lease für eine Freigabe von unendlicher oder fester Dauer ist, nur wenn die Freigabe geleast wird.
Name | Typ | Beschreibung |
---|---|---|
Fixed |
string |
|
Infinite |
string |
LeaseState
Leasestatus der Aktie.
Name | Typ | Beschreibung |
---|---|---|
Available |
string |
|
Breaking |
string |
|
Broken |
string |
|
Expired |
string |
|
Leased |
string |
LeaseStatus
Die Lease-status der Aktie.
Name | Typ | Beschreibung |
---|---|---|
Locked |
string |
|
Unlocked |
string |
RootSquashType
Die Eigenschaft gilt nur für die NFS-Freigabe. Der Standardwert ist NoRootSquash.
Name | Typ | Beschreibung |
---|---|---|
AllSquash |
string |
|
NoRootSquash |
string |
|
RootSquash |
string |
ShareAccessTier
Zugriffsebene für eine bestimmte Freigabe. GpV2-Konto kann zwischen TransactionOptimized (Standard), Hot und Cool wählen. Das FileStorage-Konto kann Premium auswählen.
Name | Typ | Beschreibung |
---|---|---|
Cool |
string |
|
Hot |
string |
|
Premium |
string |
|
TransactionOptimized |
string |
SignedIdentifier
Name | Typ | Beschreibung |
---|---|---|
accessPolicy |
Zugriffsrichtlinie |
|
id |
string |
Ein eindeutiger Bezeichner der gespeicherten Zugriffsrichtlinie. |