Abrufen von Dateidiensteigenschaften

Der Get File Service Properties Vorgang ruft Eigenschaften für die FileService Ressource mithilfe der FileREST-API ab. Obwohl diese API vollständig unterstützt wird, handelt es sich um eine Legacyverwaltungs-API. Es wird empfohlen, stattdessen File Services - Get Service Properties zu verwenden, die vom Speicherressourcenanbieter (Microsoft.Storage) bereitgestellt wird. Weitere Informationen zur programmgesteuerten Interaktion mit der FileService Ressource mithilfe des Speicherressourcenanbieters finden Sie unter Vorgänge in der FileService-Ressource.

Protokollverfügbarkeit

Aktiviertes Dateifreigabeprotokoll	Verfügbar
KMU
NFS (falls abgekürzt von Network File System gemeint)

Anfrage

Die Get File Service Properties Anforderung kann wie folgt angegeben werden. Es wird empfohlen, HTTPS zu verwenden. Ersetzen Sie sie <account-name> durch den Namen Ihres Speicherkontos:

Methode	Anforderungs-URI	HTTP-Version
ERHALTEN/Bekommen	`https://<account-name>.file.core.windows.net/?restype=service&comp=properties`	HTTP/1.1

Hinweis

Der URI muss immer ein Schrägstrich (/) enthalten, um den Hostnamen vom Pfad und den Abfrageabschnitten des URI zu trennen. In diesem Vorgang ist der Pfadteil des URI leer.

URI-Parameter

URI-Parameter	BESCHREIBUNG
`restype=service&comp=properties`	Erforderlich. Die Kombination beider Abfragezeichenfolgen ist erforderlich, um die Speicherdiensteigenschaften festzulegen.
`timeout`	Wahlfrei. Der parameter `timeout` wird in Sekunden ausgedrückt. Weitere Informationen finden Sie unter Festlegen von Timeouts für Dateidienstvorgänge.

Anforderungsheader

In der folgenden Tabelle werden die erforderlichen und optionalen Anforderungsheader beschrieben.

Anforderungs-Kopfzeile	BESCHREIBUNG
`Authorization`	Erforderlich. Gibt das Autorisierungsschema, den Speicherkontonamen 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. Dieser Vorgang ist nur in Version 2015-02-21 und höher verfügbar. Um Metrikeigenschaften für den Dateidienst abzurufen, müssen Sie Version 2015-04-05 oder höher angeben. Weitere Informationen finden Sie unter Versionsverwaltung für die Azure-Speicherdienste.
`x-ms-client-request-id`	Wahlfrei. Stellt einen vom Client generierten, undurchsichtigen Wert mit einem 1-Kibibyte-Zeichenlimit (KiB) bereit, der in den Azure 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 Monitor Azure Files.

Anfragekörper

Keiner.

Antwort

Die Antwort enthält einen HTTP-Statuscode, einen Satz von Antwortheadern und einen Antworttext.

Statuscode

Ein erfolgreicher Vorgang gibt den Statuscode 200 (OK) zurück.

Antwortkopfzeilen

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.

Antwortkopfzeile	BESCHREIBUNG
`x-ms-request-id`	Identifiziert eine Anforderung eindeutig, die für den Dienst ausgeführt wird.
`x-ms-version`	Gibt die Version des Vorgangs an, der für die Antwort verwendet wird. Weitere Informationen finden Sie unter Versionsverwaltung für die Azure-Speicherdienste.
`x-ms-client-request-id`	Kann verwendet werden, um Anfragen und die entsprechenden 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 nicht mehr als 1.024 sichtbare ASCII-Zeichen enthält. Wenn der `x-ms-client-request-id`-Header in der Anforderung nicht vorhanden ist, ist er in der Antwort nicht vorhanden.

Antwortkörper

Das Format des Antwortkörpers für Version 2026-02-06 ist wie folgt:

<?xml version="1.0" encoding="utf-8"?>  
<StorageServiceProperties>  
    <HourMetrics>  
        <Version>version-number</Version>  
        <Enabled>true|false</Enabled>  
        <IncludeAPIs>true|false</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </HourMetrics>  
    <MinuteMetrics>  
        <Version>version-number</Version>  
        <Enabled>true|false</Enabled>  
        <IncludeAPIs>true|false</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </MinuteMetrics>  
    <Cors>  
        <CorsRule>  
            <AllowedOrigins>comma-separated-list-of-allowed-origins</AllowedOrigins>  
            <AllowedMethods>comma-separated-list-of-HTTP-verb</AllowedMethods>  
            <MaxAgeInSeconds>max-caching-age-in-seconds</MaxAgeInSeconds>  
            <ExposedHeaders>comma-separated-list-of-response-headers</ExposedHeaders>  
            <AllowedHeaders>comma-separated-list-of-request-headers</AllowedHeaders>  
        </CorsRule>  
    </Cors>
    <ShareDeleteRetentionPolicy>
        <Enabled>true|false</Enabled>
        <Days>integer-value</Days>
    </ShareDeleteRetentionPolicy>
    <ProtocolSettings>
        <SMB>
            <Multichannel>
                <Enabled>true|false</Enabled>
            </Multichannel>
            <Versions>semicolon-separated-list-of-smb-versions</Versions>
            <AuthenticationMethods>semicolon-separated-list-of-auth-methods</AuthenticationMethod>
            <KerberosTicketEncryption>semicolon-separated-list-of-kerberos-encryption-algorithms</KerberosTicketEncryption>
            <ChannelEncryption>semicolon-separated-list-of-smb-channel-encryption-algorithms</ChannelEncryption>
            <EncryptionInTransit>
                <Required>true|false</Required>
            </EncryptionInTransit>
        </SMB>
        <NFS>
            <EncryptionInTransit>
                <Required>true|false</Required>
            </EncryptionInTransit>
        </NFS>
    </ProtocolSettings>
