Compartir a través de


Obtener las propiedades del servicio de archivos

La Get File Service Properties operación obtiene propiedades para el FileService recurso mediante la API FileREST. Aunque esta API es totalmente compatible, es una API de administración heredada. En su lugar, se recomienda usar Servicios de archivos: Obtener propiedades del servicio, que proporciona el proveedor de recursos de almacenamiento (Microsoft.Storage). Para obtener más información sobre la interacción mediante programación con el FileService recurso mediante el proveedor de recursos de almacenamiento, consulte Operaciones en el recurso FileService.

Disponibilidad del protocolo

Protocolo de recurso compartido de archivos habilitado Disponible
SMB Sí
NFS Sí

Request

La solicitud Get File Service Properties se puede especificar como sigue. Se recomienda usar HTTPS. Reemplace <account-name> por el nombre de la cuenta de almacenamiento:

Método URI de solicitud Versión de HTTP
GET https://<account-name>.file.core.windows.net/?restype=service&comp=properties HTTP/1.1

Nota

El URI siempre debe incluir un carácter de barra diagonal (/) para separar el nombre de host de la ruta de acceso y las partes de consulta del URI. En esta operación, la parte de ruta de acceso del URI está vacía.

Parámetros del identificador URI

Parámetro de URI Descripción
restype=service&comp=properties Necesario. Es necesaria la combinación de ambas cadenas de consulta para establecer las propiedades del servicio de almacenamiento.
timeout Opcional. El parámetro timeout se expresa en segundos. Para obtener más información, consulte Establecimiento de tiempos de espera para las operaciones del servicio de archivos.

Encabezados de solicitud

En la tabla siguiente se describen los encabezados de solicitud requeridos y opcionales.

Encabezado de solicitud Descripción
Authorization Necesario. Especifica el esquema de autorización, el nombre de la cuenta de almacenamiento y la firma. Para obtener más información, vea Autorización de solicitudes a Azure Storage.
Date o x-ms-date Necesario. Especifica la hora universal coordinada (UTC) de la solicitud. Para obtener más información, vea Autorización de solicitudes a Azure Storage.
x-ms-version Necesario para todas las solicitudes autorizadas. Especifica la versión de la operación que se utiliza para esta solicitud. Esta operación solo está disponible en la versión 2015-02-21 y posteriores. Para recuperar las propiedades de métricas del servicio File, debe especificar la versión 2015-04-05 o posterior.

Para obtener más información, vea Versiones de los servicios de Azure Storage.
x-ms-client-request-id Opcional. Proporciona un valor opaco generado por el cliente con un límite de caracteres de 1 kibibyte (KiB) que se registra en los registros de Azure Storage Analytics cuando se configura el registro. Se recomienda encarecidamente usar este encabezado para correlacionar las actividades del lado cliente con las solicitudes que recibe el servidor. Para obtener más información, consulte Supervisión de Azure Files.

Cuerpo de la solicitud

Ninguno.

Response

La respuesta incluye un código de estado HTTP, un conjunto de encabezados de respuesta y un cuerpo de respuesta.

status code

Una operación correcta devuelve el código de estado 200 Correcto.

Encabezados de respuesta

La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir otros encabezados HTTP estándar. Todos los encabezados estándar se ajustan a la especificación del protocolo HTTP/1.1.

Encabezado de respuesta Descripción
x-ms-request-id Identifica de forma única una solicitud que se realiza en el servicio.
x-ms-version Especifica la versión de la operación que se usa para la respuesta. Para obtener más información, vea Versiones de los servicios de Azure Storage.
x-ms-client-request-id Se puede usar para solucionar problemas de solicitudes y sus respuestas correspondientes. El valor de este encabezado es igual al valor del x-ms-client-request-id encabezado si está presente en la solicitud y el valor no contiene más de 1024 caracteres ASCII visibles. Si el x-ms-client-request-id encabezado no está presente en la solicitud, no está presente en la respuesta.

Response body

El formato del cuerpo de la respuesta para la versión 2020-02-10 es el siguiente:

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

Los elementos del cuerpo de respuesta se describen en la tabla siguiente:

