Obtener propiedades del servicio de archivos

La Get File Service Properties operación obtiene las propiedades del 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 habilitado para recursos compartidos de archivos	Disponible
Pequeñas y Medianas Empresas (PYME)
NFS

Solicitud

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

Método	Solicitud de URI	Versión de HTTP
OBTENER	`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 de URI

Parámetro de URI	Descripción
`restype=service&comp=properties`	Obligatorio. La combinación de ambas cadenas de consulta es necesaria 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 Establecer tiempos de espera para las operaciones del servicio de archivos.

Cabeceras de solicitud

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

Cabecera de solicitud	Descripción
`Authorization`	Obligatorio. Especifica el esquema de autorización, el nombre de la cuenta de almacenamiento y la firma. Para más información, consulte Autorizar solicitudes a Azure Storage.
`Date` o `x-ms-date`	Obligatorio. Especifica la hora universal coordinada (UTC) de la solicitud. Para más información, consulte Autorizar solicitudes a Azure Storage.
`x-ms-version`	Necesario para todas las solicitudes autorizadas. Especifica la versión de la operación que se va a usar para esta solicitud. Esta operación solo está disponible en la versión 2015-02-21 y versiones 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 al configurar 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.

Respuesta

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

Código de estado

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

Encabezados de respuesta

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

Encabezado de respuesta	Descripción
`x-ms-request-id`	Identifica de forma única una solicitud realizada 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 encabezado `x-ms-client-request-id` si está presente en la solicitud y el valor no contiene más de 1024 caracteres ASCII visibles. Si el encabezado `x-ms-client-request-id` no está presente en la solicitud, no está presente en la respuesta.

Cuerpo de respuesta

El formato del cuerpo de respuesta para la versión 2026-02-06 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-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>
            <EncryptionInTransit>
                <Required>true|false</Required>
            </EncryptionInTransit>
        </SMB>
        <NFS>
            <EncryptionInTransit>
                <Required>true|false</Required>
            </EncryptionInTransit>
        </NFS>
    </ProtocolSettings>
</StorageServiceProperties>

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

Nombre	Descripción
`HourMetrics`	Agrupa la configuración de Storage Analytics `HourMetrics` . 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 Analytics `MinuteMetrics` . La `MinuteMetrics` configuración proporciona estadísticas de solicitud para cada minuto.
`Version`	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 llamadas.
`RetentionPolicy/Enabled`	Indica si una directiva de retención está habilitada para el servicio File.
`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`	Configuración de grupos para una regla de CORS.
`AllowedOrigins`	Una lista separada por comas de dominios de origen que se permiten a través de CORS o "*" si se permiten todos los dominios.
`ExposedHeaders`	Una lista separada por comas de encabezados de respuesta que se van a exponer a los clientes CORS.
`MaxAgeInSeconds`	Número de segundos que el cliente o el explorador deben almacenar en caché una respuesta preparatoria.
`AllowedHeaders`	Una lista separada por comas de encabezados que pueden formar parte de la solicitud entre orígenes.
`AllowedMethods`	Lista separada por comas de métodos HTTP que el origen permite ejecutar. Para Azure Files, los métodos permitidos son DELETE, GET, HEAD, MERGE, POST, OPTIONS y PUT.
`ShareDeleteRetentionPolicy`	Propiedades de eliminación temporal para 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.
`Versions`	Disponible a partir de la versión 2020-04-08. Una lista separada por punto y coma 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 punto y coma 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. Una lista separada por punto y coma 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. Una lista separada por punto y coma de algoritmos de cifrado de canal 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.
`NFS`	Disponible desde la versión 2026-02-06. Agrupa los ajustes de NFS.
`EncryptionInTransit`	Disponible desde la versión 2026-02-06. El cifrado SMB y NFS en tránsito contiene la `Required` propiedad booleana, que indica el requisito de cifrado SMB y NFS en tránsito. El cifrado NFS en tránsito está disponible solo para cuentas de almacenamiento premium.

Autorización

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 file para una cuenta de almacenamiento denominada myaccount:

Método	URL	Protocolo
OBTENER	`https://myaccount.file.core.windows.net/?restype=service&comp=properties`	HTTP/1.1

La solicitud se envía con los siguientes encabezados:

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

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

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: 2026-02-06

La respuesta incluye el siguiente cuerpo 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>
            <EncryptionInTransit>
                <Required>true</Required>
            </EncryptionInTransit>
        </SMB>
        <NFS>
            <EncryptionInTransit>
                <Required>true</Required>
            </EncryptionInTransit>
        </NFS>
    </ProtocolSettings>
</StorageServiceProperties>

Observaciones

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.

Last updated on 2025-05-07

Compartir a través de