Задание свойств службы файлов

Операция Set File Service Properties задает свойства ресурса службы файлов с помощью API FileREST. Хотя этот API полностью поддерживается, это устаревший API управления. Вместо этого рекомендуется использовать файловые службы — задать свойства службы, предоставляемые поставщиком ресурсов службы хранилища Azure (Microsoft.Storage). Дополнительные сведения о программном взаимодействии с ресурсом службы файлов с помощью поставщика ресурсов службы хранилища Azure см. в разделе "Операции" в службе файлов.

Доступность протокола

Протокол общей папки с включенным доступом	В наличии
Малый и средний бизнес (SMB)
Сетевая файловая система (NFS)

Просьба

Запрос можно указать Set File Service Properties следующим образом. Рекомендуется использовать ПРОТОКОЛ HTTPS. Замените имя учетной записи именем учетной записи хранения:

Параметры URI

Заголовки запросов

Обязательные и необязательные заголовки запросов описаны в следующей таблице:

Основное содержание запроса

Формат текста запроса для версии 2020-02-10 выглядит следующим образом:

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

Не обязательно указывать каждый корневой элемент запроса. Если опустить корневой элемент, существующие параметры службы для этой функции сохраняются. Однако если указать определенный корневой элемент, необходимо указать каждый дочерний элемент для этого элемента. К корневым элементам относятся:

• HourMetrics
• MinuteMetrics
• Cors
• ProtocolSettings

Элементы текста запроса описаны в следующей таблице:

Ответ

Ответ включает код состояния HTTP и набор заголовков ответа.

Код состояния

Успешная операция возвращает код состояния 202 (принято).

Заголовки ответа

Ответ для этой операции содержит следующие заголовки. Ответ также может включать дополнительные стандартные заголовки HTTP. Все стандартные заголовки соответствуют спецификации протокола HTTP/1.1.

Основная часть ответа

Нет.

Авторизация

Только владелец учетной записи может вызвать эту операцию.

Замечания

Следующие ограничения и ограничения применяются к правилам CORS в файлах Azure.

• Можно хранить не более пяти правил.

• Максимальный размер всех параметров правил CORS для запроса, за исключением XML-тегов, не должен превышать 2 КИБ.

• Длина разрешенного заголовка, доступного заголовка или допустимого источника не должна превышать 256 символов.

• Допустимые заголовки и открытые заголовки могут быть следующими:

  • Заголовки литералов, где указано точное имя заголовка, например x-ms-meta-processed. В запросе можно указать не более 64 заголовков литералов.

  • Префиксированные заголовки, где предоставляется префикс заголовка, например x-ms-meta-data*. Указание префикса таким образом позволяет или предоставляет любой заголовок, начинающийся с этого префикса. В запросе можно указать не более двух префиксных заголовков.

• Методы (или HTTP-команды), указанные в элементе AllowedMethods , должны соответствовать методам, которые поддерживаются API службы хранилища Azure. Поддерживаемые методы: DELETE, GET, HEADMERGE, POST, OPTIONSи PUT.

Указание правил CORS в запросе является необязательным. При вызове Set File Service Properties без указания элемента CORS в тексте запроса сохраняются все существующие правила CORS.

Чтобы отключить CORS, вызовите Set File Service Properties пустой параметр правил CORS (т </Cors>. е. ) и внутренние правила CORS. Этот вызов удаляет все существующие правила и отключает CORS для службы файлов.

Все элементы правила CORS требуются, если CorsRule этот элемент указан. Запрос завершается ошибкой с кодом ошибки 400 (Bad Request), если какой-либо элемент отсутствует.

Дополнительные сведения о правилах CORS и логике оценки см. в статье о поддержке общего доступа к ресурсам между источниками для служб хранилища Azure.

Пример запроса и ответа

В следующем примере URI выполняется запрос на изменение свойств службы файлов для учетной записи хранения с именем myaccount:

PUT https://myaccount.file.core.windows.net/?restype=service&comp=properties HTTP/1.1

Запрос отправляется со следующими заголовками:

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

Запрос отправляется со следующим текстом 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>  

После отправки запроса возвращается следующий ответ:

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  

См. также

Дополнительные сведения о правилах CORS и логике оценки см. в статье о поддержке общего доступа к ресурсам между источниками для служб хранилища Azure.

Дополнительные сведения об аналитике хранилища см. в статье "Аналитика хранилища".