Set File Service Properties

  • Articolo

L'operazione Set File Service Properties imposta le proprietà per la risorsa del servizio file usando l'API FileREST. Anche se questa API è completamente supportata, si tratta di un'API di gestione legacy. È consigliabile usare invece Servizi file - Impostare le proprietà del servizio, fornito dal provider di risorse di Archiviazione di Azure (Microsoft.Storage). Per altre informazioni sull'interazione a livello di codice con la risorsa del servizio file tramite il provider di risorse di Archiviazione di Azure, vedere Operazioni nel servizio file.

Disponibilità del protocollo

Protocollo di condivisione file abilitato Disponibile
SMB Sì
NFS Sì

Richiesta

È possibile specificare la Set File Service Properties richiesta come indicato di seguito. È consigliabile usare HTTPS. Sostituire account-name con il nome dell'account di archiviazione:

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

Nota

L'URI deve sempre includere un carattere barra (/) per separare il nome host dalle parti del percorso e della 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 i timeout per le operazioni del servizio file.

Intestazioni della richiesta

Le intestazioni di richiesta obbligatorie e facoltative sono descritte nella tabella seguente:

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 or 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 successive. Per abilitare le 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 Analisi archiviazione quando viene configurata la registrazione. È consigliabile usare questa intestazione per correlare le attività lato client alle richieste ricevute dal server. Per altre informazioni, vedere Monitorare File di Azure.

Testo della richiesta

Il formato del corpo della richiesta 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>

Non è necessario specificare ogni elemento radice nella richiesta. Se si omette un elemento radice, vengono mantenute le impostazioni esistenti per il servizio associato alla funzionalità. Tuttavia, se si specifica un determinato elemento radice, è necessario specificare ogni elemento figlio per tale elemento. Gli elementi radice includono:

  • HourMetrics
  • MinuteMetrics
  • Cors
  • ProtocolSettings

Gli elementi del corpo della richiesta sono descritti nella tabella seguente:

Nome Descrizione
HourMetrics Facoltativo per la versione 2015-04-05 e successive. Non applicabile per le versioni precedenti. Raggruppa le impostazioni Analisi archiviazioneHourMetrics, che forniscono un riepilogo delle statistiche delle richieste raggruppate per API in aggregazioni orarie.
MinuteMetrics Facoltativo per la versione 2015-04-05 e successive. Non applicabile per le versioni precedenti. Raggruppa le impostazioni Analisi archiviazioneMinuteMetrics, che forniscono le statistiche delle richieste per ogni minuto.
Version Obbligatorio se le metriche sono abilitate. Versione di Analisi archiviazione da configurare. Usare 1.0 per questo valore.
Enabled Obbligatorio. Indica se le metriche sono abilitate per il servizio file.
IncludeAPIs Obbligatorio solo se le metriche sono abilitate. Indica se la metrica deve generare le statistiche di riepilogo per le operazioni API chiamate.
RetentionPolicy/Enabled Obbligatorio. Indica se un criterio di conservazione è abilitato per il servizio file. Se false, i dati delle metriche vengono conservati e l'utente è responsabile dell'eliminazione.
RetentionPolicy/Days Obbligatorio solo se i criteri di conservazione sono abilitati. Indica il numero di giorni in cui devono essere conservati i dati delle metriche. Tutti i dati precedenti a questo valore vengono eliminati. Il valore minimo che è possibile specificare è 1e il valore massimo è 365 (un anno). I dati delle metriche vengono eliminati in base al massimo sforzo dopo la scadenza del periodo di conservazione.
Cors Facoltativa. L'elemento Cors è supportato per la versione 2015-02-21 e successive. Raggruppa tutte le regole CORS (Cross-Origin Resource Sharing). L'omissione di questo gruppo di elementi non sovrascrive le impostazioni CORS esistenti.
CorsRule Facoltativa. Specifica una regola CORS per il servizio File. È possibile includere fino a cinque elementi CorsRule nella richiesta. Se nel corpo della richiesta non CorsRule sono inclusi elementi, tutte le regole CORS vengono eliminate e CORS è disabilitato per il servizio file.
AllowedOrigins Obbligatorio se l'elemento CorsRule è presente. Elenco delimitato da virgole di domini di origine consentiti tramite CORS o "*" per consentire tutti i domini. Un dominio di origine può includere anche un carattere jolly nel sottodominio per consentire le richieste tramite CORS per tutti i sottodomini di un dominio. Limitato a 64 domini di origine. Ogni origine consentita può contenere fino a 256 caratteri.
ExposedHeaders Obbligatorio se l'elemento CorsRule è presente. Elenco separato da virgole delle intestazioni delle risposte da esporre ai client CORS. Limitato a 64 intestazioni definite e a due intestazioni con prefisso. Ogni intestazione può contenere fino a 256 caratteri.
MaxAgeInSeconds Obbligatorio se l'elemento CorsRule è presente. Numero di secondi durante i quali il client/browser deve memorizzare nella cache una risposta preliminare.
AllowedHeaders Obbligatorio se l'elemento CorsRule esiste. Elenco delimitato da virgole di intestazioni che possono essere parte della richiesta tra origini. Limitato a 64 intestazioni definite e a due intestazioni con prefisso. Ogni intestazione può contenere fino a 256 caratteri.
AllowedMethods Obbligatorio se è presente l'elemento CorsRule. Elenco separato da virgole dei metodi HTTP che possono essere eseguiti dall'origine. Per File di Azure, i metodi consentiti sono DELETE, MERGEHEADPOSTGETOPTIONSe .PUT
ShareDeleteRetentionPolicy Facoltativa. Proprietà di eliminazione temporanea per le condivisioni file di Azure in questo account di archiviazione.
Days Facoltativa. Indica il numero di giorni di conservazione della condivisione file di Azure (eliminazione temporanea). Il valore minimo che è possibile specificare è 1, e il valore massimo è 365 (un anno).
Enabled Facoltativa. Indica se l'account di archiviazione ha abilitato l'eliminazione temporanea per File di Azure.
ProtocolSettings Facoltativa. Raggruppa le impostazioni per i protocolli del file system.
SMB Facoltativa. Raggruppa le impostazioni per SMB.
Multichannel Facoltativa. Contiene le impostazioni per SMB multicanale. SMB multichannel contiene la Enabled proprietà Boolean, che attiva lo stato di SMB multichannel.
Version Facoltativo a partire dalla versione 2020-04-08. Elenco delimitato da virgole delle versioni SMB consentite. I valori consentiti sono SMB2.1, SMB3.0e SMB3.1.1.
AuthenticationMethods Facoltativo a partire dalla versione 2020-04-08. Elenco delimitato da virgole dei metodi di autenticazione consentiti. I valori consentiti sono NTLMv2 e Kerberos.
KerberosTicketEncryption Facoltativo a partire dalla versione 2020-04-08. Elenco delimitato da virgole degli algoritmi di crittografia dei ticket Kerberos consentiti. I valori consentiti sono RC4-HMAC e AES-256.
ChannelEncryption Facoltativo a partire dalla versione 2020-04-08. Elenco delimitato da virgole dei protocolli di crittografia del canale SMB consentiti. I valori consentiti sono AES-128-CCM, AES-128-GCMe AES-256-GCM.

