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 |
---|---|---|---|---|
account
|
path | True |
string minLength: 3maxLength: 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. |
File
|
path | True |
Nombre del servicio de archivos dentro de la cuenta de almacenamiento especificada. El nombre del servicio de archivos debe ser "predeterminado" |
|
resource
|
path | True |
string minLength: 1maxLength: 90 pattern: ^[-\w\._\(\)]+$ |
Nombre del grupo de recursos dentro de la suscripción del usuario. El nombre distingue mayúsculas de minúsculas. |
subscription
|
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 |
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 |
Configuración del protocolo para el servicio de archivos |
|
properties.shareDeleteRetentionPolicy |
Propiedades del servicio de archivos para la eliminación temporal del recurso compartido. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Aceptar: establece las propiedades del servicio File de una cuenta de almacenamiento correctamente. |
|
Other Status Codes |
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
Put |
Put |
Put |
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 |
---|---|
Allowed |
Obligatorio si el elemento CorsRule está presente. Lista de métodos HTTP que el origen permite ejecutar. |
Cloud |
Respuesta de error del servicio Storage. |
Cloud |
Respuesta de error del servicio Storage. |
Cors |
Especifica una regla de CORS para Blob service. |
Cors |
Establece las reglas de CORS. Puede incluir hasta cinco elementos CorsRule en la solicitud. |
Delete |
Propiedades del servicio para la eliminación temporal. |
File |
Propiedades de servicios de archivos en la cuenta de almacenamiento. |
File |
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. |
Protocol |
Configuración del protocolo para el servicio de archivos |
Sku |
SKU de la cuenta de almacenamiento. |
Sku |
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. |
Sku |
Nivel de SKU. Esto se basa en el nombre de la SKU. |
Smb |
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 |
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 |
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 |
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 |
Cors |
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: 1maximum: 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 |
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 |
Configuración del protocolo para el servicio de archivos |
|
properties.shareDeleteRetentionPolicy |
Propiedades del servicio de archivos para la eliminación temporal del recurso compartido. |
|
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 |
Configuración del protocolo SMB |
Sku
SKU de la cuenta de almacenamiento.
Nombre | Tipo | Description |
---|---|---|
name |
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 |
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 |
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 ';'. |