Microsoft.Storage StorageAccounts/fileServices 2023-04-01

• najnowsze
• 2024-01-01
• 2023-05-01
• 2023-04-01
• 2023-01-01
• 2022-09-01
• 2022-05-01
• 2021-09-01
• 2021-08-01
• 2021-06-01
• 2021-04-01
• 2021-02-01
• 2021-01-01
• 2020-08-01-podgląd
• 2019-06-01
• 2019-04-01

Definicja zasobu Bicep

Typ zasobu storageAccounts/fileServices można wdrożyć przy użyciu operacji docelowych:

• grupy zasobów — zobacz polecenia wdrażania grupy zasobów

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Storage/storageAccounts/fileServices, dodaj następujący kod Bicep do szablonu.

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

Wartości właściwości

Microsoft.Storage/storageAccounts/fileServices

Nazwa	Opis	Wartość
nazwa	Nazwa zasobu	"default" (wymagane)
rodzic	W Bicep można określić zasób nadrzędny dla zasobu podrzędnego. Tę właściwość należy dodać tylko wtedy, gdy zasób podrzędny jest zadeklarowany poza zasobem nadrzędnym. Aby uzyskać więcej informacji, zobacz Zasób podrzędny poza zasobem nadrzędnym.	Nazwa symboliczna zasobu typu: storageAccounts
Właściwości	Właściwości usług plików na koncie magazynu.	FileServicePropertiesPropertiesProperties

CorsRule (Reguła korsa)

Nazwa	Opis	Wartość
allowedHeaders (dozwolone nagłówki)	Wymagane, jeśli element CorsRule jest obecny. Lista nagłówków, które mogą być częścią żądania między źródłami.	string[] (wymagane)
allowedMethods (dozwolone metody)	Wymagane, jeśli element CorsRule jest obecny. Lista metod HTTP, które mogą być wykonywane przez źródło.	Tablica ciągów zawierająca dowolną z: "CONNECT" "DELETE" "GET" "HEAD" "MERGE" "OPCJE" "PATCH" "POST" "PUT" "TRACE" (wymagane)
allowedOrigins (dozwolone źródła)	Wymagane, jeśli element CorsRule jest obecny. Lista domen pochodzenia, które będą dozwolone za pośrednictwem mechanizmu CORS lub "*", aby zezwolić na wszystkie domeny	string[] (wymagane)
Uwidocznione nagłówki	Wymagane, jeśli element CorsRule jest obecny. Lista nagłówków odpowiedzi, które mają być widoczne dla klientów CORS.	string[] (wymagane)
maxAgeInSeconds (maksymalny wiekw sekundach)	Wymagane, jeśli element CorsRule jest obecny. Liczba sekund, przez które klient/przeglądarka powinna buforować odpowiedź wstępną.	int (wymagane)

CorsRules

Nazwa	Opis	Wartość
corsZasady	Lista reguł CORS. W żądaniu można uwzględnić maksymalnie pięć elementów CorsRule.	KorsRządź[]

DeleteRetentionPolicy

Nazwa	Opis	Wartość
allowPermanentDelete (zezwalać) na usunięcie	Ta właściwość po ustawieniu wartości true umożliwia usunięcie nietrwałych wersji obiektów blob i migawek. Tej właściwości nie można używać zasad przywracania obiektów blob. Ta właściwość dotyczy tylko usługi blob i nie ma zastosowania do kontenerów ani udziału plików.	Bool
Dni	Wskazuje liczbę dni przechowywania usuniętego elementu. Minimalna określona wartość może wynosić 1, a maksymalna wartość może wynosić 365.	Int Ograniczenia: Minimalna wartość = 1 Wartość maksymalna = 365
Włączone	Wskazuje, czy opcja DeleteRetentionPolicy jest włączona.	Bool

FileServicePropertiesPropertiesProperties

Nazwa	Opis	Wartość
CORS (Współdzielenie zasobów między źródłami)	Określa reguły CORS dla usługi plików. W żądaniu można uwzględnić maksymalnie pięć elementów CorsRule. Jeśli żadne elementy corsRule nie zostaną uwzględnione w treści żądania, wszystkie reguły CORS zostaną usunięte, a mechanizm CORS zostanie wyłączony dla usługi plików.	CorsRules
protocolSettings (ustawienia protokołu)	Ustawienia protokołu dla usługi plików	Ustawienia protokołu
shareDeleteRetentionPolicy	Właściwości usługi plików do usuwania nietrwałego udziału.	DeleteRetentionPolicy

Wielokanałowy

Nazwa	Opis	Wartość
Włączone	Wskazuje, czy włączono obsługę wielu kanałów	Bool

Ustawienia protokołu