</StorageServiceProperties>

Die Elemente des Antworttexts werden in der folgenden Tabelle beschrieben:

Name	BESCHREIBUNG
`HourMetrics`	Gruppiert die Speicheranalyseeinstellungen `HourMetrics` . Die `HourMetrics` Einstellungen enthalten eine Zusammenfassung der Anforderungsstatistiken, gruppiert nach API in Stündchenaggregaten.
`MinuteMetrics`	Gruppiert die Speicheranalyseeinstellungen `MinuteMetrics` . Die `MinuteMetrics` Einstellungen stellen Anforderungsstatistiken für jede Minute bereit.
`Version`	Die aktuell verwendete Version der Speicheranalyse.
`Enabled`	Gibt an, ob Metriken für den Dateidienst aktiviert sind.
`IncludeAPIs`	Gibt an, ob Metriken Zusammenfassende Statistiken für aufgerufene API-Vorgänge generieren.
`RetentionPolicy/Enabled`	Gibt an, ob eine Aufbewahrungsrichtlinie für den Dateidienst aktiviert ist.
`RetentionPolicy/Days`	Gibt die Anzahl der Tage an, für die Metrikdaten aufbewahrt werden. Alle Daten, die älter als dieser Wert sind, werden auf best-effort-Basis gelöscht.
`Cors`	Gruppiert alle corS-Regeln (Cross-Origin Resource Sharing).
`CorsRule`	Gruppeneinstellungen für eine CORS-Regel.
`AllowedOrigins`	Eine durch Trennzeichen getrennte Liste von Ursprungsdomänen, die über CORS zulässig sind, oder "*", wenn alle Domänen zulässig sind.
`ExposedHeaders`	Eine durch Trennzeichen getrennte Liste von Antwortheadern, die CORS-Clients zur Verfügung stellen sollen.
`MaxAgeInSeconds`	Die Anzahl der Sekunden, für die der Client oder Browser eine Preflight-Antwort zwischenspeichern soll.
`AllowedHeaders`	Eine durch Trennzeichen getrennte Liste von Kopfzeilen, die Teil der ursprungsübergreifenden Anforderung sein dürfen.
`AllowedMethods`	Eine durch Trennzeichen getrennte Liste von HTTP-Methoden, die vom Ursprung ausgeführt werden dürfen. Für Azure Files sind zulässige Methoden DELETE, GET, HEAD, MERGE, POST, OPTIONS und PUT.
`ShareDeleteRetentionPolicy`	Die Eigenschaften für vorläufige Löschungen für die Azure-Dateifreigaben in diesem Speicherkonto.
`Days`	Gibt die Anzahl der Tage an, die die Azure-Dateifreigabe beibehalten werden soll (vorläufig gelöscht). Der angegebene Mindestwert kann 1 und der Maximalwert 365 sein.
`Enabled`	Gibt an, ob das Speicherkonto für Azure Files vorläufig gelöscht wurde.
`ProtocolSettings`	Gruppiert die Einstellungen für Dateisystemprotokolle.
`SMB`	Gruppiert die Einstellungen für den Servernachrichtenblock (Server Message Block, SMB).
`Multichannel`	Enthält die Einstellungen für SMB Multichannel. Diese Einstellung hat eine Eigenschaft: aktiviert/deaktiviert.
`Versions`	Verfügbar ab Version 2020-04-08. Eine durch Semikolons getrennte Liste zulässiger SMB-Versionen. Mögliche Werte: `SMB2.1`, `SMB3.0`, und `SMB3.1.1`. Wenn `Version` nicht angegeben, ist die Standardeinstellung, dass alle Versionen aktiviert sind. SMB 2.1 ist jedoch nur verfügbar, wenn die Eigenschaft des Speicherkontos `require secure transit` deaktiviert ist, da SMB 2.1 die Verschlüsselung nicht unterstützt.
`AuthenticationMethods`	Verfügbar ab Version 2020-04-08. Eine durch Semikolons getrennte Liste der zulässigen Authentifizierungsmethoden. Mögliche Werte: `NTLMv2`, `Kerberos`. Wenn `AuthenticationMethods` nicht angegeben, ist die Standardeinstellung, dass alle Authentifizierungsmethoden zulässig sind.
`KerberosTicketEncryption`	Verfügbar ab Version 2020-04-08. Eine durch Semikolons getrennte Liste zulässiger Kerberos-Ticketverschlüsselungsalgorithmen. Mögliche Werte: `RC4-HMAC` und `AES-256`. Wenn `KerberosTicketEncryption` nicht angegeben, ist die Standardeinstellung, dass alle Kerberos-Ticketverschlüsselungsalgorithmen unterstützt werden.
`ChannelEncryption`	Verfügbar ab Version 2020-04-08. Eine durch Semikolons getrennte Liste zulässiger SMB-Kanalverschlüsselungsalgorithmen. Mögliche Werte: `AES-128-CCM`, `AES-128-GCM`, und `AES-256-GCM`. Wenn `ChannelEncryption` nicht angegeben, wird standardmäßig festgelegt, dass alle Kanalverschlüsselungswerte unterstützt werden. Wenn die Eigenschaft des Speicherkontos `require secure transit` deaktiviert ist, ist auch der unverschlüsselte SMB-Zugriff zulässig.
`NFS`	Verfügbar ab Version am 06.02.2026. Gruppiert die Einstellungen für NFS.
`EncryptionInTransit`	Verfügbar ab Version am 06.02.2026. SMB- und NFS-Verschlüsselung im Transit enthält die `Required` boolesche Eigenschaft, die die Anforderung der SMB- und NFS-Verschlüsselung während des Transits anzeigt. Die NFS-Verschlüsselung während des Transits ist nur für Premium-Speicherkonten verfügbar.