Nombre Descripción
HourMetrics Agrupa la configuración de Storage AnalyticsHourMetrics. La HourMetrics configuración proporciona un resumen de las estadísticas de solicitud, agrupadas por API en agregados por hora.
MinuteMetrics Agrupa la configuración de Storage AnalyticsMinuteMetrics. La MinuteMetrics configuración proporciona estadísticas de solicitud para cada minuto.
Version La versión de Storage Analytics que está actualmente en uso.
Enabled Indica si las métricas están habilitadas para el servicio File.
IncludeAPIs Indica si las métricas generan estadísticas de resumen para las operaciones de API a las que se ha llamado.
RetentionPolicy/Enabled Indica si una directiva de retención está habilitada para el servicio de archivos.
RetentionPolicy/Days Indica el número de días durante los que se conservan los datos de métricas. Todos los datos anteriores a este valor se eliminan de la mejor manera posible.
Cors Agrupa todas las reglas de uso compartido de recursos entre orígenes (CORS).
CorsRule Agrupa los valores de una regla de CORS.
AllowedOrigins Lista delimitada por comas de dominios de origen que se permiten mediante CORS, o “*” si se permiten todos los dominios.
ExposedHeaders Lista delimitada por comas de encabezados de respuesta para exponer a los clientes de CORS.
MaxAgeInSeconds Número de segundos que el cliente o explorador debe almacenar en caché una respuesta preparatoria.
AllowedHeaders Lista separada por comas de encabezados que pueden formar parte de la solicitud entre orígenes.
AllowedMethods Lista delimitada por comas de los métodos HTTP que puede ejecutar el origen. Para Azure Files, los métodos permitidos son DELETE, GET, HEAD, MERGE, POST, OPTIONS y PUT.
ShareDeleteRetentionPolicy Las propiedades de eliminación temporal de los recursos compartidos de archivos de Azure en esta cuenta de almacenamiento.
Days Indica el número de días que se debe conservar el recurso compartido de archivos de Azure (eliminado temporalmente). El valor mínimo especificado puede ser 1 y el valor máximo es 365.
Enabled Indica si la cuenta de almacenamiento tiene habilitada la eliminación temporal para Azure Files.
ProtocolSettings Agrupa la configuración de los protocolos del sistema de archivos.
SMB Agrupa la configuración del bloque de mensajes del servidor (SMB).
Multichannel Contiene la configuración de SMB multicanal. Esta configuración tiene una propiedad: habilitada o deshabilitada.
Version Disponible a partir de la versión 2020-04-08. Lista separada por comas de las versiones de SMB permitidas. Valores posibles: SMB2.1, SMB3.0 y SMB3.1.1. Si Version no se especifica, el valor predeterminado es que todas las versiones están habilitadas. Sin embargo, SMB 2.1 solo está disponible si la propiedad de require secure transit la cuenta de almacenamiento está deshabilitada, ya que SMB 2.1 no admite el cifrado.
AuthenticationMethods Disponible a partir de la versión 2020-04-08. Lista separada por comas de métodos de autenticación permitidos. Valores posibles: NTLMv2, Kerberos. Si AuthenticationMethods no se especifica , el valor predeterminado es que se permiten todos los métodos de autenticación.
KerberosTicketEncryption Disponible a partir de la versión 2020-04-08. Lista separada por comas de algoritmos de cifrado de vales Kerberos permitidos. Valores posibles: RC4-HMAC y AES-256. Si KerberosTicketEncryption no se especifica , el valor predeterminado es que se admiten todos los algoritmos de cifrado de vales kerberos.
ChannelEncryption Disponible a partir de la versión 2020-04-08. Lista separada por comas de protocolos de cifrado de canales SMB permitidos. Valores posibles: AES-128-CCM, AES-128-GCM y AES-256-GCM. Si ChannelEncryption no se especifica, el valor predeterminado es que se admiten todos los valores de cifrado de canal. Si la propiedad de la cuenta de require secure transit almacenamiento está deshabilitada, también se permite el acceso SMB sin cifrar.

Authorization

Solo el propietario de la cuenta de almacenamiento puede llamar a esta operación.

Solicitud y respuesta de ejemplo

El siguiente URI de ejemplo realiza una solicitud para obtener las propiedades del servicio de archivos para una cuenta de almacenamiento denominada myaccount:

Método Resolución Protocolo
GET https://myaccount.file.core.windows.net/?restype=service&comp=properties HTTP/1.1

La solicitud se envía con los encabezados siguientes:

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

Una vez enviada la solicitud, se devuelve la respuesta siguiente:

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  

La respuesta incluye el cuerpo XML siguiente.

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

Comentarios

Para obtener información detallada sobre las reglas de CORS y la lógica de evaluación, consulte Compatibilidad de CORS con los servicios de Azure Storage.

Para más información, consulte Storage Analytics.