Compartir a través de


File Services - Set Service Properties

Establece las propiedades de los servicios de archivos en las cuentas de almacenamiento, incluidas las reglas CORS (uso compartido de recursos entre orígenes).

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default?api-version=2024-01-01

Parámetros de identificador URI

Nombre En Requerido Tipo Description
accountName
path True

string

minLength: 3
maxLength: 24
pattern: ^[a-z0-9]+$

Nombre de la cuenta de almacenamiento dentro del grupo de recursos especificado. Los nombres de cuenta de almacenamiento deben tener entre 3 y 24 caracteres de longitud y usar solo números y letras minúsculas.

FileServicesName
path True

FileServicesName

Nombre del servicio de archivos dentro de la cuenta de almacenamiento especificada. El nombre del servicio de archivos debe ser "predeterminado"

resourceGroupName
path True

string

minLength: 1
maxLength: 90
pattern: ^[-\w\._\(\)]+$

Nombre del grupo de recursos dentro de la suscripción del usuario. El nombre distingue mayúsculas de minúsculas.

subscriptionId
path True

string

minLength: 1

Identificador de la suscripción de destino.

api-version
query True

string

minLength: 1

Versión de la API que se va a usar para esta operación.

Cuerpo de la solicitud

Nombre Tipo Description
properties.cors

CorsRules

Especifica reglas CORS para el servicio File. Puede incluir hasta cinco elementos CorsRule en la solicitud. Si no se incluyen elementos CorsRule en el cuerpo de la solicitud, se eliminarán todas las reglas de CORS y CORS se deshabilitará para el servicio file.

properties.protocolSettings

ProtocolSettings

Configuración del protocolo para el servicio de archivos

properties.shareDeleteRetentionPolicy

DeleteRetentionPolicy

Propiedades del servicio de archivos para la eliminación temporal del recurso compartido.

Respuestas

Nombre Tipo Description
200 OK

FileServiceProperties

Aceptar: establece las propiedades del servicio File de una cuenta de almacenamiento correctamente.

Other Status Codes

CloudError

Respuesta de error que describe por qué se produjo un error en la operación.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantar la cuenta de usuario

Ejemplos

PutFileServices
PutFileServices_EnableSecureSmbFeatures
PutFileServices_EnableSMBMultichannel

PutFileServices

Solicitud de ejemplo

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/fileServices/default?api-version=2024-01-01

{
  "properties": {
    "cors": {
      "corsRules": [
        {
          "allowedOrigins": [
            "http://www.contoso.com",
            "http://www.fabrikam.com"
          ],
          "allowedMethods": [
            "GET",
            "HEAD",
            "POST",
            "OPTIONS",
            "MERGE",
            "PUT"
          ],
          "maxAgeInSeconds": 100,
          "exposedHeaders": [
            "x-ms-meta-*"
          ],
          "allowedHeaders": [
            "x-ms-meta-abc",
            "x-ms-meta-data*",
            "x-ms-meta-target*"
          ]
        },
        {
          "allowedOrigins": [
            "*"
          ],
          "allowedMethods": [
            "GET"
          ],
          "maxAgeInSeconds": 2,
          "exposedHeaders": [
            "*"
          ],
          "allowedHeaders": [
            "*"
          ]
        },
        {
          "allowedOrigins": [
            "http://www.abc23.com",
            "https://www.fabrikam.com/*"
          ],
          "allowedMethods": [
            "GET",
            "PUT"
          ],
          "maxAgeInSeconds": 2000,
          "exposedHeaders": [
            "x-ms-meta-abc",
            "x-ms-meta-data*",
            "x-ms-meta-target*"
          ],
          "allowedHeaders": [
            "x-ms-meta-12345675754564*"
          ]
        }
      ]
    }
  }
}

Respuesta de muestra

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/fileServices/default",
  "name": "default",
  "type": "Microsoft.Storage/storageAccounts/fileServices",
  "properties": {
    "cors": {
      "corsRules": [
        {
          "allowedOrigins": [
            "http://www.contoso.com",
            "http://www.fabrikam.com"
          ],
          "allowedMethods": [
            "GET",
            "HEAD",
            "POST",
            "OPTIONS",
            "MERGE",
            "PUT"
          ],
          "maxAgeInSeconds": 100,
          "exposedHeaders": [
            "x-ms-meta-*"
          ],
          "allowedHeaders": [
            "x-ms-meta-abc",
            "x-ms-meta-data*",
            "x-ms-meta-target*"
          ]
        },
        {
          "allowedOrigins": [
            "*"
          ],
          "allowedMethods": [
            "GET"
          ],
          "maxAgeInSeconds": 2,
          "exposedHeaders": [
            "*"
          ],
          "allowedHeaders": [
            "*"
          ]
        },
        {
          "allowedOrigins": [
            "http://www.abc23.com",
            "https://www.fabrikam.com/*"
          ],
          "allowedMethods": [
            "GET",
            "PUT"
          ],
          "maxAgeInSeconds": 2000,
          "exposedHeaders": [
            "x-ms-meta-abc",
            "x-ms-meta-data*",
            "x-ms-meta-target*"
          ],
          "allowedHeaders": [
            "x-ms-meta-12345675754564*"
          ]
        }
      ]
    }
  },
  "sku": {
    "name": "Standard_GRS",
    "tier": "Standard"
  }
}

