Set File Service Properties

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
NFS

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:

Parametri URI

Intestazioni della richiesta

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

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:

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.

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.