Freigeben über


Microsoft.Storage storageAccounts/fileServices 2022-09-01

Bicep-Ressourcendefinition

Der Ressourcentyp storageAccounts/fileServices kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie im Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.Storage/storageAccounts/fileServices-Ressource zu erstellen, fügen Sie der Vorlage den folgenden Bicep hinzu.

resource symbolicname 'Microsoft.Storage/storageAccounts/fileServices@2022-09-01' = {
  name: 'default'
  parent: resourceSymbolicName
  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

storageAccounts/fileServices

Name BESCHREIBUNG Wert
name Der Ressourcenname

Weitere Informationen finden Sie unter Festlegen von Namen und Typen für untergeordnete Ressourcen in Bicep.
"Standard"
parent 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 vom Typ: storageAccounts
properties Die Eigenschaften von Dateidiensten im Speicherkonto. FileServicePropertiesPropertiesProperties

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 einschließen. 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 von Freigaben. DeleteRetentionPolicy

CorsRules

Name BESCHREIBUNG Wert
corsRules Die Liste der CORS-Regeln. Sie können bis zu fünf CorsRule-Elemente in die Anforderung einschließen. CorsRule[]

CorsRule

Name BESCHREIBUNG Wert
allowedHeaders Erforderlich, wenn das CorsRule-Element vorhanden ist. Eine Liste von Headern, die Teil der ursprungsübergreifenden Anforderung sein dürfen. string[] (erforderlich)
allowedMethods Erforderlich, wenn das CorsRule-Element vorhanden ist. Eine Liste der HTTP-Methoden, die vom Ursprung ausgeführt werden dürfen. Zeichenfolgenarray, das eines der folgenden Elemente enthält:
"DELETE"
"GET"
"HEAD"
'MERGE'
"OPTIONEN"
"PATCH"
‚POST‘
"PUT" (erforderlich)
allowedOrigins Erforderlich, wenn das CorsRule-Element vorhanden ist. Eine Liste der Ursprungsdomänen, die über CORS oder "*" zugelassen werden, um alle Domänen zuzulassen. string[] (erforderlich)
exposedHeaders Erforderlich, wenn das CorsRule-Element vorhanden ist. Eine Liste der Antwortheader, die CORS-Clients zur Verfügung stellen sollen. string[] (erforderlich)
maxAgeInSeconds Erforderlich, wenn das CorsRule-Element vorhanden ist. Gibt an, wie viele Sekunden eine Preflight-Antwort vom Client/Browser zwischengespeichert werden soll. int (erforderlich)

ProtocolSettings

Name BESCHREIBUNG Wert
smb Einstellung für das SMB-Protokoll SmbSetting

SmbSetting

Name BESCHREIBUNG Wert
authenticationMethods SMB-Authentifizierungsmethoden, die vom Server unterstützt werden. Gültige Werte sind NTLMv2, Kerberos. Sollte als Zeichenfolge mit dem Trennzeichen ";" übergeben werden. Zeichenfolge
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 dem Trennzeichen ";" übergeben werden. Zeichenfolge
kerberosTicketEncryption Vom Server unterstützte Kerberos-Ticketverschlüsselung. Gültige Werte sind RC4-HMAC, AES-256. Sollte als Zeichenfolge mit dem Trennzeichen ";" übergeben werden. Zeichenfolge
Mehrkanal Multichannel-Einstellung. Gilt nur für Premium FileStorage. Multichannel
versions Vom Server unterstützte SMB-Protokollversionen. Gültige Werte sind SMB2.1, SMB3.0, SMB3.1.1. Sollte als Zeichenfolge mit dem Trennzeichen ";" übergeben werden. Zeichenfolge

Multichannel

Name BESCHREIBUNG Wert
enabled Gibt an, ob Multichannel aktiviert ist. bool

DeleteRetentionPolicy

Name BESCHREIBUNG Wert
allowPermanentDelete 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. bool
days Gibt die Anzahl der Tage an, für die das gelöschte Element aufbewahrt werden soll. Der angegebene Mindestwert kann 1 und der höchstwert 365 sein. INT

Einschränkungen:
Minimaler Wert = 1
Maximaler Wert = 365
enabled Gibt an, ob DeleteRetentionPolicy aktiviert ist. bool

Schnellstartvorlagen

In den folgenden Schnellstartvorlagen wird dieser Ressourcentyp bereitgestellt.

Vorlage BESCHREIBUNG
Azure Cloud Shell– VNET-Speicher

Bereitstellen in Azure
Diese Vorlage stellt Azure Cloud Shell Storage in einem virtuellen Azure-Netzwerk bereit.

Ressourcendefinition mit einer ARM-Vorlage

Der Ressourcentyp storageAccounts/fileServices kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie im Änderungsprotokoll.

Ressourcenformat

Um eine Ressource "Microsoft.Storage/storageAccounts/fileServices" zu erstellen, fügen Sie Ihrer Vorlage den folgenden JSON-Code hinzu.

{
  "type": "Microsoft.Storage/storageAccounts/fileServices",
  "apiVersion": "2022-09-01",
  "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

storageAccounts/fileServices

Name BESCHREIBUNG Wert
type Der Ressourcentyp "Microsoft.Storage/storageAccounts/fileServices"
apiVersion Die Version der Ressourcen-API '2022-09-01'
name Der Ressourcenname

Weitere Informationen finden Sie unter Festlegen von Namen und Typen für untergeordnete Ressourcen in JSON-ARM-Vorlagen.
"Standard"
properties Die Eigenschaften von Dateidiensten im Speicherkonto. FileServicePropertiesPropertiesProperties

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 einschließen. 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 von Freigaben. DeleteRetentionPolicy

CorsRules

Name BESCHREIBUNG Wert
corsRules Die Liste der CORS-Regeln. Sie können bis zu fünf CorsRule-Elemente in die Anforderung einschließen. CorsRule[]

CorsRule

Name BESCHREIBUNG Wert
allowedHeaders Erforderlich, wenn das CorsRule-Element vorhanden ist. Eine Liste von Headern, die Teil der ursprungsübergreifenden Anforderung sein dürfen. string[] (erforderlich)
allowedMethods Erforderlich, wenn das CorsRule-Element vorhanden ist. Eine Liste der HTTP-Methoden, die vom Ursprung ausgeführt werden dürfen. Zeichenfolgenarray, das eines der folgenden Elemente enthält:
"DELETE"
"GET"
"HEAD"
'MERGE'
"OPTIONEN"
"PATCH"
‚POST‘
"PUT" (erforderlich)
allowedOrigins Erforderlich, wenn das CorsRule-Element vorhanden ist. Eine Liste der Ursprungsdomänen, die über CORS oder "*" zugelassen werden, um alle Domänen zuzulassen. string[] (erforderlich)
exposedHeaders Erforderlich, wenn das CorsRule-Element vorhanden ist. Eine Liste der Antwortheader, die CORS-Clients zur Verfügung stellen sollen. string[] (erforderlich)
maxAgeInSeconds Erforderlich, wenn das CorsRule-Element vorhanden ist. Gibt an, wie viele Sekunden eine Preflight-Antwort vom Client/Browser zwischengespeichert werden soll. int (erforderlich)

ProtocolSettings

Name BESCHREIBUNG Wert
smb Einstellung für das SMB-Protokoll SmbSetting

SmbSetting

Name BESCHREIBUNG Wert
authenticationMethods SMB-Authentifizierungsmethoden, die vom Server unterstützt werden. Gültige Werte sind NTLMv2, Kerberos. Sollte als Zeichenfolge mit dem Trennzeichen ";" übergeben werden. Zeichenfolge
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 dem Trennzeichen ";" übergeben werden. Zeichenfolge
kerberosTicketEncryption Vom Server unterstützte Kerberos-Ticketverschlüsselung. Gültige Werte sind RC4-HMAC, AES-256. Sollte als Zeichenfolge mit dem Trennzeichen ";" übergeben werden. Zeichenfolge
Mehrkanal Multichannel-Einstellung. Gilt nur für Premium FileStorage. Multichannel
versions Vom Server unterstützte SMB-Protokollversionen. Gültige Werte sind SMB2.1, SMB3.0, SMB3.1.1. Sollte als Zeichenfolge mit dem Trennzeichen ";" übergeben werden. Zeichenfolge

Multichannel

Name BESCHREIBUNG Wert
enabled Gibt an, ob Multichannel aktiviert ist. bool

DeleteRetentionPolicy

Name BESCHREIBUNG Wert
allowPermanentDelete 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. bool
days Gibt die Anzahl der Tage an, für die das gelöschte Element aufbewahrt werden soll. Der angegebene Mindestwert kann 1 und der höchstwert 365 sein. INT

Einschränkungen:
Minimaler Wert = 1
Maximaler Wert = 365
enabled Gibt an, ob DeleteRetentionPolicy aktiviert ist. bool

Schnellstartvorlagen

In den folgenden Schnellstartvorlagen wird dieser Ressourcentyp bereitgestellt.

Vorlage BESCHREIBUNG
Azure Cloud Shell– VNET-Speicher

Bereitstellen in Azure
Diese Vorlage stellt Azure Cloud Shell Storage 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 im Änderungsprotokoll.

Ressourcenformat

Um eine Ressource "Microsoft.Storage/storageAccounts/fileServices" zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform-Ressource hinzu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Storage/storageAccounts/fileServices@2022-09-01"
  name = "default"
  parent_id = "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

storageAccounts/fileServices

Name BESCHREIBUNG Wert
type Der Ressourcentyp "Microsoft.Storage/storageAccounts/fileServices@2022-09-01"
name Der Ressourcenname "default"
parent_id Die ID der Ressource, die das übergeordnete Element für diese Ressource ist. ID für Ressource vom Typ: storageAccounts
properties Die Eigenschaften von Dateidiensten im Speicherkonto. FileServicePropertiesPropertiesProperties

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 einschließen. 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 von Freigaben. DeleteRetentionPolicy

CorsRules

Name BESCHREIBUNG Wert
corsRules Die Liste der CORS-Regeln. Sie können bis zu fünf CorsRule-Elemente in die Anforderung einschließen. CorsRule[]

CorsRule

Name BESCHREIBUNG Wert
allowedHeaders Erforderlich, wenn das CorsRule-Element vorhanden ist. Eine Liste von Headern, die Teil der ursprungsübergreifenden Anforderung sein dürfen. string[] (erforderlich)
allowedMethods Erforderlich, wenn das CorsRule-Element vorhanden ist. Eine Liste der HTTP-Methoden, die vom Ursprung ausgeführt werden dürfen. Zeichenfolgenarray, das eines der folgenden Elemente enthält:
„DELETE“
„GET“
„HEAD“
"MERGE"
"OPTIONEN"
„PATCH“
„POST“
"PUT" (erforderlich)
allowedOrigins Erforderlich, wenn das CorsRule-Element vorhanden ist. Eine Liste der Ursprungsdomänen, die über CORS oder "*" zugelassen werden, um alle Domänen zuzulassen. string[] (erforderlich)
exposedHeaders Erforderlich, wenn das CorsRule-Element vorhanden ist. Eine Liste der Antwortheader, die CORS-Clients zur Verfügung stellen sollen. string[] (erforderlich)
maxAgeInSeconds Erforderlich, wenn das CorsRule-Element vorhanden ist. Gibt an, wie viele Sekunden eine Preflight-Antwort vom Client/Browser zwischengespeichert werden soll. int (erforderlich)

ProtocolSettings

Name BESCHREIBUNG Wert
smb Einstellung für das SMB-Protokoll SmbSetting

SmbSetting

Name BESCHREIBUNG Wert
authenticationMethods SMB-Authentifizierungsmethoden, die vom Server unterstützt werden. Gültige Werte sind NTLMv2, Kerberos. Sollte als Zeichenfolge mit dem Trennzeichen ";" übergeben werden. Zeichenfolge
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. Zeichenfolge
kerberosTicketEncryption Vom Server unterstützte Kerberos-Ticketverschlüsselung. Gültige Werte sind RC4-HMAC, AES-256. Sollte als Zeichenfolge mit Trennzeichen ";" übergeben werden. Zeichenfolge
Mehrkanal Multichannel-Einstellung. Gilt nur für Premium FileStorage. Multichannel
versions Vom Server unterstützte SMB-Protokollversionen. Gültige Werte sind SMB2.1, SMB3.0, SMB3.1.1. Sollte als Zeichenfolge mit Trennzeichen ";" übergeben werden. Zeichenfolge

Multichannel

Name BESCHREIBUNG Wert
enabled Gibt an, ob Multichannel aktiviert ist bool

DeleteRetentionPolicy

Name BESCHREIBUNG Wert
allowPermanentDelete 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. bool
days 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. INT

Einschränkungen:
Min-Wert = 1
Maximaler Wert = 365
enabled Gibt an, ob DeleteRetentionPolicy aktiviert ist. bool