Microsoft.StorageAccounts/fileServices 2023-01-01
Bicep-Ressourcendefinition
Der Ressourcentyp "storageAccounts/fileServices" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
- Ressourcengruppen – Siehe Ressourcengruppenbereitstellungsbefehle
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.Storage/storageAccounts/fileServices-Ressource zu erstellen, fügen Sie ihrer Vorlage die folgende Bicep hinzu.
resource symbolicname 'Microsoft.Storage/storageAccounts/fileServices@2023-01-01' = {
parent: resourceSymbolicName
name: 'default'
properties: {
cors: {
corsRules: [
{
allowedHeaders: [
'string'
]
allowedMethods: [
'string'
]
allowedOrigins: [
'string'
]
exposedHeaders: [
'string'
]
maxAgeInSeconds: int
}
]
}
protocolSettings: {
smb: {
authenticationMethods: 'string'
channelEncryption: 'string'
kerberosTicketEncryption: 'string'
multichannel: {
enabled: bool
}
versions: 'string'
}
}
shareDeleteRetentionPolicy: {
allowPermanentDelete: bool
days: int
enabled: bool
}
}
}
Eigenschaftswerte
CorsRule
| Name | Beschreibung | Wert |
|---|---|---|
| allowedHeaders | Erforderlich, wenn corsRule-Element vorhanden ist. Eine Liste der Kopfzeilen, die Teil der ursprungsübergreifenden Anforderung sein dürfen. | string[] (erforderlich) |
| allowedMethods | Erforderlich, wenn corsRule-Element vorhanden ist. Eine Liste der HTTP-Methoden, die vom Ursprung ausgeführt werden dürfen. | Zeichenfolgenarray, das eine der folgenden Elemente enthält: 'CONNECT' "DELETE" 'GET' "HEAD" 'MERGE' 'OPTIONS' "PATCH" 'POST' "PUT" "TRACE" (erforderlich) |
| allowedOrigins | Erforderlich, wenn corsRule-Element vorhanden ist. Eine Liste der Ursprungsdomänen, die über CORS zulässig sind, oder "*", um alle Domänen zuzulassen | string[] (erforderlich) |
| exposedHeaders | Erforderlich, wenn corsRule-Element vorhanden ist. Eine Liste der Antwortheader, die CORS-Clients zur Verfügung stellen sollen. | string[] (erforderlich) |
| maxAgeInSeconds | Erforderlich, wenn corsRule-Element vorhanden ist. Die Anzahl der Sekunden, für die der Client/Browser eine Preflight-Antwort zwischenspeichern soll. | int (erforderlich) |
CorsRules
| Name | Beschreibung | Wert |
|---|---|---|
| corsRules | Die Liste der CORS-Regeln. Sie können bis zu fünf CorsRule-Elemente in die Anforderung aufnehmen. | CorsRule[] |
DeleteRetentionPolicy
| Name | Beschreibung | Wert |
|---|---|---|
| allowPermanentDelete | Diese Eigenschaft, wenn sie auf "true" festgelegt ist, ermöglicht das Löschen der vorläufig gelöschten BLOB-Versionen und Momentaufnahmen. Diese Eigenschaft kann keine Blob-Wiederherstellungsrichtlinie verwenden. Diese Eigenschaft gilt nur für blob-Dienst und gilt nicht für Container oder Dateifreigaben. | Bool |
| Tage | Gibt die Anzahl der Tage an, die das gelöschte Element beibehalten werden soll. Der angegebene Mindestwert kann 1 sein, und der Maximalwert kann 365 sein. | Int Zwänge: Min.-Wert = 1 Max. Wert = 365 |
| ermöglichte | Gibt an, ob DeleteRetentionPolicy aktiviert ist. | Bool |
FileServicePropertiesPropertiesProperties
| Name | Beschreibung | Wert |
|---|---|---|
| Cors | Gibt CORS-Regeln für den Dateidienst an. Sie können bis zu fünf CorsRule-Elemente in die Anforderung aufnehmen. Wenn keine CorsRule-Elemente im Anforderungstext enthalten sind, werden alle CORS-Regeln gelöscht, und CORS wird für den Dateidienst deaktiviert. | CorsRules |
| protocolSettings | Protokolleinstellungen für den Dateidienst | ProtocolSettings- |
| shareDeleteRetentionPolicy | Die Dateidiensteigenschaften für das vorläufige Löschen der Freigabe. | DeleteRetentionPolicy- |
Microsoft.Storage/storageAccounts/fileServices
| Name | Beschreibung | Wert |
|---|---|---|
| Name | Der Ressourcenname | "default" (erforderlich) |
| Elternteil | In Bicep können Sie die übergeordnete Ressource für eine untergeordnete Ressource angeben. Sie müssen diese Eigenschaft nur hinzufügen, wenn die untergeordnete Ressource außerhalb der übergeordneten Ressource deklariert wird. Weitere Informationen finden Sie unter Untergeordnete Ressource außerhalb der übergeordneten Ressource. |
Symbolischer Name für Ressource des Typs: storageAccounts |
| Eigenschaften | Die Eigenschaften von Dateidiensten im Speicherkonto. | FileServicePropertiesProperties |
Mehrfachkanal
| Name | Beschreibung | Wert |
|---|---|---|
| ermöglichte | Gibt an, ob Multichannel aktiviert ist. | Bool |
ProtocolSettings
| Name | Beschreibung | Wert |
|---|---|---|
| smb | Einstellung für das SMB-Protokoll | SmbSetting- |
SmbSetting
| Name | Beschreibung | Wert |
|---|---|---|
| authenticationMethods | Vom Server unterstützte SMB-Authentifizierungsmethoden. Gültige Werte sind NTLMv2, Kerberos. Sollte als Zeichenfolge mit Trennzeichen ';' übergeben werden. | Schnur |
| channelEncryption | 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. | Schnur |
| kerberosTicketEncryption | Kerberos-Ticketverschlüsselung, die vom Server unterstützt wird. Gültige Werte sind RC4-HMAC, AES-256. Sollte als Zeichenfolge mit Trennzeichen ';' übergeben werden. | Schnur |
| Mehrfachkanal | Multichannel-Einstellung. Gilt nur für Premium FileStorage. | Multichannel- |
| Versionen | Vom Server unterstützte SMB-Protokollversionen. Gültige Werte sind SMB2.1, SMB3.0, SMB3.1.1. Sollte als Zeichenfolge mit Trennzeichen ';' übergeben werden. | Schnur |
ARM-Vorlagenressourcendefinition
Der Ressourcentyp "storageAccounts/fileServices" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
- Ressourcengruppen – Siehe Ressourcengruppenbereitstellungsbefehle
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.Storage/storageAccounts/fileServices-Ressource zu erstellen, fügen Sie Der Vorlage den folgenden JSON-Code hinzu.
{
"type": "Microsoft.Storage/storageAccounts/fileServices",
"apiVersion": "2023-01-01",
"name": "string",
"properties": {
"cors": {
"corsRules": [
{
"allowedHeaders": [ "string" ],
"allowedMethods": [ "string" ],
"allowedOrigins": [ "string" ],
"exposedHeaders": [ "string" ],
"maxAgeInSeconds": "int"
}
]
},
"protocolSettings": {
"smb": {
"authenticationMethods": "string",
"channelEncryption": "string",
"kerberosTicketEncryption": "string",
"multichannel": {
"enabled": "bool"
},
"versions": "string"
}
},
"shareDeleteRetentionPolicy": {
"allowPermanentDelete": "bool",
"days": "int",
"enabled": "bool"
}
}
}
Eigenschaftswerte
CorsRule
| Name | Beschreibung | Wert |
|---|---|---|
| allowedHeaders | Erforderlich, wenn corsRule-Element vorhanden ist. Eine Liste der Kopfzeilen, die Teil der ursprungsübergreifenden Anforderung sein dürfen. | string[] (erforderlich) |
| allowedMethods | Erforderlich, wenn corsRule-Element vorhanden ist. Eine Liste der HTTP-Methoden, die vom Ursprung ausgeführt werden dürfen. | Zeichenfolgenarray, das eine der folgenden Elemente enthält: 'CONNECT' "DELETE" 'GET' "HEAD" 'MERGE' 'OPTIONS' "PATCH" 'POST' "PUT" "TRACE" (erforderlich) |
| allowedOrigins | Erforderlich, wenn corsRule-Element vorhanden ist. Eine Liste der Ursprungsdomänen, die über CORS zulässig sind, oder "*", um alle Domänen zuzulassen | string[] (erforderlich) |
| exposedHeaders | Erforderlich, wenn corsRule-Element vorhanden ist. Eine Liste der Antwortheader, die CORS-Clients zur Verfügung stellen sollen. | string[] (erforderlich) |
| maxAgeInSeconds | Erforderlich, wenn corsRule-Element vorhanden ist. Die Anzahl der Sekunden, für die der Client/Browser eine Preflight-Antwort zwischenspeichern soll. | int (erforderlich) |
CorsRules
| Name | Beschreibung | Wert |
|---|---|---|
| corsRules | Die Liste der CORS-Regeln. Sie können bis zu fünf CorsRule-Elemente in die Anforderung aufnehmen. | CorsRule[] |
DeleteRetentionPolicy
| Name | Beschreibung | Wert |
|---|---|---|
| allowPermanentDelete | Diese Eigenschaft, wenn sie auf "true" festgelegt ist, ermöglicht das Löschen der vorläufig gelöschten BLOB-Versionen und Momentaufnahmen. Diese Eigenschaft kann keine Blob-Wiederherstellungsrichtlinie verwenden. Diese Eigenschaft gilt nur für blob-Dienst und gilt nicht für Container oder Dateifreigaben. | Bool |
| Tage | Gibt die Anzahl der Tage an, die das gelöschte Element beibehalten werden soll. Der angegebene Mindestwert kann 1 sein, und der Maximalwert kann 365 sein. | Int Zwänge: Min.-Wert = 1 Max. Wert = 365 |
| ermöglichte | Gibt an, ob DeleteRetentionPolicy aktiviert ist. | Bool |
FileServicePropertiesPropertiesProperties
| Name | Beschreibung | Wert |
|---|---|---|
| Cors | Gibt CORS-Regeln für den Dateidienst an. Sie können bis zu fünf CorsRule-Elemente in die Anforderung aufnehmen. Wenn keine CorsRule-Elemente im Anforderungstext enthalten sind, werden alle CORS-Regeln gelöscht, und CORS wird für den Dateidienst deaktiviert. | CorsRules |
| protocolSettings | Protokolleinstellungen für den Dateidienst | ProtocolSettings- |
| shareDeleteRetentionPolicy | Die Dateidiensteigenschaften für das vorläufige Löschen der Freigabe. | DeleteRetentionPolicy- |
Microsoft.Storage/storageAccounts/fileServices
| Name | Beschreibung | Wert |
|---|---|---|
| apiVersion | Die API-Version | '2023-01-01' |
| Name | Der Ressourcenname | "default" (erforderlich) |
| Eigenschaften | Die Eigenschaften von Dateidiensten im Speicherkonto. | FileServicePropertiesProperties |
| Art | Der Ressourcentyp | "Microsoft.Storage/storageAccounts/fileServices" |
Mehrfachkanal
| Name | Beschreibung | Wert |
|---|---|---|
| ermöglichte | Gibt an, ob Multichannel aktiviert ist. | Bool |
ProtocolSettings
| Name | Beschreibung | Wert |
|---|---|---|
| smb | Einstellung für das SMB-Protokoll | SmbSetting- |
SmbSetting
| Name | Beschreibung | Wert |
|---|---|---|
| authenticationMethods | Vom Server unterstützte SMB-Authentifizierungsmethoden. Gültige Werte sind NTLMv2, Kerberos. Sollte als Zeichenfolge mit Trennzeichen ';' übergeben werden. | Schnur |
| channelEncryption | 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. | Schnur |
| kerberosTicketEncryption | Kerberos-Ticketverschlüsselung, die vom Server unterstützt wird. Gültige Werte sind RC4-HMAC, AES-256. Sollte als Zeichenfolge mit Trennzeichen ';' übergeben werden. | Schnur |
| Mehrfachkanal | Multichannel-Einstellung. Gilt nur für Premium FileStorage. | Multichannel- |
| Versionen | Vom Server unterstützte SMB-Protokollversionen. Gültige Werte sind SMB2.1, SMB3.0, SMB3.1.1. Sollte als Zeichenfolge mit Trennzeichen ';' übergeben werden. | Schnur |
Schnellstartvorlagen
Die folgenden Schnellstartvorlagen stellen diesen Ressourcentyp bereit.
| Schablone | Beschreibung |
|---|---|
Azure Cloud Shell – VNet-Speicher-
|
Diese Vorlage stellt Azure Cloud Shell-Speicher in einem virtuellen Azure-Netzwerk bereit. |
Terraform -Ressourcendefinition (AzAPI-Anbieter)
Der Ressourcentyp "storageAccounts/fileServices" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
- Ressourcengruppen
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.Storage/storageAccounts/fileServices-Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Storage/storageAccounts/fileServices@2023-01-01"
name = "string"
body = jsonencode({
properties = {
cors = {
corsRules = [
{
allowedHeaders = [
"string"
]
allowedMethods = [
"string"
]
allowedOrigins = [
"string"
]
exposedHeaders = [
"string"
]
maxAgeInSeconds = int
}
]
}
protocolSettings = {
smb = {
authenticationMethods = "string"
channelEncryption = "string"
kerberosTicketEncryption = "string"
multichannel = {
enabled = bool
}
versions = "string"
}
}
shareDeleteRetentionPolicy = {
allowPermanentDelete = bool
days = int
enabled = bool
}
}
})
}
Eigenschaftswerte
CorsRule
| Name | Beschreibung | Wert |
|---|---|---|
| allowedHeaders | Erforderlich, wenn corsRule-Element vorhanden ist. Eine Liste der Kopfzeilen, die Teil der ursprungsübergreifenden Anforderung sein dürfen. | string[] (erforderlich) |
| allowedMethods | Erforderlich, wenn corsRule-Element vorhanden ist. Eine Liste der HTTP-Methoden, die vom Ursprung ausgeführt werden dürfen. | Zeichenfolgenarray, das eine der folgenden Elemente enthält: 'CONNECT' "DELETE" 'GET' "HEAD" 'MERGE' 'OPTIONS' "PATCH" 'POST' "PUT" "TRACE" (erforderlich) |
| allowedOrigins | Erforderlich, wenn corsRule-Element vorhanden ist. Eine Liste der Ursprungsdomänen, die über CORS zulässig sind, oder "*", um alle Domänen zuzulassen | string[] (erforderlich) |
| exposedHeaders | Erforderlich, wenn corsRule-Element vorhanden ist. Eine Liste der Antwortheader, die CORS-Clients zur Verfügung stellen sollen. | string[] (erforderlich) |
| maxAgeInSeconds | Erforderlich, wenn corsRule-Element vorhanden ist. Die Anzahl der Sekunden, für die der Client/Browser eine Preflight-Antwort zwischenspeichern soll. | int (erforderlich) |
CorsRules
| Name | Beschreibung | Wert |
|---|---|---|
| corsRules | Die Liste der CORS-Regeln. Sie können bis zu fünf CorsRule-Elemente in die Anforderung aufnehmen. | CorsRule[] |
DeleteRetentionPolicy
| Name | Beschreibung | Wert |
|---|---|---|
| allowPermanentDelete | Diese Eigenschaft, wenn sie auf "true" festgelegt ist, ermöglicht das Löschen der vorläufig gelöschten BLOB-Versionen und Momentaufnahmen. Diese Eigenschaft kann keine Blob-Wiederherstellungsrichtlinie verwenden. Diese Eigenschaft gilt nur für blob-Dienst und gilt nicht für Container oder Dateifreigaben. | Bool |
| Tage | Gibt die Anzahl der Tage an, die das gelöschte Element beibehalten werden soll. Der angegebene Mindestwert kann 1 sein, und der Maximalwert kann 365 sein. | Int Zwänge: Min.-Wert = 1 Max. Wert = 365 |
| ermöglichte | Gibt an, ob DeleteRetentionPolicy aktiviert ist. | Bool |
FileServicePropertiesPropertiesProperties
| Name | Beschreibung | Wert |
|---|---|---|
| Cors | Gibt CORS-Regeln für den Dateidienst an. Sie können bis zu fünf CorsRule-Elemente in die Anforderung aufnehmen. Wenn keine CorsRule-Elemente im Anforderungstext enthalten sind, werden alle CORS-Regeln gelöscht, und CORS wird für den Dateidienst deaktiviert. | CorsRules |
| protocolSettings | Protokolleinstellungen für den Dateidienst | ProtocolSettings- |
| shareDeleteRetentionPolicy | Die Dateidiensteigenschaften für das vorläufige Löschen der Freigabe. | DeleteRetentionPolicy- |
Microsoft.Storage/storageAccounts/fileServices
| Name | Beschreibung | Wert |
|---|---|---|
| Name | Der Ressourcenname | "default" (erforderlich) |
| parent_id | Die ID der Ressource, die das übergeordnete Element für diese Ressource ist. | ID für Ressource des Typs: storageAccounts |
| Eigenschaften | Die Eigenschaften von Dateidiensten im Speicherkonto. | FileServicePropertiesProperties |
| Art | Der Ressourcentyp | "Microsoft.Storage/storageAccounts/fileServices@2023-01-01" |
Mehrfachkanal
| Name | Beschreibung | Wert |
|---|---|---|
| ermöglichte | Gibt an, ob Multichannel aktiviert ist. | Bool |
ProtocolSettings
| Name | Beschreibung | Wert |
|---|---|---|
| smb | Einstellung für das SMB-Protokoll | SmbSetting- |
SmbSetting
| Name | Beschreibung | Wert |
|---|---|---|
| authenticationMethods | Vom Server unterstützte SMB-Authentifizierungsmethoden. Gültige Werte sind NTLMv2, Kerberos. Sollte als Zeichenfolge mit Trennzeichen ';' übergeben werden. | Schnur |
| channelEncryption | 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. | Schnur |
| kerberosTicketEncryption | Kerberos-Ticketverschlüsselung, die vom Server unterstützt wird. Gültige Werte sind RC4-HMAC, AES-256. Sollte als Zeichenfolge mit Trennzeichen ';' übergeben werden. | Schnur |
| Mehrfachkanal | Multichannel-Einstellung. Gilt nur für Premium FileStorage. | Multichannel- |
| Versionen | Vom Server unterstützte SMB-Protokollversionen. Gültige Werte sind SMB2.1, SMB3.0, SMB3.1.1. Sollte als Zeichenfolge mit Trennzeichen ';' übergeben werden. | Schnur |