Udostępnij za pośrednictwem


Microsoft.Storage StorageAccounts/fileServices 2023-01-01

Definicja zasobu Bicep

Typ zasobu storageAccounts/fileServices można wdrożyć z operacjami docelowymi:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik 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-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
    }
  }
}

Wartości właściwości

storageAccounts/fileServices

Nazwa Opis Wartość
name Nazwa zasobu

Zobacz, jak ustawić nazwy i typy dla zasobów podrzędnych w aplikacji Bicep.
"default"
Nadrzędny 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
properties Właściwości usług plików na koncie magazynu. FileServicePropertiesPropertiesWłaściwości

FileServicePropertiesPropertiesWłaściwości

Nazwa Opis Wartość
Cors 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 dla usługi plików ProtocolSettings
shareDeleteRetentionPolicy Właściwości usługi plików do usuwania nietrwałego udziału. DeleteRetentionPolicy

CorsRules

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

CorsRule

Nazwa Opis Wartość
allowedHeaders 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 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 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)
exposedHeaders Wymagane, jeśli element CorsRule jest obecny. Lista nagłówków odpowiedzi, które mają być widoczne dla klientów MECHANIZMU CORS. string[] (wymagane)
maxAgeInSeconds Wymagane, jeśli element CorsRule jest obecny. Liczba sekund buforowania odpowiedzi wstępnej przez klienta/przeglądarkę. int (wymagane)

ProtocolSettings

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

SmbSetting

Nazwa Opis Wartość
authenticationMethods Metody uwierzytelniania SMB obsługiwane przez serwer. Prawidłowe wartości to NTLMv2, Kerberos. Należy przekazać jako ciąg z ogranicznikiem ";". ciąg
channelEncryption 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 ";". ciąg
kerberosTicketEncryption Szyfrowanie biletu Protokołu Kerberos obsługiwane przez serwer. Prawidłowe wartości to RC4-HMAC, AES-256. Należy przekazać jako ciąg z ogranicznikiem ";" ciąg
Wielokanałowy Ustawienie wielokanałowe. Dotyczy tylko usługi FileStorage w warstwie Premium. Wielokanałowy
versions (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 ";". ciąg

Wielokanałowy

Nazwa Opis Wartość
enabled Wskazuje, czy włączono obsługę wielu kanałów bool

DeleteRetentionPolicy

Nazwa Opis Wartość
allowPermanentDelete Ta właściwość po ustawieniu wartości true umożliwia usunięcie nietrwale usuniętych 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 dotyczy 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ść to 365. int

Ograniczenia:
Minimalna wartość = 1
Maksymalna wartość = 365
enabled Wskazuje, czy opcja DeleteRetentionPolicy jest włączona. bool

Szablony szybkiego startu

Następujące szablony szybkiego startu wdrażają ten typ zasobu.

Template Opis
Azure Cloud Shell — magazyn sieci wirtualnej

Wdróż na platformie Azure
Ten szablon służy do wdrażania usługi Azure Cloud Shell Storage w sieci wirtualnej platformy Azure.

Definicja zasobu szablonu usługi ARM

Typ zasobu storageAccounts/fileServices można wdrożyć z operacjami docelowymi:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik 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-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"
    }
  }
}

Wartości właściwości

storageAccounts/fileServices

Nazwa Opis Wartość
typ Typ zasobu "Microsoft.Storage/storageAccounts/fileServices"
apiVersion Wersja interfejsu API zasobów '2023-01-01'
name Nazwa zasobu

Zobacz, jak ustawić nazwy i typy dla zasobów podrzędnych w szablonach usługi ARM w formacie JSON.
"default"
properties Właściwości usług plików na koncie magazynu. FileServicePropertiesPropertiesWłaściwości

FileServicePropertiesPropertiesWłaściwości

Nazwa Opis Wartość
Cors 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 dla usługi plików ProtocolSettings
shareDeleteRetentionPolicy Właściwości usługi plików do usuwania nietrwałego udziału. DeleteRetentionPolicy