PutFileServices_EnableSecureSmbFeatures

Solicitud de ejemplo

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/fileServices/default?api-version=2024-01-01

{
  "properties": {
    "protocolSettings": {
      "smb": {
        "versions": "SMB2.1;SMB3.0;SMB3.1.1",
        "authenticationMethods": "NTLMv2;Kerberos",
        "kerberosTicketEncryption": "RC4-HMAC;AES-256",
        "channelEncryption": "AES-128-CCM;AES-128-GCM;AES-256-GCM"
      }
    }
  }
}

Respuesta de muestra

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/fileServices/default",
  "name": "default",
  "type": "Microsoft.Storage/storageAccounts/fileServices",
  "properties": {
    "protocolSettings": {
      "smb": {
        "versions": "SMB2.1;SMB3.0;SMB3.1.1",
        "authenticationMethods": "NTLMv2;Kerberos",
        "kerberosTicketEncryption": "RC4-HMAC;AES-256",
        "channelEncryption": "AES-128-CCM;AES-128-GCM;AES-256-GCM"
      }
    }
  },
  "sku": {
    "name": "Premium_LRS",
    "tier": "Premium"
  }
}

PutFileServices_EnableSMBMultichannel

Solicitud de ejemplo

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/fileServices/default?api-version=2024-01-01

{
  "properties": {
    "protocolSettings": {
      "smb": {
        "multichannel": {
          "enabled": true
        }
      }
    }
  }
}

Respuesta de muestra

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/fileServices/default",
  "name": "default",
  "type": "Microsoft.Storage/storageAccounts/fileServices",
  "properties": {
    "protocolSettings": {
      "smb": {
        "multichannel": {
          "enabled": true
        }
      }
    }
  },
  "sku": {
    "name": "Premium_LRS",
    "tier": "Premium"
  }
}

Definiciones

Nombre Description
AllowedMethods

Obligatorio si el elemento CorsRule está presente. Lista de métodos HTTP que el origen permite ejecutar.

CloudError

Respuesta de error del servicio Storage.

CloudErrorBody

Respuesta de error del servicio Storage.

CorsRule

Especifica una regla de CORS para Blob service.

CorsRules

Establece las reglas de CORS. Puede incluir hasta cinco elementos CorsRule en la solicitud.

DeleteRetentionPolicy

Propiedades del servicio para la eliminación temporal.

FileServiceProperties

Propiedades de servicios de archivos en la cuenta de almacenamiento.

FileServicesName

Nombre del servicio de archivos dentro de la cuenta de almacenamiento especificada. El nombre del servicio de archivos debe ser "predeterminado"

Multichannel

Configuración multicanal. Solo se aplica a FileStorage Premium.

ProtocolSettings

Configuración del protocolo para el servicio de archivos

Sku

SKU de la cuenta de almacenamiento.

SkuName

Nombre de la SKU. Necesario para la creación de cuentas; opcional para la actualización. Tenga en cuenta que en versiones anteriores, el nombre de la SKU se llamó accountType.

SkuTier

Nivel de SKU. Esto se basa en el nombre de la SKU.

SmbSetting

Configuración del protocolo SMB

AllowedMethods

Obligatorio si el elemento CorsRule está presente. Lista de métodos HTTP que el origen permite ejecutar.

Valor Description
DELETE
GET
HEAD
MERGE
POST
OPTIONS
PUT
PATCH
CONNECT
TRACE

CloudError

Respuesta de error del servicio Storage.

Nombre Tipo Description
error

CloudErrorBody

Respuesta de error del servicio Storage.

CloudErrorBody

Respuesta de error del servicio Storage.

Nombre Tipo Description
code

string

Identificador del error. Los códigos son invariables y están diseñados para consumirse mediante programación.

details

CloudErrorBody[]

Lista de detalles adicionales sobre el error.

message

string

Mensaje que describe el error, diseñado para ser adecuado para mostrarse en una interfaz de usuario.

target

string

Destino del error concreto. Por ejemplo, el nombre de la propiedad en error.

CorsRule

Especifica una regla de CORS para Blob service.

Nombre Tipo Description
allowedHeaders

string[]

Obligatorio si el elemento CorsRule está presente. Lista de encabezados que pueden formar parte de la solicitud entre orígenes.

allowedMethods

AllowedMethods[]

Obligatorio si el elemento CorsRule está presente. Lista de métodos HTTP que el origen permite ejecutar.