Nazwa	Opis	Wartość
Smb	Ustawienie protokołu SMB	SmbSetting

Ustawienie SMB

Nazwa	Opis	Wartość
authenticationMethods (Metody uwierzytelniania)	Metody uwierzytelniania SMB obsługiwane przez serwer. Prawidłowe wartości to NTLMv2, Kerberos. Należy przekazać jako ciąg z ogranicznikiem ";".	struna
Szyfrowanie kanałów	Szyfrowanie kanału SMB obsługiwane przez serwer. Prawidłowe wartości to AES-128-CCM, AES-128-GCM, AES-256-GCM. Należy przekazać jako ciąg z ogranicznikiem ";".	struna
kerberosTicketEncryption (szyfrowanie kerberosTicket)	Szyfrowanie biletów Kerberos obsługiwane przez serwer. Prawidłowe wartości to RC4-HMAC, AES-256. Należy przekazać jako ciąg z ogranicznikiem ";"	struna
Wielokanałowy	Ustawienie wielokanałowe. Dotyczy tylko usługi FileStorage w warstwie Premium.	Multichannel
Wersje	Wersje protokołu SMB obsługiwane przez serwer. Prawidłowe wartości to SMB2.1, SMB3.0, SMB3.1.1. Należy przekazać jako ciąg z ogranicznikiem ";".	struna

Przykłady użycia

Przykłady szybkiego startu platformy Azure

Poniższe szablony szybkiego startu platformy Azure zawierają przykłady Bicep na potrzeby wdrażania tego typu zasobu.

Plik Bicep	Opis
azure Cloud Shell — magazynu sieci wirtualnej	Ten szablon wdraża magazyn usługi Azure Cloud Shell w sieci wirtualnej platformy Azure.
tworzenie usługi AVD przy użyciu FSLogix i AD DS Join	Ten szablon umożliwia tworzenie zasobów usługi Azure Virtual Desktop, takich jak pula hostów, grupa aplikacji, obszar roboczy, konto magazynu FSLogix, udział plików, magazyn usługi odzyskiwania na potrzeby tworzenia kopii zapasowej udziału plików host sesji testowej, jego rozszerzenia przy użyciu przyłączania microsoft Entra ID do domeny usługi Active Directory.

Definicja zasobu szablonu usługi ARM

Typ zasobu storageAccounts/fileServices można wdrożyć przy użyciu operacji docelowych:

• grupy zasobów — zobacz polecenia wdrażania grupy zasobów

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Storage/storageAccounts/fileServices, dodaj następujący kod JSON do szablonu.

{
  "type": "Microsoft.Storage/storageAccounts/fileServices",
  "apiVersion": "2023-04-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"
    }
  }
}

Wartości właściwości

Microsoft.Storage/storageAccounts/fileServices

Nazwa	Opis	Wartość
apiVersion (wersja interfejsu api)	Wersja interfejsu API	'2023-04-01'
nazwa	Nazwa zasobu	"default" (wymagane)
Właściwości	Właściwości usług plików na koncie magazynu.	FileServicePropertiesPropertiesProperties
typ	Typ zasobu	"Microsoft.Storage/storageAccounts/fileServices"

CorsRule (Reguła korsa)

Nazwa	Opis	Wartość
allowedHeaders (dozwolone nagłówki)	Wymagane, jeśli element CorsRule jest obecny. Lista nagłówków, które mogą być częścią żądania między źródłami.	string[] (wymagane)
allowedMethods (dozwolone metody)	Wymagane, jeśli element CorsRule jest obecny. Lista metod HTTP, które mogą być wykonywane przez źródło.	Tablica ciągów zawierająca dowolną z: "CONNECT" "DELETE" "GET" "HEAD" "MERGE" "OPCJE" "PATCH" "POST" "PUT" "TRACE" (wymagane)
allowedOrigins (dozwolone źródła)	Wymagane, jeśli element CorsRule jest obecny. Lista domen pochodzenia, które będą dozwolone za pośrednictwem mechanizmu CORS lub "*", aby zezwolić na wszystkie domeny	string[] (wymagane)
Uwidocznione nagłówki	Wymagane, jeśli element CorsRule jest obecny. Lista nagłówków odpowiedzi, które mają być widoczne dla klientów CORS.	string[] (wymagane)
maxAgeInSeconds (maksymalny wiekw sekundach)	Wymagane, jeśli element CorsRule jest obecny. Liczba sekund, przez które klient/przeglądarka powinna buforować odpowiedź wstępną.	int (wymagane)

CorsRules

Nazwa	Opis	Wartość
corsZasady	Lista reguł CORS. W żądaniu można uwzględnić maksymalnie pięć elementów CorsRule.	KorsRządź[]