CorsRules

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

CorsRule

Nazwa Opis Wartość
allowedHeaders 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 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 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)
exposedHeaders Wymagane, jeśli element CorsRule jest obecny. Lista nagłówków odpowiedzi, które mają być widoczne dla klientów CORS. string[] (wymagane)
maxAgeInSeconds Wymagane, jeśli element CorsRule jest obecny. Liczba sekund, w których klient/przeglądarka powinna buforować odpowiedź wstępną. int (wymagane)

ProtocolSettings

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

SmbSetting

Nazwa Opis Wartość
authenticationMethods Metody uwierzytelniania SMB obsługiwane przez serwer. Prawidłowe wartości to NTLMv2, Kerberos. Należy przekazać jako ciąg z ogranicznikiem ";". ciąg
channelEncryption 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 ";". ciąg
kerberosTicketEncryption Szyfrowanie biletów Protokołu Kerberos obsługiwane przez serwer. Prawidłowe wartości to RC4-HMAC, AES-256. Należy przekazać jako ciąg z ogranicznikiem ";" ciąg
Wielokanałowy Ustawienie wielokanałowe. Dotyczy tylko usługi FileStorage w warstwie Premium. Wielokanałowy
versions (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 ";". ciąg

Wielokanałowy

Nazwa Opis Wartość
enabled Wskazuje, czy włączono obsługę wielu kanałów bool

DeleteRetentionPolicy

Nazwa Opis Wartość
allowPermanentDelete Ta właściwość po ustawieniu wartości true umożliwia usunięcie nietrwale usuniętych 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 obiektów 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
Maksymalna wartość = 365
enabled Wskazuje, czy opcja DeleteRetentionPolicy jest włączona. bool

Szablony szybkiego startu

Następujące szablony szybkiego startu wdrażają ten typ zasobu.

Template Opis
Azure Cloud Shell — magazyn sieci wirtualnej

Wdróż na platformie Azure
Ten szablon wdraża usługę Azure Cloud Shell Storage w sieci wirtualnej platformy Azure.

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu storageAccounts/fileServices można wdrożyć z operacjami docelowymi:

  • Grupy zasobów

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik 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-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
      }
    }
  })
}

Wartości właściwości

storageAccounts/fileServices

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

FileServicePropertiesPropertiesWłaściwości

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

CorsRules

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

CorsRule

Nazwa Opis Wartość
allowedHeaders 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 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 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)
exposedHeaders Wymagane, jeśli element CorsRule jest obecny. Lista nagłówków odpowiedzi, które mają być widoczne dla klientów CORS. string[] (wymagane)
maxAgeInSeconds Wymagane, jeśli element CorsRule jest obecny. Liczba sekund, w których klient/przeglądarka powinna buforować odpowiedź wstępną. int (wymagane)

ProtocolSettings

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

SmbSetting

Nazwa Opis Wartość
authenticationMethods Metody uwierzytelniania SMB obsługiwane przez serwer. Prawidłowe wartości to NTLMv2, Kerberos. Należy przekazać jako ciąg z ogranicznikiem ";". ciąg
channelEncryption 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 ";". ciąg
kerberosTicketEncryption Szyfrowanie biletów Protokołu Kerberos obsługiwane przez serwer. Prawidłowe wartości to RC4-HMAC, AES-256. Należy przekazać jako ciąg z ogranicznikiem ";" ciąg
Wielokanałowy Ustawienie wielokanałowe. Dotyczy tylko usługi FileStorage w warstwie Premium. Wielokanałowy
versions (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 ";". ciąg

Wielokanałowy

Nazwa Opis Wartość
enabled Wskazuje, czy włączono obsługę wielu kanałów bool

DeleteRetentionPolicy

Nazwa Opis Wartość
allowPermanentDelete Ta właściwość po ustawieniu wartości true umożliwia usunięcie nietrwale usuniętych 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 obiektów 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
Maksymalna wartość = 365
enabled Wskazuje, czy opcja DeleteRetentionPolicy jest włączona. bool