Freigeben über


Microsoft.StorageAccounts/fileServices 2023-01-01

Bicep-Ressourcendefinition

Der Ressourcentyp storageAccounts/fileServices kann mit Vorgängen bereitgestellt werden, die Folgendes zum Ziel haben:

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 Bicep hinzu.

resource symbolicname 'Microsoft.Storage/storageAccounts/fileServices@2023-01-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

Erfahren Sie, wie Sie Namen und Typen für untergeordnete Ressourcen in Bicep festlegen.
"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. FileServicePropertiesProperties

FileServicePropertiesProperties

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 die Freigabe des vorläufigen Löschens. 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 folgendes enthält:
"CONNECT"
'DELETE'
"GET"
"HEAD"
'MERGE'
"OPTIONEN"
"PATCH"
‚POST‘
"PUT"
"TRACE" (erforderlich)
allowedOrigins Erforderlich, wenn das 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 das CorsRule-Element vorhanden ist. Eine Liste von Antwortheadern, die für CORS-Clients verfügbar gemacht werden 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 Vom Server unterstützte SMB-Authentifizierungsmethoden. Gültige Werte sind NTLMv2, Kerberos. Sollte als Zeichenfolge mit 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

Schnellstartvorlagen

Diesen Ressourcentyp werden in den folgenden Schnellstartvorlagen 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 Folgendes zum Ziel haben:

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": "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 Ressourcentyp "Microsoft.Storage/storageAccounts/fileServices"
apiVersion Die Ressourcen-API-Version '2023-01-01'
name Der Ressourcenname

Erfahren Sie, wie Sie Namen und Typen für untergeordnete Ressourcen in JSON-ARM-Vorlagen festlegen.
"Standard"
properties Die Eigenschaften von Dateidiensten im Speicherkonto. FileServicePropertiesProperties

FileServicePropertiesProperties

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 die Freigabe des vorläufigen Löschens. 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 folgendes enthält:
"CONNECT"
'DELETE'
"GET"
"HEAD"
'MERGE'
"OPTIONEN"
"PATCH"
‚POST‘
"PUT"
"TRACE" (erforderlich)
allowedOrigins Erforderlich, wenn das 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 das CorsRule-Element vorhanden ist. Eine Liste von Antwortheadern, die für CORS-Clients verfügbar gemacht werden 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 Vom Server unterstützte SMB-Authentifizierungsmethoden. Gültige Werte sind NTLMv2, Kerberos. Sollte als Zeichenfolge mit 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

Schnellstartvorlagen

Diesen Ressourcentyp werden in den folgenden Schnellstartvorlagen 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 (AzAPI-Anbieter) Ressourcendefinition

Der Ressourcentyp storageAccounts/fileServices kann mit Vorgängen bereitgestellt werden, die Folgendes zum Ziel haben:

  • 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 der Vorlage die folgende Terraform-Ressource hinzu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Storage/storageAccounts/fileServices@2023-01-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 Ressourcentyp "Microsoft.Storage/storageAccounts/fileServices@2023-01-01"
name Der Ressourcenname "default"
parent_id Die ID der Ressource, die die übergeordnete Ressource für diese Ressource ist. ID für Ressource vom Typ: storageAccounts
properties Die Eigenschaften von Dateidiensten im Speicherkonto. FileServicePropertiesProperties

FileServicePropertiesProperties

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 die Freigabe des vorläufigen Löschens. 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 folgendes enthält:
"CONNECT"
„DELETE“
„GET“
„HEAD“
"MERGE"
"OPTIONEN"
„PATCH“
„POST“
„PUT“
"TRACE" (erforderlich)
allowedOrigins Erforderlich, wenn das 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 das CorsRule-Element vorhanden ist. Eine Liste von Antwortheadern, die für CORS-Clients verfügbar gemacht werden 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