DeleteRetentionPolicy

Nazwa	Opis	Wartość
allowPermanentDelete (zezwalać) na usunięcie	Ta właściwość po ustawieniu wartości true umożliwia usunięcie nietrwałych wersji obiektów blob i migawek. Tej właściwości nie można używać zasad przywracania obiektów blob. Ta właściwość dotyczy tylko usługi blob i nie ma zastosowania do kontenerów ani udziału plików.	Bool
Dni	Wskazuje liczbę dni przechowywania usuniętego elementu. Minimalna określona wartość może wynosić 1, a maksymalna wartość może wynosić 365.	Int Ograniczenia: Minimalna wartość = 1 Wartość maksymalna = 365
Włączone	Wskazuje, czy opcja DeleteRetentionPolicy jest włączona.	Bool

FileServicePropertiesPropertiesProperties

Nazwa	Opis	Wartość
CORS (Współdzielenie zasobów między źródłami)	Określa reguły CORS dla usługi plików. W żądaniu można uwzględnić maksymalnie pięć elementów CorsRule. Jeśli żadne elementy corsRule nie zostaną uwzględnione w treści żądania, wszystkie reguły CORS zostaną usunięte, a mechanizm CORS zostanie wyłączony dla usługi plików.	CorsRules
protocolSettings (ustawienia protokołu)	Ustawienia protokołu dla usługi plików	Ustawienia protokołu
shareDeleteRetentionPolicy	Właściwości usługi plików do usuwania nietrwałego udziału.	DeleteRetentionPolicy

Wielokanałowy

Nazwa	Opis	Wartość
Włączone	Wskazuje, czy włączono obsługę wielu kanałów	Bool

Ustawienia protokołu

Nazwa	Opis	Wartość
Smb	Ustawienie protokołu SMB	SmbSetting

Ustawienie SMB

Nazwa	Opis	Wartość
authenticationMethods (Metody uwierzytelniania)	Metody uwierzytelniania SMB obsługiwane przez serwer. Prawidłowe wartości to NTLMv2, Kerberos. Należy przekazać jako ciąg z ogranicznikiem ";".	struna
Szyfrowanie kanałów	Szyfrowanie kanału SMB obsługiwane przez serwer. Prawidłowe wartości to AES-128-CCM, AES-128-GCM, AES-256-GCM. Należy przekazać jako ciąg z ogranicznikiem ";".	struna
kerberosTicketEncryption (szyfrowanie kerberosTicket)	Szyfrowanie biletów Kerberos obsługiwane przez serwer. Prawidłowe wartości to RC4-HMAC, AES-256. Należy przekazać jako ciąg z ogranicznikiem ";"	struna
Wielokanałowy	Ustawienie wielokanałowe. Dotyczy tylko usługi FileStorage w warstwie Premium.	Multichannel
Wersje	Wersje protokołu SMB obsługiwane przez serwer. Prawidłowe wartości to SMB2.1, SMB3.0, SMB3.1.1. Należy przekazać jako ciąg z ogranicznikiem ";".	struna

Przykłady użycia

Szablony szybkiego startu platformy Azure

Następujące szablony szybkiego startu platformy Azure wdrożyć ten typ zasobu.

Szablon	Opis
azure Cloud Shell — magazynu sieci wirtualnej wdrażanie	Ten szablon wdraża magazyn usługi Azure Cloud Shell w sieci wirtualnej platformy Azure.
tworzenie usługi AVD przy użyciu FSLogix i AD DS Join wdrażanie	Ten szablon umożliwia tworzenie zasobów usługi Azure Virtual Desktop, takich jak pula hostów, grupa aplikacji, obszar roboczy, konto magazynu FSLogix, udział plików, magazyn usługi odzyskiwania na potrzeby tworzenia kopii zapasowej udziału plików host sesji testowej, jego rozszerzenia przy użyciu przyłączania microsoft Entra ID do domeny usługi Active Directory.

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu storageAccounts/fileServices można wdrożyć przy użyciu operacji docelowych:

• grupy zasobów

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Storage/storageAccounts/fileServices, dodaj następujący program Terraform do szablonu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Storage/storageAccounts/fileServices@2023-04-01"
  name = "string"
  parent_id = "string"
  body = {
    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
      }
    }
  }
}

Wartości właściwości

Microsoft.Storage/storageAccounts/fileServices

Nazwa	Opis	Wartość
nazwa	Nazwa zasobu	"default" (wymagane)
parent_id (identyfikator rodzica)	Identyfikator zasobu, który jest elementem nadrzędnym dla tego zasobu.	Identyfikator zasobu typu: storageAccounts
Właściwości	Właściwości usług plików na koncie magazynu.	FileServicePropertiesPropertiesProperties
typ	Typ zasobu	"Microsoft.Storage/storageAccounts/fileServices@2023-04-01"