Autorisierung

Nur der Besitzer des Speicherkontos kann diesen Vorgang aufrufen.

Beispielanforderung und -antwort

Der folgende Beispiel-URI stellt eine Anforderung zum Abrufen der Dateidiensteigenschaften für ein Speicherkonto namens "myaccount" vor:

Methode	URL	Protokoll
ERHALTEN/Bekommen	`https://myaccount.file.core.windows.net/?restype=service&comp=properties`	HTTP/1.1

Die Anforderung wird mit den folgenden Headern gesendet:

x-ms-version: 2026-02-06  
x-ms-date: <date>  
Authorization: SharedKey  
myaccount:Z1lTLDwtq5o1UYQluucdsXk6/iB7YxEu0m6VofAEkUE=  
Host: myaccount.file.core.windows.net

Nachdem die Anforderung gesendet wurde, wird die folgende Antwort zurückgegeben:

HTTP/1.1 200 OK  
Content-Length: 1020  
Content-Type: application/xml  
Date: <date>  
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0  
x-ms-request-id: cb939a31-0cc6-49bb-9fe5-3327691f2a30  
x-ms-version: 2026-02-06

Die Antwort enthält den folgenden XML-Textkörper:

<?xml version="1.0" encoding="utf-8"?>  
<StorageServiceProperties>  
    <HourMetrics>  
        <Version>1.0</Version>  
        <Enabled>true</Enabled>  
        <IncludeAPIs>false</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true</Enabled>  
            <Days>7</Days>  
        </RetentionPolicy>  
    </HourMetrics>  
    <MinuteMetrics>  
        <Version>1.0</Version>  
        <Enabled>true</Enabled>  
        <IncludeAPIs>true</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true</Enabled>  
            <Days>7</Days>  
        </RetentionPolicy>  
    </MinuteMetrics>  
    <Cors>  
        <CorsRule>  
            <AllowedOrigins>http://www.fabrikam.com,http://www.contoso.com</AllowedOrigins>  
            <AllowedMethods>GET,PUT</AllowedMethods>  
            <MaxAgeInSeconds>500</MaxAgeInSeconds>  
            <ExposedHeaders>x-ms-meta-data*,x-ms-meta-customheader</ExposedHeaders>  
            <AllowedHeaders>x-ms-meta-target*,x-ms-meta-customheader</AllowedHeaders>  
        </CorsRule>  
    </Cors>
    <ShareDeleteRetentionPolicy>
        <Enabled>true</Enabled>
        <Days>7</Days>
    </ShareDeleteRetentionPolicy>
    <ProtocolSettings>
        <SMB>
            <Multichannel>
                <Enabled>true</Enabled>
            </Multichannel>
            <Versions>SMB3.1.1</Versions>
            <AuthenticationMethods>Kerberos</AuthenticationMethods>
            <KerberosTicketEncryption>AES-256</KerberosTicketEncryption>
            <ChannelEncryption>AES-256-GCM</ChannelEncryption>
            <EncryptionInTransit>
                <Required>true</Required>
            </EncryptionInTransit>
        </SMB>
        <NFS>
            <EncryptionInTransit>
                <Required>true</Required>
            </EncryptionInTransit>
        </NFS>
    </ProtocolSettings>
</StorageServiceProperties>

Bemerkungen

Ausführliche Informationen zu CORS-Regeln und -Auswertungslogik finden Sie unter CORS-Unterstützung für die Azure Storage-Dienste.

Weitere Informationen finden Sie unter Storage Analytics.

Last updated on 2025-11-26

Freigeben über