Festlegen von Freigabeeigenschaften
Der vorgang Set Share Properties legt Eigenschaften für die angegebene Azure-Dateifreigabe fest. Obwohl dieser Vorgang vollständig unterstützt wird, handelt es sich um einen Legacyverwaltungsvorgang. Es wird empfohlen, stattdessen die Dateifreigaben zu verwenden: Aktualisieren Vorgang, der vom Speicherressourcenanbieter (Microsoft.Storage) bereitgestellt wird. Weitere Informationen zur programmgesteuerten Interaktion mit FileShare Ressourcen mithilfe des Speicherressourcenanbieters finden Sie unter Vorgänge für FileShare-Ressourcen.
Protokollverfügbarkeit
| Aktiviertes Dateifreigabeprotokoll | Verfügbar |
|---|---|
| SMB |
|
| NFS |
|
Bitten
Sie können die Set Share Properties Anforderung wie folgt erstellen. Https wird empfohlen. Ersetzen Sie myaccount durch den Namen Ihres Speicherkontos.
| Methode | Anforderungs-URI | HTTP-Version |
|---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare?restype=share&comp=properties |
HTTP/1.1 |
Ersetzen Sie die pfadkomponenten, die im Anforderungs-URI angezeigt werden, wie folgt:
| Pfadkomponente | Beschreibung |
|---|---|
myaccount |
Der Name Ihres Speicherkontos. |
myshare |
Der Name Ihrer Dateifreigabe. |
Ausführliche Informationen zu Pfadbenennungseinschränkungen finden Sie unter Benennen und Verweisen auf Freigaben, Verzeichnisse, Dateien und Metadaten.
URI-Parameter
Sie können die folgenden zusätzlichen Parameter im Anforderungs-URI angeben:
| Parameter | Beschreibung |
|---|---|
timeout |
Wahlfrei. Ausgedrückt in Sekunden. Weitere Informationen finden Sie unter Festlegen von Timeouts für Azure Files-Vorgänge. |
Anforderungsheader
In der folgenden Tabelle werden die erforderlichen und optionalen Anforderungsheader beschrieben:
| Anforderungsheader | Beschreibung |
|---|---|
Authorization |
Erforderlich. Gibt das Autorisierungsschema, den Kontonamen und die Signatur an. Weitere Informationen finden Sie unter Autorisieren von Anforderungen an Azure Storage. |
Date oder x-ms-date |
Erforderlich. Gibt die koordinierte Weltzeit (UTC) für die Anforderung an. Weitere Informationen finden Sie unter Autorisieren von Anforderungen an Azure Storage. |
x-ms-version |
Erforderlich für alle autorisierten Anforderungen. Gibt die Version des Vorgangs an, der für diese Anforderung verwendet werden soll. Weitere Informationen finden Sie unter Versionsverwaltung für die Azure Storage-Dienste. |
x-ms-share-quota |
Wahlfrei. Unterstützt in Version 2015-02-21 und höher. Gibt die maximale Größe der Freigabe in Gibibytes (GiB) an. |
x-ms-access-tier |
Wahlfrei. Unterstützt in Version 2019-12-12 und höher. Gibt die Zugriffsebene der Freigabe an. Gültige Werte sind TransactionOptimized, Hotund Cool. Ausführliche Informationen zur Dateifreigabeebene finden Sie unter Azure Files-Speicherebenen. |
x-ms-root-squash: <NoRootSquash \| RootSquash \| AllSquash> |
Wahlfrei. Unterstützt in Version 2020-02-10 und höher. Gibt das Stammverhalten für die Freigabe an, wenn NFS aktiviert ist.
|
x-ms-enable-snapshot-virtual-directory-access: <true \| false> |
Wahlfrei. Unterstützt in Version 2024-08-04 und höher. Gibt an, ob auf das virtuelle Snapshot-Verzeichnis beim Aktivieren von NFS zugegriffen werden soll. |
x-ms-client-request-id |
Wahlfrei. Stellt einen vom Client generierten, undurchsichtigen Wert mit einem 1-Kibibyte-Zeichenlimit (KiB) bereit, das in den Storage Analytics-Protokollen aufgezeichnet wird, wenn die Protokollierung konfiguriert ist. Es wird dringend empfohlen, diesen Header zu verwenden, um clientseitige Aktivitäten mit Anforderungen zu korrelieren, die der Server empfängt. Weitere Informationen finden Sie unter Überwachen von Azure Blob Storage. |
x-ms-lease-id:<ID> |
Erforderlich, wenn die Zieldateifreigabe über eine aktive Lease verfügt. Verfügbar für Version 2020-02-10 und höher. Wenn die Anforderung die Lease-ID nicht enthält oder nicht gültig ist, schlägt der Vorgang mit dem Statuscode 412 fehl (Vorbedingung fehlgeschlagen). Wenn dieser Header angegeben ist und die Zieldateifreigabe derzeit nicht über eine aktive Lease verfügt, schlägt der Vorgang mit dem Statuscode 412 fehl (Vorbedingung fehlgeschlagen). |
x-ms-share-paid-bursting-enabled: <true \| false> |
Wahlfrei. Unterstützt in Version 2024-11-04 und höher. Nur für Premium-Dateifreigaben zulässig (Dateifreigaben innerhalb des FileStorage-Speicherkontotyps). Diese Eigenschaft kann verwendet werden, um kostenpflichtiges Bursting zu aktivieren oder zu deaktivieren. Wenn die Eigenschaft nicht angegeben ist, behält die Freigabe den vorhandenen Status der kostenpflichtigen Platzierungsaktivierung bei. |
x-ms-share-paid-bursting-max-iops |
Wahlfrei. Unterstützt in Version 2024-11-04 und höher. Nur für Premium-Dateifreigaben zulässig. Eine ganze Zahl, die die für die Freigabe zulässigen maximal bezahlten Eingabe-/Ausgabevorgänge pro Sekunde (IOPS) darstellt. Wenn kostenpflichtiges Bursting für die Freigabe noch nicht aktiviert ist: Das Verhalten ist identisch mit dem x-ms-share-paid-bursting-max-iops Header in Create Share. Der Standardwert, wenn nicht angegeben ist die maximal zulässige IOPS für eine Freigabe. Wenn dieser Header festgelegt ist, muss x-ms-share-paid-bursting-enabled auch auf "true" festgelegt werden.Wenn kostenpflichtiges Bursting bereits für die Freigabe aktiviert ist: x-ms-share-paid-bursting-max-iops kann verwendet werden, um die maximal bezahlten IOPS für die Freigabe zu aktualisieren.
x-ms-share-paid-bursting-enabled muss in diesem Fall nicht festgelegt werden. Wenn x-ms-share-paid-bursting-enabled auf "true" festgelegt ist, aber x-ms-share-paid-bursting-max-iops nicht festgelegt ist, bleiben die maximal bezahlten IOPS unverändert. |
x-ms-share-paid-bursting-max-bandwidth-mibps |
Wahlfrei. Unterstützt in Version 2024-11-04 und höher. Nur für Premium-Dateifreigaben zulässig. Eine ganze Zahl, die die maximal bezahlten mebibytes pro Sekunde (MiB/s) darstellt, die für die Freigabe zulässig sind. Wenn kostenpflichtiges Bursting für die Freigabe noch nicht aktiviert ist: Das Verhalten ist identisch mit dem x-ms-share-paid-bursting-max-bandwidth-mibps Header in Create Share. Der Standardwert, wenn nicht angegeben ist die maximal zulässige MiB/s für eine Freigabe. Wenn dieser Header festgelegt ist, muss x-ms-share-paid-bursting-enabled auch auf "true" festgelegt werden.Wenn kostenpflichtiges Bursting bereits auf der Aktie aktiviert ist: x-ms-share-paid-bursting-max-bandwidth-mibps kann verwendet werden, um den maximal bezahlten MiB/s für die Aktie zu aktualisieren.
x-ms-share-paid-bursting-enabled muss in diesem Fall nicht festgelegt werden. Wenn x-ms-share-paid-bursting-enabled auf "true" festgelegt ist, x-ms-share-paid-bursting-max-bandwidth-mibps jedoch nicht festgelegt ist, bleibt die maximale bezahlte Platzbandbreite unverändert. |
Anforderungstext
Nichts.
Beispielanforderung
PUT https://myaccount.file.core.windows.net/myshare?restype=share&comp=properties
Request Headers:
x-ms-version: 2020-02-10
x-ms-date: <date>
Authorization: SharedKey myaccount: Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00Jdjid0Q=
x-ms-share-quota: 55
x-ms-root-squash: RootSquash
Antwort
Die Antwort enthält einen HTTP-Statuscode und eine Reihe von Antwortheadern.
Statuscode
Ein erfolgreicher Vorgang gibt den Statuscode 200 (OK) zurück.
Informationen zu Statuscodes finden Sie unter Status- und Fehlercodes.
Antwortheader
Die Antwort für diesen Vorgang enthält die folgenden Header. Die Antwort kann auch zusätzliche Standard-HTTP-Header enthalten. Alle Standardheader entsprechen der HTTP/1.1-Protokollspezifikation.
| Antwortheader | Beschreibung |
|---|---|
Last-Modified |
Gibt das Datum und die Uhrzeit der letzten Änderung der Freigabe zurück. Das Datumsformat folgt RFC 1123. Weitere Informationen finden Sie unter Darstellung von Datums-/Uhrzeitwerten in Kopfzeilen. Jeder Vorgang, der die Freigabe oder seine Eigenschaften ändert, aktualisiert den Zeitpunkt der letzten Änderung. Vorgänge für Dateien wirken sich nicht auf den Zeitpunkt der letzten Änderung der Freigabe aus. |
ETag |
Enthält einen Wert, der die Version der Freigabe als an zitierte Zeichenfolge darstellt. |
x-ms-request-id |
Identifiziert eindeutig die Anforderung, die durchgeführt wurde. Sie können sie auch zur Problembehandlung für die Anforderung verwenden. Weitere Informationen finden Sie unter Problembehandlung für API-Vorgänge. |
x-ms-version |
Gibt die Version von Azure Files an, die zum Ausführen der Anforderung verwendet wird. |
Date oder x-ms-date |
Ein UTC-Datums-/Uhrzeitwert, der die Uhrzeit angibt, zu der der Dienst die Antwort gesendet hat. |
x-ms-client-request-id |
Kann verwendet werden, um Anfragen und entsprechende Antworten zu behandeln. Der Wert dieses Headers ist gleich dem Wert des x-ms-client-request-id Headers, wenn er in der Anforderung vorhanden ist und der Wert höchstens 1.024 sichtbare ASCII-Zeichen aufweist. Wenn der x-ms-client-request-id-Header in der Anforderung nicht vorhanden ist, ist dieser Header in der Antwort nicht vorhanden. |
Antworttext
Nichts.
Ermächtigung
Nur der Kontobesitzer kann diesen Vorgang aufrufen.
Bemerkungen
Weitere Informationen zum Festlegen des Freigabekontingents finden Sie unter Create Share.
Wenn Sie festlegen, dass das Freigabekontingent kleiner als die Größe der Daten in der Freigabe ist, wird der Vorgang erfolgreich ausgeführt. Sie können der Freigabe jedoch erst dann weitere Daten hinzufügen, wenn die Menge der Daten in der Freigabe unter dem Kontingent reduziert wird. Sie können die Datenmenge verringern, indem Sie Dateien löschen oder komprimieren.
Set Share Properties wird für eine Freigabemomentaufnahme nicht unterstützt. Ein Versuch, diesen Vorgang für eine Freigabemomentaufnahme auszuführen, schlägt mit dem Statuscode 400 (InvalidQueryParameterValue) fehl.
Wenn Sie den x-ms-enable-snapshot-virtual-directory-access-Header für NFS-Freigaben festlegen, stellen Sie die Freigabe erneut bereit, um das aktualisierte Verhalten zu beobachten.