File Services - Set Service Properties
Legt die Eigenschaften von Dateidiensten in Speicherkonten fest, einschließlich CORS-Regeln (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
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
account
|
path | True |
string |
Der Name des Speicherkontos innerhalb der angegebenen Ressourcengruppe. Speicherkontonamen müssen zwischen 3 und 24 Zeichen lang sein und dürfen nur Zahlen und Kleinbuchstaben enthalten. Regex pattern: |
File
|
path | True |
Der Name der Datei Dienst innerhalb des angegebenen Speicherkontos. Dateidienstname muss "Standard" sein |
|
resource
|
path | True |
string |
Der Name der Ressourcengruppe im Abonnement des Benutzers. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet. Regex pattern: |
subscription
|
path | True |
string |
Hierbei handelt es sich um die ID des Zielabonnements. |
api-version
|
query | True |
string |
Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version. |
Anforderungstext
Name | Typ | Beschreibung |
---|---|---|
properties.cors |
Gibt CORS-Regeln für den Dateidienst an. Sie können bis zu fünf CorsRule-Elemente in die Anforderung einschließen. Wenn keine CorsRule-Elemente im Anforderungstext enthalten sind, werden alle CORS-Regeln gelöscht, und CORS wird für den Dateidienst deaktiviert. |
|
properties.protocolSettings |
Protokolleinstellungen für den Dateidienst |
|
properties.shareDeleteRetentionPolicy |
Die Dateidiensteigenschaften für die Freigabe des vorläufigen Löschens. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
OK : Legt die Eigenschaften des Dateidiensts eines Speicherkontos erfolgreich fest. |
|
Other Status Codes |
Fehlerantwort mit Beschreibung des Grunds für den Fehler. |
Sicherheit
azure_auth
Azure Active Directory-OAuth2-Flow
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Beschreibung |
---|---|
user_impersonation | Identitätswechsel Ihres Benutzerkontos |
Beispiele
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"
}
}
Definitionen
Name | Beschreibung |
---|---|
Allowed |
Erforderlich, wenn das CorsRule-Element vorhanden ist. Eine Liste der HTTP-Methoden, die vom Ursprung ausgeführt werden dürfen. |
Cloud |
Eine Fehlerantwort des Speicherdiensts. |
Cloud |
Eine Fehlerantwort des Speicherdiensts. |
Cors |
Gibt eine CORS-Regel für den Blob-Dienst an. |
Cors |
Legt die CORS-Regeln fest. Sie können bis zu fünf CorsRule-Elemente in die Anforderung einschließen. |
Delete |
Die Diensteigenschaften für vorläufiges Löschen. |
File |
Die Eigenschaften von Dateidiensten im Speicherkonto. |
File |
Der Name der Datei Dienst innerhalb des angegebenen Speicherkontos. Dateidienstname muss "Standard" sein |
Multichannel |
Multichannel-Einstellung. Gilt nur für Premium FileStorage. |
Protocol |
Protokolleinstellungen für den Dateidienst |
Sku |
Die SKU des Speicherkontos. |
Sku |
Der SKU-Name. Erforderlich für die Kontoerstellung; optional für das Update. Beachten Sie, dass in älteren Versionen der SKU-Name accountType genannt wurde. |
Sku |
Die SKU-Ebene. Dies basiert auf dem SKU-Namen. |
Smb |
Einstellung für das SMB-Protokoll |
AllowedMethods
Erforderlich, wenn das CorsRule-Element vorhanden ist. Eine Liste der HTTP-Methoden, die vom Ursprung ausgeführt werden dürfen.
Name | Typ | Beschreibung |
---|---|---|
CONNECT |
string |
|
DELETE |
string |
|
GET |
string |
|
HEAD |
string |
|
MERGE |
string |
|
OPTIONS |
string |
|
PATCH |
string |
|
POST |
string |
|
PUT |
string |
|
TRACE |
string |
CloudError
Eine Fehlerantwort des Speicherdiensts.
Name | Typ | Beschreibung |
---|---|---|
error |
Eine Fehlerantwort des Speicherdiensts. |
CloudErrorBody
Eine Fehlerantwort des Speicherdiensts.
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollten programmgesteuert verwendet werden. |
details |
Eine Liste mit zusätzlichen Details zum Fehler. |
|
message |
string |
Eine Meldung, die den Fehler beschreibt, der für die Anzeige in einer Benutzeroberfläche geeignet sein soll. |
target |
string |
Das Ziel des jeweiligen Fehlers. Beispiel: Der Name der -Eigenschaft im Fehler. |
CorsRule
Gibt eine CORS-Regel für den Blob-Dienst an.
Name | Typ | Beschreibung |
---|---|---|
allowedHeaders |
string[] |
Erforderlich, wenn das CorsRule-Element vorhanden ist. Eine Liste von Headern, die Teil der ursprungsübergreifenden Anforderung sein dürfen. |
allowedMethods |
Erforderlich, wenn das CorsRule-Element vorhanden ist. Eine Liste der HTTP-Methoden, die vom Ursprung ausgeführt werden dürfen. |
|
allowedOrigins |
string[] |
Erforderlich, wenn das CorsRule-Element vorhanden ist. Eine Liste der Ursprungsdomänen, die über CORS zulässig sind, oder "*", um alle Domänen zuzulassen. |
exposedHeaders |
string[] |
Erforderlich, wenn das CorsRule-Element vorhanden ist. Eine Liste von Antwortheadern, die für CORS-Clients verfügbar gemacht werden sollen. |
maxAgeInSeconds |
integer |
Erforderlich, wenn das CorsRule-Element vorhanden ist. Gibt an, wie viele Sekunden eine Preflight-Antwort vom Client/Browser zwischengespeichert werden soll. |
CorsRules
Legt die CORS-Regeln fest. Sie können bis zu fünf CorsRule-Elemente in die Anforderung einschließen.
Name | Typ | Beschreibung |
---|---|---|
corsRules |
Cors |
Die Liste der CORS-Regeln. Sie können bis zu fünf CorsRule-Elemente in die Anforderung einschließen. |
DeleteRetentionPolicy
Die Diensteigenschaften für vorläufiges Löschen.
Name | Typ | Beschreibung |
---|---|---|
allowPermanentDelete |
boolean |
Diese Eigenschaft, wenn sie auf true festgelegt ist, ermöglicht das Löschen der vorläufig gelöschten Blobversionen und Momentaufnahmen. Diese Eigenschaft kann nicht für die Blobwiederherstellung verwendet werden. Diese Eigenschaft gilt nur für den Blobdienst und gilt nicht für Container oder Dateifreigaben. |
days |
integer |
Gibt die Anzahl der Tage an, in denen das gelöschte Element beibehalten werden soll. Der angegebene Mindestwert kann 1 und der Maximalwert 365 sein. |
enabled |
boolean |
Gibt an, ob DeleteRetentionPolicy aktiviert ist. |
FileServiceProperties
Die Eigenschaften von Dateidiensten im Speicherkonto.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Der Name der Ressource |
properties.cors |
Gibt CORS-Regeln für den Dateidienst an. Sie können bis zu fünf CorsRule-Elemente in die Anforderung einschließen. Wenn keine CorsRule-Elemente im Anforderungstext enthalten sind, werden alle CORS-Regeln gelöscht, und CORS wird für den Dateidienst deaktiviert. |
|
properties.protocolSettings |
Protokolleinstellungen für den Dateidienst |
|
properties.shareDeleteRetentionPolicy |
Die Dateidiensteigenschaften für die Freigabe des vorläufigen Löschens. |
|
sku |
SKU-Name und -Ebene. |
|
type |
string |
Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts" |
FileServicesName
Der Name der Datei Dienst innerhalb des angegebenen Speicherkontos. Dateidienstname muss "Standard" sein
Name | Typ | Beschreibung |
---|---|---|
default |
string |
Multichannel
Multichannel-Einstellung. Gilt nur für Premium FileStorage.
Name | Typ | Beschreibung |
---|---|---|
enabled |
boolean |
Gibt an, ob Multichannel aktiviert ist |
ProtocolSettings
Protokolleinstellungen für den Dateidienst
Name | Typ | Beschreibung |
---|---|---|
smb |
Einstellung für das SMB-Protokoll |
Sku
Die SKU des Speicherkontos.
Name | Typ | Beschreibung |
---|---|---|
name |
Der SKU-Name. Erforderlich für die Kontoerstellung; optional für das Update. Beachten Sie, dass in älteren Versionen der SKU-Name accountType genannt wurde. |
|
tier |
Die SKU-Ebene. Dies basiert auf dem SKU-Namen. |
SkuName
Der SKU-Name. Erforderlich für die Kontoerstellung; optional für das Update. Beachten Sie, dass in älteren Versionen der SKU-Name accountType genannt wurde.
Name | Typ | Beschreibung |
---|---|---|
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
Die SKU-Ebene. Dies basiert auf dem SKU-Namen.
Name | Typ | Beschreibung |
---|---|---|
Premium |
string |
|
Standard |
string |
SmbSetting
Einstellung für das SMB-Protokoll
Name | Typ | Beschreibung |
---|---|---|
authenticationMethods |
string |
Vom Server unterstützte SMB-Authentifizierungsmethoden. Gültige Werte sind NTLMv2, Kerberos. Sollte als Zeichenfolge mit Trennzeichen ";" übergeben werden. |
channelEncryption |
string |
Vom Server unterstützte SMB-Kanalverschlüsselung. Gültige Werte sind AES-128-CCM, AES-128-GCM, AES-256-GCM. Sollte als Zeichenfolge mit Trennzeichen ";" übergeben werden. |
kerberosTicketEncryption |
string |
Vom Server unterstützte Kerberos-Ticketverschlüsselung. Gültige Werte sind RC4-HMAC, AES-256. Sollte als Zeichenfolge mit Trennzeichen ";" übergeben werden. |
multichannel |
Multichannel-Einstellung. Gilt nur für Premium FileStorage. |
|
versions |
string |
Vom Server unterstützte SMB-Protokollversionen. Gültige Werte sind SMB2.1, SMB3.0, SMB3.1.1. Sollte als Zeichenfolge mit Trennzeichen ";" übergeben werden. |