allowedOrigins

string[]

Obligatorio si el elemento CorsRule está presente. Una lista de dominios de origen que se permitirán a través de CORS o "*" para permitir todos los dominios

exposedHeaders

string[]

Obligatorio si el elemento CorsRule está presente. Lista de encabezados de respuesta que se van a exponer a los clientes CORS.

maxAgeInSeconds

integer

Obligatorio si el elemento CorsRule está presente. Número de segundos que el cliente o explorador debe almacenar en caché una respuesta preparatoria.

CorsRules

Establece las reglas de CORS. Puede incluir hasta cinco elementos CorsRule en la solicitud.

Nombre Tipo Description
corsRules

CorsRule[]

Lista de reglas de CORS. Puede incluir hasta cinco elementos CorsRule en la solicitud.

DeleteRetentionPolicy

Propiedades del servicio para la eliminación temporal.

Nombre Tipo Description
allowPermanentDelete

boolean

Esta propiedad cuando se establece en true permite la eliminación de las versiones y instantáneas del blob eliminado temporalmente. Esta propiedad no se puede usar la directiva de restauración de blobs. Esta propiedad solo se aplica a Blob Service y no se aplica a contenedores o recursos compartidos de archivos.

days

integer

minimum: 1
maximum: 365

Indica el número de días que se debe conservar el elemento eliminado. El valor mínimo especificado puede ser 1 y el valor máximo puede ser 365.

enabled

boolean

Indica si DeleteRetentionPolicy está habilitado.

FileServiceProperties

Propiedades de servicios de archivos en la cuenta de almacenamiento.

Nombre Tipo Description
id

string

Identificador de recurso completo para el recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

Nombre del recurso

properties.cors

CorsRules

Especifica reglas CORS para el servicio File. Puede incluir hasta cinco elementos CorsRule en la solicitud. Si no se incluyen elementos CorsRule en el cuerpo de la solicitud, se eliminarán todas las reglas de CORS y CORS se deshabilitará para el servicio file.

properties.protocolSettings

ProtocolSettings

Configuración del protocolo para el servicio de archivos

properties.shareDeleteRetentionPolicy

DeleteRetentionPolicy

Propiedades del servicio de archivos para la eliminación temporal del recurso compartido.

sku

Sku

Nombre y nivel de SKU.

type

string

Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

FileServicesName

Nombre del servicio de archivos dentro de la cuenta de almacenamiento especificada. El nombre del servicio de archivos debe ser "predeterminado"

Valor Description
default

Multichannel

Configuración multicanal. Solo se aplica a FileStorage Premium.

Nombre Tipo Description
enabled

boolean

Indica si está habilitado multicanal.

ProtocolSettings

Configuración del protocolo para el servicio de archivos

Nombre Tipo Description
smb

SmbSetting

Configuración del protocolo SMB

Sku

SKU de la cuenta de almacenamiento.

Nombre Tipo Description
name

SkuName

Nombre de la SKU. Necesario para la creación de cuentas; opcional para la actualización. Tenga en cuenta que en versiones anteriores, el nombre de la SKU se llamó accountType.

tier

SkuTier

Nivel de SKU. Esto se basa en el nombre de la SKU.

SkuName

Nombre de la SKU. Necesario para la creación de cuentas; opcional para la actualización. Tenga en cuenta que en versiones anteriores, el nombre de la SKU se llamó accountType.

Valor Description
Standard_LRS
Standard_GRS
Standard_RAGRS
Standard_ZRS
Premium_LRS
Premium_ZRS
Standard_GZRS
Standard_RAGZRS
StandardV2_LRS
StandardV2_GRS
StandardV2_ZRS
StandardV2_GZRS
PremiumV2_LRS
PremiumV2_ZRS

SkuTier

Nivel de SKU. Esto se basa en el nombre de la SKU.

Valor Description
Standard
Premium

SmbSetting

Configuración del protocolo SMB

Nombre Tipo Description
authenticationMethods

string

Métodos de autenticación SMB admitidos por el servidor. Los valores válidos son NTLMv2, Kerberos. Debe pasarse como una cadena con el delimitador ';'.

channelEncryption

string

Cifrado de canal SMB compatible con el servidor. Los valores válidos son AES-128-CCM, AES-128-GCM, AES-256-GCM. Debe pasarse como una cadena con el delimitador ';'.

kerberosTicketEncryption

string

Cifrado de vales Kerberos compatible con el servidor. Los valores válidos son RC4-HMAC, AES-256. Debe pasarse como una cadena con el delimitador ';'

multichannel

Multichannel

Configuración multicanal. Solo se aplica a FileStorage Premium.

versions

string

Versiones del protocolo SMB compatibles con el servidor. Los valores válidos son SMB2.1, SMB3.0, SMB3.1.1. Debe pasarse como una cadena con el delimitador ';'.