CorsRule (Reguła korsa)

Nazwa	Opis	Wartość
allowedHeaders (dozwolone nagłówki)	Wymagane, jeśli element CorsRule jest obecny. Lista nagłówków, które mogą być częścią żądania między źródłami.	string[] (wymagane)
allowedMethods (dozwolone metody)	Wymagane, jeśli element CorsRule jest obecny. Lista metod HTTP, które mogą być wykonywane przez źródło.	Tablica ciągów zawierająca dowolną z: "CONNECT" "DELETE" "GET" "HEAD" "MERGE" "OPCJE" "PATCH" "POST" "PUT" "TRACE" (wymagane)
allowedOrigins (dozwolone źródła)	Wymagane, jeśli element CorsRule jest obecny. Lista domen pochodzenia, które będą dozwolone za pośrednictwem mechanizmu CORS lub "*", aby zezwolić na wszystkie domeny	string[] (wymagane)
Uwidocznione nagłówki	Wymagane, jeśli element CorsRule jest obecny. Lista nagłówków odpowiedzi, które mają być widoczne dla klientów CORS.	string[] (wymagane)
maxAgeInSeconds (maksymalny wiekw sekundach)	Wymagane, jeśli element CorsRule jest obecny. Liczba sekund, przez które klient/przeglądarka powinna buforować odpowiedź wstępną.	int (wymagane)

CorsRules

Nazwa	Opis	Wartość
corsZasady	Lista reguł CORS. W żądaniu można uwzględnić maksymalnie pięć elementów CorsRule.	KorsRządź[]

DeleteRetentionPolicy

Nazwa	Opis	Wartość
allowPermanentDelete (zezwalać) na usunięcie	Ta właściwość po ustawieniu wartości true umożliwia usunięcie nietrwałych wersji obiektów blob i migawek. Tej właściwości nie można używać zasad przywracania obiektów blob. Ta właściwość dotyczy tylko usługi blob i nie ma zastosowania do kontenerów ani udziału plików.	Bool
Dni	Wskazuje liczbę dni przechowywania usuniętego elementu. Minimalna określona wartość może wynosić 1, a maksymalna wartość może wynosić 365.	Int Ograniczenia: Minimalna wartość = 1 Wartość maksymalna = 365
Włączone	Wskazuje, czy opcja DeleteRetentionPolicy jest włączona.	Bool

FileServicePropertiesPropertiesProperties

Nazwa	Opis	Wartość
CORS (Współdzielenie zasobów między źródłami)	Określa reguły CORS dla usługi plików. W żądaniu można uwzględnić maksymalnie pięć elementów CorsRule. Jeśli żadne elementy corsRule nie zostaną uwzględnione w treści żądania, wszystkie reguły CORS zostaną usunięte, a mechanizm CORS zostanie wyłączony dla usługi plików.	CorsRules
protocolSettings (ustawienia protokołu)	Ustawienia protokołu dla usługi plików	Ustawienia protokołu
shareDeleteRetentionPolicy	Właściwości usługi plików do usuwania nietrwałego udziału.	DeleteRetentionPolicy

Wielokanałowy

Nazwa	Opis	Wartość
Włączone	Wskazuje, czy włączono obsługę wielu kanałów	Bool

Ustawienia protokołu

Nazwa	Opis	Wartość
Smb	Ustawienie protokołu SMB	SmbSetting

Ustawienie SMB

Nazwa	Opis	Wartość
authenticationMethods (Metody uwierzytelniania)	Metody uwierzytelniania SMB obsługiwane przez serwer. Prawidłowe wartości to NTLMv2, Kerberos. Należy przekazać jako ciąg z ogranicznikiem ";".	struna
Szyfrowanie kanałów	Szyfrowanie kanału SMB obsługiwane przez serwer. Prawidłowe wartości to AES-128-CCM, AES-128-GCM, AES-256-GCM. Należy przekazać jako ciąg z ogranicznikiem ";".	struna
kerberosTicketEncryption (szyfrowanie kerberosTicket)	Szyfrowanie biletów Kerberos obsługiwane przez serwer. Prawidłowe wartości to RC4-HMAC, AES-256. Należy przekazać jako ciąg z ogranicznikiem ";"	struna
Wielokanałowy	Ustawienie wielokanałowe. Dotyczy tylko usługi FileStorage w warstwie Premium.	Multichannel
Wersje	Wersje protokołu SMB obsługiwane przez serwer. Prawidłowe wartości to SMB2.1, SMB3.0, SMB3.1.1. Należy przekazać jako ciąg z ogranicznikiem ";".	struna