Get File Service Properties

Articolo
07/19/2023

L'operazione Get File Service Properties ottiene le proprietà per la risorsa usando l'API FileService FileREST. Anche se questa API è completamente supportata, è un'API di gestione legacy. È consigliabile usare invece Servizi file - Ottenere le proprietà del servizio, fornite dal provider di risorse di archiviazione (Microsoft.Storage). Per altre informazioni sull'interazione a livello di codice con la risorsa usando il FileService provider di risorse di archiviazione, vedere Operazioni sulla risorsa FileService.

Disponibilità del protocollo

Protocollo di condivisione file abilitato	Disponibile
SMB
NFS

Richiesta

La richiesta di Get File Service Properties può essere specificata come indicato di seguito. È consigliabile usare HTTPS. Sostituire <account-name> con il nome dell'account di archiviazione:

Metodo	URI richiesta	Versione HTTP
GET	`https://<account-name>.file.core.windows.net/?restype=service&comp=properties`	HTTP/1.1

Nota

L'URI deve sempre includere un carattere di barra (/) per separare il nome host dal percorso e dalle parti di query dell'URI. In questa operazione la parte del percorso dell'URI è vuota.

Parametri URI

Parametro URI	Descrizione
`restype=service&comp=properties`	Obbligatorio. La combinazione di entrambe le stringhe di query è necessaria per impostare le proprietà del servizio di archiviazione.
`timeout`	Facoltativa. Il parametro `timeout` viene espresso in secondi. Per altre informazioni, vedere Impostare timeout per le operazioni del servizio file.

Intestazioni della richiesta

Nella seguente tabella vengono descritte le intestazioni di richiesta obbligatorie e facoltative.

Intestazione della richiesta	Descrizione
`Authorization`	Obbligatorio. Specifica lo schema di autorizzazione, il nome dell'account di archiviazione e la firma. Per altre informazioni, vedere Autorizzare le richieste ad Archiviazione di Azure.
`Date` o `x-ms-date`	Obbligatorio. Specifica la data per la richiesta nel fuso orario UTC (Coordinated Universal Time). Per altre informazioni, vedere Autorizzare le richieste ad Archiviazione di Azure.
`x-ms-version`	Obbligatorio per tutte le richieste autorizzate. Specifica la versione dell'operazione da usare per questa richiesta. Questa operazione è disponibile solo nella versione 2015-02-21 e versioni successive. Per recuperare le proprietà delle metriche per il servizio file, è necessario specificare la versione 2015-04-05 o successiva. Per altre informazioni, vedere Controllo delle versioni per i servizi di archiviazione di Azure.
`x-ms-client-request-id`	Facoltativa. Fornisce un valore opaco generato dal client con un limite di caratteri di 1 kibibyte (KiB) registrato nei log di Azure Analisi archiviazione durante la configurazione della registrazione. È consigliabile usare questa intestazione per correlare le attività lato client con le richieste ricevute dal server. Per altre informazioni, vedere Monitorare File di Azure.

Testo della richiesta

Nessuno.

Risposta

Nella risposta sono inclusi un codice di stato HTTP, un set di intestazioni per la risposta e il corpo di una risposta.

Codice stato

Un'operazione completata correttamente restituisce 200 (OK).

Intestazioni di risposta

Nella risposta per questa operazione sono incluse le intestazioni riportate di seguito; inoltre, possono essere incluse intestazioni HTTP standard aggiuntive. Tutte le intestazioni standard sono conformi alla specifica del protocollo HTTP/1.1.

Intestazione risposta	Descrizione
`x-ms-request-id`	Identifica in modo univoco una richiesta effettuata sul servizio.
`x-ms-version`	Specifica la versione dell'operazione usata per la risposta. Per altre informazioni, vedere Controllo delle versioni per i servizi di archiviazione di Azure.
`x-ms-client-request-id`	Può essere usato per risolvere i problemi delle richieste e delle relative risposte corrispondenti. Il valore di questa intestazione è uguale al valore dell'intestazione `x-ms-client-request-id` se presente nella richiesta e il valore non contiene più di 1.024 caratteri ASCII visibili. Se l'intestazione `x-ms-client-request-id` non è presente nella richiesta, non è presente nella risposta.

Corpo della risposta

Il formato del corpo della risposta per la versione 2020-02-10 è il seguente:

<?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-seperated-list-of-response-headers</ExposedHeaders>  
            <AllowedHeaders>comma-seperated-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>comma-separated-list-of-smb-versions</Versions>
            <AuthenticationMethods>comma-separated-list-of-auth-methods</AuthenticationMethod>
            <KerberosTicketEncryption>csv-of-kerb-encryption-algorithms</KerberosTicketEncryption>
            <ChannelEncryption>csv-of-smb-encryption-algorithms</ChannelEncryption>
        </SMB>
    </ProtocolSettings>
</StorageServiceProperties>

Nella tabella seguente vengono descritti gli elementi del corpo della risposta:

Nome	Descrizione
`HourMetrics`	Raggruppa le impostazioni di Analisi archiviazione`HourMetrics`. Le `HourMetrics` impostazioni forniscono un riepilogo delle statistiche delle richieste, raggruppate per API in aggregazioni orarie.
`MinuteMetrics`	Raggruppa le impostazioni di Analisi archiviazione`MinuteMetrics`. Le `MinuteMetrics` impostazioni forniscono le statistiche delle richieste per ogni minuto.
`Version`	Versione di Analisi archiviazione attualmente in uso.
`Enabled`	Indica se le metriche sono abilitate per il servizio file.
`IncludeAPIs`	Indica se le metriche generano statistiche di riepilogo per le operazioni API chiamate.
`RetentionPolicy/Enabled`	Indica se un criterio di conservazione è abilitato per il servizio file.
`RetentionPolicy/Days`	Indica il numero di giorni per i quali vengono conservati i dati delle metriche. Tutti i dati meno recenti di questo valore vengono eliminati su base ottimale.
`Cors`	Raggruppa tutte le regole CORS (Cross-Origin Resource Sharing).
`CorsRule`	Raggruppa le impostazioni per una regola CORS.
`AllowedOrigins`	Elenco separato da virgole dei domini di origine consentiti tramite CORS o "*" se tutti i domini sono consentiti.
`ExposedHeaders`	Elenco separato da virgole delle intestazioni delle risposte da esporre ai client CORS.
`MaxAgeInSeconds`	Numero di secondi in cui il client o il browser devono memorizzare nella cache una risposta preliminare.
`AllowedHeaders`	Elenco delimitato da virgole di intestazioni che possono essere parte della richiesta tra origini.
`AllowedMethods`	Elenco separato da virgole dei metodi HTTP che possono essere eseguiti dall'origine. Per File di Azure, i metodi consentiti sono DELETE, GET, HEAD, MERGE, POST, OPTIONS e PUT.
`ShareDeleteRetentionPolicy`	Proprietà di eliminazione temporanea per le condivisioni file di Azure in questo account di archiviazione.
`Days`	Indica il numero di giorni di conservazione della condivisione file di Azure (eliminazione temporanea). Il valore minimo specificato può essere 1 e il valore massimo è 365.
`Enabled`	Indica se l'account di archiviazione ha abilitato l'eliminazione temporanea per File di Azure.
`ProtocolSettings`	Raggruppa le impostazioni per i protocolli del file system.
`SMB`	Raggruppa le impostazioni per Server Message Block (SMB).
`Multichannel`	Contiene le impostazioni per SMB Multichannel. Questa impostazione ha una proprietà: abilitata/disabilitata.
`Version`	Disponibile a partire dalla versione 2020-04-08. Elenco delimitato da virgole delle versioni SMB consentite. Valori possibili: `SMB2.1`, `SMB3.0`e `SMB3.1.1`. Se `Version` non è specificato, il valore predefinito è che tutte le versioni sono abilitate. Tuttavia, SMB 2.1 è disponibile solo se la proprietà dell'account di `require secure transit` archiviazione è disabilitata, perché SMB 2.1 non supporta la crittografia.
`AuthenticationMethods`	Disponibile a partire dalla versione 2020-04-08. Elenco delimitato da virgole dei metodi di autenticazione consentiti. Valori possibili: `NTLMv2`, `Kerberos`. Se `AuthenticationMethods` non è specificato, il valore predefinito è che tutti i metodi di autenticazione sono consentiti.
`KerberosTicketEncryption`	Disponibile a partire dalla versione 2020-04-08. Elenco delimitato da virgole degli algoritmi di crittografia dei ticket Kerberos consentiti. Valori possibili: `RC4-HMAC` e `AES-256`. Se `KerberosTicketEncryption` non è specificato, l'impostazione predefinita è che sono supportati tutti gli algoritmi di crittografia del ticket Kerberos.
`ChannelEncryption`	Disponibile a partire dalla versione 2020-04-08. Elenco delimitato da virgole dei protocolli di crittografia del canale SMB consentiti. Valori possibili: `AES-128-CCM`, `AES-128-GCM`e `AES-256-GCM`. Se `ChannelEncryption` non è specificato, il valore predefinito è che sono supportati tutti i valori di crittografia del canale. Se la proprietà dell'account di `require secure transit` archiviazione è disabilitata, è consentito anche l'accesso SMB non crittografato.

Autorizzazione

Solo il proprietario dell'account di archiviazione può chiamare questa operazione.

Richiesta di esempio e risposta

L'URI di esempio seguente effettua una richiesta per ottenere le proprietà del servizio file per un account di archiviazione denominato myaccount:

Metodo	URL	Protocollo
GET	`https://myaccount.file.core.windows.net/?restype=service&comp=properties`	HTTP/1.1

La richiesta viene inviata con le intestazioni seguenti:

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

Dopo l'invio della richiesta viene restituita la risposta seguente:

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: 2015-04-05

Nella risposta è incluso il seguente corpo XML:

<?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>
        </SMB>
    </ProtocolSettings>
</StorageServiceProperties>

Commenti

Per informazioni dettagliate sulle regole CORS e sulla logica di valutazione, vedere SUPPORTO CORS per i servizi di archiviazione di Azure.

Per altre informazioni, vedere Analisi archiviazione.