Risposta

Nella risposta sono inclusi un codice di stato HTTP e un set di intestazioni per la risposta.

Codice stato

Un'operazione completata correttamente restituisce il codice di stato 202 (Accettato).

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 Valore che 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 le richieste e le risposte corrispondenti. Il valore dell'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 sarà presente nella risposta.

Corpo della risposta

Nessuno.

Autorizzazione

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

Commenti

Le restrizioni e le limitazioni seguenti si applicano alle regole CORS in File di Azure:

  • È possibile archiviare un massimo di cinque regole.

  • Le dimensioni massime di tutte le impostazioni delle regole CORS nella richiesta, esclusi i tag XML, non devono superare 2 KiB.

  • La lunghezza di un'intestazione consentita, di un'intestazione esposta o di un'origine consentita non deve superare 256 caratteri.

  • Le intestazioni consentite e le intestazioni esposte possono essere una delle seguenti:

    • Intestazioni letterali, per cui non viene specificato il nome esatto dell'intestazione, ad esempio x-ms-meta-processed. È possibile specificare un massimo di 64 intestazioni letterali nella richiesta.

    • Intestazioni con prefisso, per cui viene specificato un prefisso dell'intestazione, ad esempio x-ms-meta-data*. La specifica di un prefisso in questo modo consente o espone qualsiasi intestazione che inizia con tale prefisso. È possibile specificare un massimo di due intestazioni con prefisso nella richiesta.

  • I metodi (o verbi HTTP) specificati nell'elemento AllowedMethods devono essere conformi ai metodi supportati dalle API del servizio di archiviazione di Azure. I metodi supportati sono DELETE, HEADPOSTOPTIONSGETMERGEe .PUT

L'impostazione di regole CORS nella richiesta è facoltativa. Se si chiama Set File Service Properties senza specificare l'elemento CORS nel corpo della richiesta, vengono mantenute le regole CORS esistenti.

Per disabilitare CORS, chiamare Set File Service Properties con un'impostazione di regole CORS vuota ( ovvero </Cors>) e nessuna regola CORS interna. Questa chiamata elimina le regole esistenti e disabilita CORS per il servizio file.

Se si specifica l'elemento CorsRule, tutti gli elementi delle regole CORS sono obbligatori. La richiesta ha esito negativo con il codice di errore 400 (richiesta non valida) se manca un elemento.

Per altre informazioni sulle regole CORS e sulla logica di valutazione, vedere Supporto per la condivisione delle risorse tra origini per i servizi di archiviazione di Azure.

Richiesta di esempio e risposta

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

PUT 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

La richiesta viene inviata con il corpo XML seguente:

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

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

HTTP/1.1 202 Accepted  
Connection: Keep-Alive  
Transfer-Encoding: chunked  
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

Vedi anche

Per altre informazioni sulle regole CORS e sulla logica di valutazione, vedere Supporto per la condivisione delle risorse tra origini per i servizi di archiviazione di Azure.

Per altre informazioni sulle Analisi archiviazione, vedere Analisi archiviazione.