File Shares - Update
Updates eigenschaften freigeben, wie im Anforderungstext angegeben. Eigenschaften, die in der Anforderung nicht erwähnt werden, werden nicht geändert. Das Update schlägt fehl, wenn die angegebene Freigabe noch nicht vorhanden ist.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default/shares/{shareName}?api-version=2023-01-01
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. |
Anforderungstext
Name | Typ | Beschreibung |
---|---|---|
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.enabledProtocols |
Das Authentifizierungsprotokoll, das für die Dateifreigabe verwendet wird. Kann nur beim Erstellen einer Freigabe angegeben werden. |
|
properties.metadata |
object |
Ein Name-Wert-Paar, das der Freigabe als Metadaten zugeordnet wird. |
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.signedIdentifiers |
Liste der gespeicherten Zugriffsrichtlinien, die in der Freigabe angegeben sind. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
OK : Der Vorgang zum Aktualisieren der Freigabe 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
Update |
Update |
UpdateShareAcls
Sample Request
PATCH https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/fileServices/default/shares/share6185?api-version=2023-01-01
{
"properties": {
"signedIdentifiers": [
{
"id": "MTIzNDU2Nzg5MDEyMzQ1Njc4OTAxMjM0NTY3ODkwMTI",
"accessPolicy": {
"startTime": "2021-04-01T08:49:37.0000000Z",
"expiryTime": "2021-05-01T08:49:37.0000000Z",
"permission": "rwd"
}
}
]
}
}
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",
"properties": {
"signedIdentifiers": [
{
"id": "MTIzNDU2Nzg5MDEyMzQ1Njc4OTAxMjM0NTY3ODkwMTI",
"accessPolicy": {
"startTime": "2021-04-01T08:49:37.0000000Z",
"expiryTime": "2021-05-01T08:49:37.0000000Z",
"permission": "rwd"
}
}
]
}
}
UpdateShares
Sample Request
PATCH https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/fileServices/default/shares/share6185?api-version=2023-01-01
{
"properties": {
"metadata": {
"type": "image"
}
}
}
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",
"properties": {
"metadata": {
"type": "image"
}
}
}
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. |