File Services - Set Service Properties
Définit les propriétés des services de fichiers dans les comptes de stockage, y compris les règles CORS (Cross-Origin Resource Sharing).
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default?api-version=2023-01-01
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
account
|
path | True |
string |
Nom du compte de stockage dans le groupe de ressources spécifié. Ce nom doit comprendre entre 3 et 24 caractères, uniquement des lettres en minuscules et des nombres. Regex pattern: |
File
|
path | True |
Nom du service de fichiers dans le compte de stockage spécifié. Le nom du service de fichiers doit être « default » |
|
resource
|
path | True |
string |
Nom du groupe de ressources dans l’abonnement de l’utilisateur. Le nom ne respecte pas la casse. Regex pattern: |
subscription
|
path | True |
string |
ID de l’abonnement cible. |
api-version
|
query | True |
string |
Version de l’API à utiliser pour cette opération. |
Corps de la demande
Nom | Type | Description |
---|---|---|
properties.cors |
Spécifie les règles CORS pour le service De fichiers. Incluez jusqu'à cinq éléments CorsRule dans la requête. Si aucun élément CorsRule n’est inclus dans le corps de la demande, toutes les règles CORS sont supprimées et CORS est désactivée pour le service De fichiers. |
|
properties.protocolSettings |
Paramètres de protocole pour le service de fichiers |
|
properties.shareDeleteRetentionPolicy |
Propriétés du service de fichiers pour la suppression réversible de partage. |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
OK : définit les propriétés du service de fichiers d’un compte de stockage. |
|
Other Status Codes |
Réponse d’erreur décrivant la raison de l’échec de l’opération. |
Sécurité
azure_auth
Flux OAuth2 Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nom | Description |
---|---|
user_impersonation | Emprunter l’identité de votre compte d’utilisateur |
Exemples
Put |
Put |
Put |
PutFileServices
Sample Request
PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/fileServices/default?api-version=2023-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*"
]
}
]
}
}
}
Sample Response
{
"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
Sample Request
PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/fileServices/default?api-version=2023-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"
}
}
}
}
Sample Response
{
"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
Sample Request
PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/fileServices/default?api-version=2023-01-01
{
"properties": {
"protocolSettings": {
"smb": {
"multichannel": {
"enabled": true
}
}
}
}
}
Sample Response
{
"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"
}
}
Définitions
Nom | Description |
---|---|
Allowed |
Obligatoire si l'élément CorsRule est présent. Liste des méthodes HTTP autorisées à être exécutées par l’origine. |
Cloud |
Réponse d’erreur du service de stockage. |
Cloud |
Réponse d’erreur du service de stockage. |
Cors |
Spécifie une règle CORS pour le service BLOB. |
Cors |
Définit les règles CORS. Incluez jusqu'à cinq éléments CorsRule dans la requête. |
Delete |
Propriétés du service pour la suppression réversible. |
File |
Propriétés des services de fichiers dans le compte de stockage. |
File |
Nom du service de fichiers dans le compte de stockage spécifié. Le nom du service de fichiers doit être « default » |
Multichannel |
Paramètre multicanal. S’applique uniquement à Premium FileStorage. |
Protocol |
Paramètres de protocole pour le service de fichiers |
Sku |
Référence SKU du compte de stockage. |
Sku |
Le nom du SKU. Requis pour la création de compte ; facultatif pour la mise à jour. Notez que dans les versions antérieures, le nom de la référence SKU était appelé accountType. |
Sku |
Niveau de référence SKU. Cela est basé sur le nom de la référence SKU. |
Smb |
Définition du protocole SMB |
AllowedMethods
Obligatoire si l'élément CorsRule est présent. Liste des méthodes HTTP autorisées à être exécutées par l’origine.
Nom | Type | Description |
---|---|---|
CONNECT |
string |
|
DELETE |
string |
|
GET |
string |
|
HEAD |
string |
|
MERGE |
string |
|
OPTIONS |
string |
|
PATCH |
string |
|
POST |
string |
|
PUT |
string |
|
TRACE |
string |
CloudError
Réponse d’erreur du service de stockage.
Nom | Type | Description |
---|---|---|
error |
Réponse d’erreur du service de stockage. |
CloudErrorBody
Réponse d’erreur du service de stockage.
Nom | Type | Description |
---|---|---|
code |
string |
Identificateur de l'erreur. Les codes sont invariants et sont destinés à être consommés par programmation. |
details |
Liste des détails supplémentaires sur l’erreur. |
|
message |
string |
Message décrivant l’erreur, destiné à être affiché dans une interface utilisateur. |
target |
string |
Cible de l’erreur particulière. Par exemple, le nom de la propriété dans l’erreur. |
CorsRule
Spécifie une règle CORS pour le service BLOB.
Nom | Type | Description |
---|---|---|
allowedHeaders |
string[] |
Obligatoire si l'élément CorsRule est présent. Liste des en-têtes autorisés à faire partie de la demande cross-origin. |
allowedMethods |
Obligatoire si l'élément CorsRule est présent. Liste des méthodes HTTP autorisées à être exécutées par l’origine. |
|
allowedOrigins |
string[] |
Obligatoire si l'élément CorsRule est présent. Liste des domaines d’origine qui seront autorisés via CORS, ou « * » pour autoriser tous les domaines |
exposedHeaders |
string[] |
Obligatoire si l'élément CorsRule est présent. Liste d’en-têtes de réponse à exposer aux clients CORS. |
maxAgeInSeconds |
integer |
Obligatoire si l'élément CorsRule est présent. Nombre de secondes pendant lesquelles le client/navigateur doit mettre en cache une réponse préliminaire. |
CorsRules
Définit les règles CORS. Incluez jusqu'à cinq éléments CorsRule dans la requête.
Nom | Type | Description |
---|---|---|
corsRules |
Cors |
Liste des règles CORS. Incluez jusqu'à cinq éléments CorsRule dans la requête. |
DeleteRetentionPolicy
Propriétés du service pour la suppression réversible.
Nom | Type | Description |
---|---|---|
allowPermanentDelete |
boolean |
Cette propriété, lorsqu’elle est définie sur true, permet la suppression des versions et instantanés des objets blob supprimés de manière réversible. Cette propriété ne peut pas être utilisée comme stratégie de restauration d’objets blob. Cette propriété s’applique uniquement au service blob et ne s’applique pas aux conteneurs ou aux partages de fichiers. |
days |
integer |
Indique le nombre de jours pendant lesquels l’élément supprimé doit être conservé. La valeur minimale spécifiée peut être 1 et la valeur maximale peut être 365. |
enabled |
boolean |
Indique si DeleteRetentionPolicy est activé. |
FileServiceProperties
Propriétés des services de fichiers dans le compte de stockage.
Nom | Type | Description |
---|---|---|
id |
string |
ID de ressource complet pour la ressource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
nom de la ressource. |
properties.cors |
Spécifie les règles CORS pour le service De fichiers. Incluez jusqu'à cinq éléments CorsRule dans la requête. Si aucun élément CorsRule n’est inclus dans le corps de la demande, toutes les règles CORS sont supprimées et CORS est désactivée pour le service De fichiers. |
|
properties.protocolSettings |
Paramètres de protocole pour le service de fichiers |
|
properties.shareDeleteRetentionPolicy |
Propriétés du service de fichiers pour la suppression réversible de partage. |
|
sku |
Nom et niveau de référence SKU. |
|
type |
string |
Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts » |
FileServicesName
Nom du service de fichiers dans le compte de stockage spécifié. Le nom du service de fichiers doit être « default »
Nom | Type | Description |
---|---|---|
default |
string |
Multichannel
Paramètre multicanal. S’applique uniquement à Premium FileStorage.
Nom | Type | Description |
---|---|---|
enabled |
boolean |
Indique si le multicanal est activé |
ProtocolSettings
Paramètres de protocole pour le service de fichiers
Nom | Type | Description |
---|---|---|
smb |
Définition du protocole SMB |
Sku
Référence SKU du compte de stockage.
Nom | Type | Description |
---|---|---|
name |
Le nom du SKU. Requis pour la création de compte ; facultatif pour la mise à jour. Notez que dans les versions antérieures, le nom de la référence SKU était appelé accountType. |
|
tier |
Niveau de référence SKU. Cela est basé sur le nom de la référence SKU. |
SkuName
Le nom du SKU. Requis pour la création de compte ; facultatif pour la mise à jour. Notez que dans les versions antérieures, le nom de la référence SKU était appelé accountType.
Nom | Type | Description |
---|---|---|
Premium_LRS |
string |
|
Premium_ZRS |
string |
|
Standard_GRS |
string |
|
Standard_GZRS |
string |
|
Standard_LRS |
string |
|
Standard_RAGRS |
string |
|
Standard_RAGZRS |
string |
|
Standard_ZRS |
string |
SkuTier
Niveau de référence SKU. Cela est basé sur le nom de la référence SKU.
Nom | Type | Description |
---|---|---|
Premium |
string |
|
Standard |
string |
SmbSetting
Définition du protocole SMB
Nom | Type | Description |
---|---|---|
authenticationMethods |
string |
Méthodes d’authentification SMB prises en charge par le serveur. Les valeurs valides sont NTLMv2, Kerberos. Doit être passé en tant que chaîne avec le délimiteur ' ;'. |
channelEncryption |
string |
Chiffrement de canal SMB pris en charge par le serveur. Les valeurs valides sont AES-128-CCM, AES-128-GCM, AES-256-GCM. Doit être passé en tant que chaîne avec le délimiteur ' ;'. |
kerberosTicketEncryption |
string |
Chiffrement de ticket Kerberos pris en charge par le serveur. Les valeurs valides sont RC4-HMAC, AES-256. Doit être passé en tant que chaîne avec le délimiteur ' ;' |
multichannel |
Paramètre multicanal. S’applique uniquement à Premium FileStorage. |
|
versions |
string |
Versions du protocole SMB prises en charge par le serveur. Les valeurs valides sont SMB2.1, SMB3.0, SMB3.1.1. Doit être passé en tant que chaîne avec le délimiteur ' ;'. |