Delen via

Eigenschappen van bestandsservice ophalen

Met Get File Service Properties de bewerking worden eigenschappen voor de FileService resource opgehaald met behulp van de FileREST-API. Hoewel deze API volledig wordt ondersteund, is dit een verouderde beheer-API. U wordt aangeraden in plaats daarvan Bestandsservices te gebruiken: Service-eigenschappen ophalen, die wordt geleverd door de opslagresourceprovider (Microsoft.Storage). Zie FileService voor meer informatie over programmatisch communiceren met de resource met behulp van de opslagresourceprovider.

Beschikbaarheid van protocol

Protocol voor bestandsshare ingeschakeld Beschikbaar
Kleine en Middelgrote Ondernemingen (SMB) Ja
Network File System (NFS) Ja

Aanvraag

De Get File Service Properties aanvraag kan als volgt worden opgegeven. U wordt aangeraden HTTPS te gebruiken. Vervang <account-name> door de naam van uw opslagaccount:

Methode URI-aanvraag HTTP-versie
TOEVOEGEN https://<account-name>.file.core.windows.net/?restype=service&comp=properties HTTP/1.1

Opmerking

De URI moet altijd een slash(/) bevatten om de hostnaam te scheiden van het pad en querygedeelten van de URI. In deze bewerking is het padgedeelte van de URI leeg.

URI Parameters

URI-parameter Beschrijving
restype=service&comp=properties Verplicht. De combinatie van beide queryreeksen is vereist om de eigenschappen van de opslagservice in te stellen.
timeout Facultatief. De parameter timeout wordt uitgedrukt in seconden. Zie Time-outs instellen voor bestandsservicebewerkingenvoor meer informatie.

Headers aanvragen

In de volgende tabel worden de vereiste en optionele aanvraagheaders beschreven.

Header van het verzoek Beschrijving
Authorization Verplicht. Hiermee geeft u het autorisatieschema, de naam van het opslagaccount en de handtekening op. Zie Aanvragen autoriseren voor Azure Storagevoor meer informatie.
Date of x-ms-date Verplicht. Hiermee geeft u de Coordinated Universal Time (UTC) voor de aanvraag. Zie Aanvragen autoriseren voor Azure Storagevoor meer informatie.
x-ms-version Vereist voor alle geautoriseerde aanvragen. Hiermee geeft u de versie van de bewerking die moet worden gebruikt voor deze aanvraag. Deze bewerking is alleen beschikbaar in versie 2015-02-21 en hoger. Als u metrische eigenschappen voor de bestandsservice wilt ophalen, moet u versie 2015-04-05 of hoger opgeven.

Zie Versiebeheer voor de Azure Storage-services voor meer informatie.
x-ms-client-request-id Facultatief. Biedt een door de client gegenereerde, ondoorzichtige waarde met een tekenlimiet van 1 kibibyte (KiB) die wordt vastgelegd in de Azure Storage Analytics-logboeken wanneer logboekregistratie is geconfigureerd. We raden u ten zeerste aan deze header te gebruiken om activiteiten aan de clientzijde te correleren met aanvragen die de server ontvangt. Zie Azure Files bewaken voor meer informatie.

Inhoud van het verzoek

Geen.

Reactie

Het antwoord bevat een HTTP-statuscode, een set antwoordheaders en een hoofdtekst van het antwoord.

Statuscode

Een geslaagde bewerking retourneert statuscode 200 (OK).

Antwoordkopteksten

Het antwoord voor deze bewerking bevat de volgende headers. Het antwoord kan ook aanvullende standaard HTTP-headers bevatten. Alle standaardheaders voldoen aan de HTTP/1.1-protocolspecificatie.

Antwoordheader Beschrijving
x-ms-request-id Identificeert uniek een aanvraag die wordt gedaan voor de service.
x-ms-version Hiermee geeft u de versie van de bewerking die wordt gebruikt voor het antwoord. Zie Versiebeheer voor de Azure Storage-services voor meer informatie.
x-ms-client-request-id Kan worden gebruikt voor het oplossen van problemen met aanvragen en de bijbehorende antwoorden. De waarde van deze header is gelijk aan de waarde van de x-ms-client-request-id header als deze aanwezig is in de aanvraag en de waarde niet meer dan 1024 zichtbare ASCII-tekens bevat. Als de x-ms-client-request-id header niet aanwezig is in de aanvraag, is deze niet aanwezig in het antwoord.

Antwoordlichaam

Het format van de responsinhoud voor versie 2026-02-06 is als volgt:

<?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>

De elementen van de hoofdtekst van het antwoord worden beschreven in de volgende tabel:

Naam Beschrijving
HourMetrics Hiermee worden de opslaganalyse-instellingen HourMetrics gegroepeerd. De HourMetrics instellingen bieden een overzicht van aanvraagstatistieken, gegroepeerd op API in aggregaties per uur.
MinuteMetrics Hiermee worden de opslaganalyse-instellingen MinuteMetrics gegroepeerd. De MinuteMetrics instellingen bieden aanvraagstatistieken voor elke minuut.
Version De versie van Storage Analytics die momenteel wordt gebruikt.
Enabled Geeft aan of metrische gegevens zijn ingeschakeld voor de Bestandsservice.
IncludeAPIs Geeft aan of metrische gegevens samenvattingsstatistieken genereren voor aangeroepen API-bewerkingen.
RetentionPolicy/Enabled Hiermee wordt aangegeven of een bewaarbeleid is ingeschakeld voor de Bestandsservice.
RetentionPolicy/Days Geeft het aantal dagen aan waarvoor metrische gegevens worden bewaard. Alle gegevens die ouder zijn dan deze waarde, worden verwijderd op basis van best effort.
Cors Hiermee worden alle CORS-regels (Cross-Origin Resource Sharing) gegroepeerd.
CorsRule Groepeert instellingen voor een CORS-regel.
AllowedOrigins Een door komma's gescheiden lijst met oorsprongsdomeinen die zijn toegestaan via CORS of *als alle domeinen zijn toegestaan.
ExposedHeaders Een door komma's gescheiden lijst met antwoordheaders om deze beschikbaar te maken voor CORS-clients.
MaxAgeInSeconds Het aantal seconden dat de client of browser een voorbereidend antwoord in de cache moet opslaan.
AllowedHeaders Een door komma's gescheiden lijst met headers die deel mogen uitmaken van de cross-origin-aanvraag.
AllowedMethods Een door komma's gescheiden lijst met HTTP-methoden die mogen worden uitgevoerd door de oorsprong. Voor Azure Files zijn toegestane methoden DELETE, GET, HEAD, MERGE, POST, OPTIONS en PUT.
ShareDeleteRetentionPolicy De eigenschappen voor voorlopig verwijderen voor de Azure-bestandsshares in dit opslagaccount.
Days Geeft het aantal dagen aan dat de Azure-bestandsshare moet worden bewaard (voorlopig verwijderd). De minimaal opgegeven waarde kan 1 zijn en de maximumwaarde is 365.
Enabled Hiermee wordt aangegeven of het opslagaccount voorlopig verwijderen is ingeschakeld voor Azure Files.
ProtocolSettings Hiermee worden de instellingen voor bestandssysteemprotocollen gegroepeerd.
SMB Hiermee worden de instellingen voor Server Message Block (SMB) gegroepeerd.
Multichannel Bevat de instellingen voor SMB Meerdere kanalen. Deze instelling heeft één eigenschap: ingeschakeld/uitgeschakeld.
Versions Beschikbaar vanaf versie 2020-04-08. Een door puntkomma's gescheiden lijst met toegestane SMB-versies. Mogelijke waarden: SMB2.1, SMB3.0en SMB3.1.1. Als Version dit niet is opgegeven, is de standaardinstelling dat alle versies zijn ingeschakeld. SMB 2.1 is echter alleen beschikbaar als de eigenschap van require secure transit het opslagaccount is uitgeschakeld, omdat SMB 2.1 geen ondersteuning biedt voor versleuteling.
AuthenticationMethods Beschikbaar vanaf versie 2020-04-08. Een door puntkomma's gescheiden lijst met toegestane verificatiemethoden. Mogelijke waarden: NTLMv2, Kerberos. Als AuthenticationMethods dit niet is opgegeven, is de standaardwaarde dat alle verificatiemethoden zijn toegestaan.
KerberosTicketEncryption Beschikbaar vanaf versie 2020-04-08. Een door puntkomma's gescheiden lijst met toegestane Kerberos-ticketversleutelingsalgoritmen. Mogelijke waarden: RC4-HMAC en AES-256. Als KerberosTicketEncryption dit niet is opgegeven, is de standaardwaarde dat alle Kerberos-ticketversleutelingsalgoritmen worden ondersteund.
ChannelEncryption Beschikbaar vanaf versie 2020-04-08. Een door puntkomma's gescheiden lijst met toegestane SMB-kanaalversleutelingsalgoritmen. Mogelijke waarden: AES-128-CCM, AES-128-GCMen AES-256-GCM. Als ChannelEncryption dit niet is opgegeven, is de standaardwaarde dat alle kanaalversleutelingswaarden worden ondersteund. Als de eigenschap van require secure transit het opslagaccount is uitgeschakeld, is niet-versleutelde SMB-toegang ook toegestaan.
NFS Beschikbaar vanaf versie 2026-02-06. Groepeert de instellingen voor NFS.
EncryptionInTransit Beschikbaar vanaf versie 2026-02-06. SMB- en NFS-encryptie tijdens transit bevat de Required Booleaanse eigenschap, die de vereiste van SMB- en NFS-encryptie tijdens transit aangeeft. De NFS-encryptie tijdens transport is alleen beschikbaar voor premium opslagaccounts.

Autorisatie

Alleen de eigenaar van het opslagaccount kan deze bewerking aanroepen.

Voorbeeldaanvraag en -antwoord

Met de volgende voorbeeld-URI wordt een aanvraag ingediend om de bestandsservice-eigenschappen op te halen voor een opslagaccount met de naam myaccount:

Methode Naamsvermelding protocol
TOEVOEGEN https://myaccount.file.core.windows.net/?restype=service&comp=properties HTTP/1.1

De aanvraag wordt verzonden met de volgende headers:

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

Nadat de aanvraag is verzonden, wordt het volgende antwoord geretourneerd:

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

Het antwoord bevat de volgende XML-hoofdtekst:

<?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>

Opmerkingen

Zie CORS-ondersteuning voor de Azure Storage-services voor gedetailleerde informatie over CORS-regels en evaluatielogica.

Zie Opslaganalyse voor meer informatie.

  • Last updated on