Condividi tramite


Get File Service Properties

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 Sì
NFS Sì

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 archiviazioneHourMetrics. Le HourMetrics impostazioni forniscono un riepilogo delle statistiche delle richieste, raggruppate per API in aggregazioni orarie.
MinuteMetrics Raggruppa le impostazioni di Analisi archiviazioneMinuteMetrics. 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.0e 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-GCMe 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.