Microsoft.Storage storageAccounts/fileServices 2023-01-01

아티클
02/23/2025

Bicep 리소스 정의

storageAccounts/fileServices 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

리소스 그룹 - 리소스 그룹 배포 명령 참조

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.Storage/storageAccounts/fileServices 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.

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
    }
  }
}

속성 값

CorsRule

이름	묘사	값
allowedHeaders	CorsRule 요소가 있는 경우 필수입니다. 원본 간 요청의 일부가 될 수 있는 헤더 목록입니다.	string[] (필수)
allowedMethods	CorsRule 요소가 있는 경우 필수입니다. 원본에서 실행할 수 있는 HTTP 메서드 목록입니다.	다음 중 어느 것을 포함하는 문자열 배열: 'CONNECT' 'DELETE' 'GET' 'HEAD' 'MERGE' 'OPTIONS' 'PATCH' 'POST' 'PUT' 'TRACE'(필수)
allowedOrigins	CorsRule 요소가 있는 경우 필수입니다. CORS를 통해 허용되는 원본 도메인 목록 또는 모든 도메인을 허용하는 "*"입니다.	string[] (필수)
exposedHeaders	CorsRule 요소가 있는 경우 필수입니다. CORS 클라이언트에 노출할 응답 헤더 목록입니다.	string[] (필수)
maxAgeInSeconds	CorsRule 요소가 있는 경우 필수입니다. 클라이언트/브라우저가 실행 전 응답을 캐시해야 하는 시간(초)입니다.	int(필수)

CorsRules

이름	묘사	값
corsRules	CORS 규칙 목록입니다. 요청에 최대 5개의 CorsRule 요소를 포함할 수 있습니다.	CorsRule[]

DeleteRetentionPolicy

이름	묘사	값
allowPermanentDelete	true로 설정된 경우 이 속성을 사용하면 일시 삭제된 Blob 버전 및 스냅샷을 삭제할 수 있습니다. 이 속성은 Blob 복원 정책을 사용할 수 없습니다. 이 속성은 Blob 서비스에만 적용되며 컨테이너 또는 파일 공유에는 적용되지 않습니다.	bool
일	삭제된 항목을 보존해야 하는 일 수를 나타냅니다. 지정된 최소값은 1이고 최대값은 365일 수 있습니다.	int 제약 조건: 최소값 = 1 최대값 = 365
사용	DeleteRetentionPolicy를 사용할 수 있는지 여부를 나타냅니다.	bool

FileServicePropertiesProperties

이름	묘사	값
cors	파일 서비스에 대한 CORS 규칙을 지정합니다. 요청에 최대 5개의 CorsRule 요소를 포함할 수 있습니다. 요청 본문에 CorsRule 요소가 포함되지 않으면 모든 CORS 규칙이 삭제되고 파일 서비스에 대해 CORS가 비활성화됩니다.	CorsRules
protocolSettings	파일 서비스에 대한 프로토콜 설정	ProtocolSettings
shareDeleteRetentionPolicy	공유 일시 삭제에 대한 파일 서비스 속성입니다.	DeleteRetentionPolicy

Microsoft.Storage/storageAccounts/fileServices

이름	묘사	값
이름	리소스 이름	'default'(필수)
부모	Bicep에서 자식 리소스에 대한 부모 리소스를 지정할 수 있습니다. 자식 리소스가 부모 리소스 외부에서 선언된 경우에만 이 속성을 추가해야 합니다. 자세한 내용은 부모 리소스외부의 자식 리소스 참조하세요.	형식 리소스의 기호 이름: storageAccounts
속성	스토리지 계정의 파일 서비스의 속성입니다.	FileServicePropertiesProperties

다채널

이름	묘사	값
사용	다중 채널이 사용되는지 여부를 나타냅니다.	bool

ProtocolSettings

이름	묘사	값
smb	SMB 프로토콜에 대한 설정	SmbSetting

SmbSetting

이름	묘사	값
authenticationMethods	서버에서 지원하는 SMB 인증 방법입니다. 유효한 값은 NTLMv2, Kerberos입니다. 구분 기호가 ';'인 문자열로 전달되어야 합니다.	문자열
channelEncryption	서버에서 지원하는 SMB 채널 암호화입니다. 유효한 값은 AES-128-CCM, AES-128-GCM, AES-256-GCM입니다. 구분 기호가 ';'인 문자열로 전달되어야 합니다.	문자열
kerberosTicketEncryption	서버에서 지원하는 Kerberos 티켓 암호화입니다. 유효한 값은 RC4-HMAC, AES-256입니다. 구분 기호가 ';'인 문자열로 전달되어야 합니다.	문자열
다채널	다중 채널 설정입니다. 프리미엄 FileStorage에만 적용됩니다.	다중 채널
버전	서버에서 지원하는 SMB 프로토콜 버전입니다. 유효한 값은 SMB2.1, SMB3.0, SMB3.1.1입니다. 구분 기호가 ';'인 문자열로 전달되어야 합니다.	문자열

사용 예제

Azure 빠른 시작 샘플

다음 Azure 빠른 시작 템플릿에는 이 리소스 유형을 배포하기 위한 Bicep 샘플이 포함되어 있습니다.

Bicep 파일	묘사
Azure Cloud Shell - VNet 스토리지	이 템플릿은 Azure Cloud Shell 스토리지를 Azure 가상 네트워크에 배포합니다.
FSLogix 및 AD DS 조인을 사용하여 AVD 만들기	이 템플릿을 사용하면 호스트 풀, 애플리케이션 그룹, 작업 영역, FSLogix 스토리지 계정, 파일 공유, 테스트 세션 호스트 백업을 위한 복구 서비스 자격 증명 모음, Microsoft Entra ID 조인 pr Active Directory 도메인 조인을 사용하는 확장과 같은 Azure Virtual Desktop 리소스를 만들 수 있습니다.

ARM 템플릿 리소스 정의

storageAccounts/fileServices 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

리소스 그룹 - 리소스 그룹 배포 명령 참조

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.Storage/storageAccounts/fileServices 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.

{
  "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"
    }
  }
}

속성 값

CorsRule

이름	묘사	값
allowedHeaders	CorsRule 요소가 있는 경우 필수입니다. 원본 간 요청의 일부가 될 수 있는 헤더 목록입니다.	string[] (필수)
allowedMethods	CorsRule 요소가 있는 경우 필수입니다. 원본에서 실행할 수 있는 HTTP 메서드 목록입니다.	다음 중 어느 것을 포함하는 문자열 배열: 'CONNECT' 'DELETE' 'GET' 'HEAD' 'MERGE' 'OPTIONS' 'PATCH' 'POST' 'PUT' 'TRACE'(필수)
allowedOrigins	CorsRule 요소가 있는 경우 필수입니다. CORS를 통해 허용되는 원본 도메인 목록 또는 모든 도메인을 허용하는 "*"입니다.	string[] (필수)
exposedHeaders	CorsRule 요소가 있는 경우 필수입니다. CORS 클라이언트에 노출할 응답 헤더 목록입니다.	string[] (필수)
maxAgeInSeconds	CorsRule 요소가 있는 경우 필수입니다. 클라이언트/브라우저가 실행 전 응답을 캐시해야 하는 시간(초)입니다.	int(필수)

CorsRules

이름	묘사	값
corsRules	CORS 규칙 목록입니다. 요청에 최대 5개의 CorsRule 요소를 포함할 수 있습니다.	CorsRule[]

DeleteRetentionPolicy

이름	묘사	값
allowPermanentDelete	true로 설정된 경우 이 속성을 사용하면 일시 삭제된 Blob 버전 및 스냅샷을 삭제할 수 있습니다. 이 속성은 Blob 복원 정책을 사용할 수 없습니다. 이 속성은 Blob 서비스에만 적용되며 컨테이너 또는 파일 공유에는 적용되지 않습니다.	bool
일	삭제된 항목을 보존해야 하는 일 수를 나타냅니다. 지정된 최소값은 1이고 최대값은 365일 수 있습니다.	int 제약 조건: 최소값 = 1 최대값 = 365
사용	DeleteRetentionPolicy를 사용할 수 있는지 여부를 나타냅니다.	bool

FileServicePropertiesProperties

이름	묘사	값
cors	파일 서비스에 대한 CORS 규칙을 지정합니다. 요청에 최대 5개의 CorsRule 요소를 포함할 수 있습니다. 요청 본문에 CorsRule 요소가 포함되지 않으면 모든 CORS 규칙이 삭제되고 파일 서비스에 대해 CORS가 비활성화됩니다.	CorsRules
protocolSettings	파일 서비스에 대한 프로토콜 설정	ProtocolSettings
shareDeleteRetentionPolicy	공유 일시 삭제에 대한 파일 서비스 속성입니다.	DeleteRetentionPolicy

Microsoft.Storage/storageAccounts/fileServices

이름	묘사	값
apiVersion	api 버전	'2023-01-01'
이름	리소스 이름	'default'(필수)
속성	스토리지 계정의 파일 서비스의 속성입니다.	FileServicePropertiesProperties
형	리소스 종류	'Microsoft.Storage/storageAccounts/fileServices'

다채널

이름	묘사	값
사용	다중 채널이 사용되는지 여부를 나타냅니다.	bool

ProtocolSettings

이름	묘사	값
smb	SMB 프로토콜에 대한 설정	SmbSetting

SmbSetting

이름	묘사	값
authenticationMethods	서버에서 지원하는 SMB 인증 방법입니다. 유효한 값은 NTLMv2, Kerberos입니다. 구분 기호가 ';'인 문자열로 전달되어야 합니다.	문자열
channelEncryption	서버에서 지원하는 SMB 채널 암호화입니다. 유효한 값은 AES-128-CCM, AES-128-GCM, AES-256-GCM입니다. 구분 기호가 ';'인 문자열로 전달되어야 합니다.	문자열
kerberosTicketEncryption	서버에서 지원하는 Kerberos 티켓 암호화입니다. 유효한 값은 RC4-HMAC, AES-256입니다. 구분 기호가 ';'인 문자열로 전달되어야 합니다.	문자열
다채널	다중 채널 설정입니다. 프리미엄 FileStorage에만 적용됩니다.	다중 채널
버전	서버에서 지원하는 SMB 프로토콜 버전입니다. 유효한 값은 SMB2.1, SMB3.0, SMB3.1.1입니다. 구분 기호가 ';'인 문자열로 전달되어야 합니다.	문자열

사용 예제

Azure 빠른 시작 템플릿

다음 Azure 빠른 시작 템플릿은 이 리소스 유형을 배포할 있습니다.

템플렛	묘사
Azure Cloud Shell - VNet 스토리지 Azure 배포	이 템플릿은 Azure Cloud Shell 스토리지를 Azure 가상 네트워크에 배포합니다.
FSLogix 및 AD DS 조인을 사용하여 AVD 만들기 Azure 배포	이 템플릿을 사용하면 호스트 풀, 애플리케이션 그룹, 작업 영역, FSLogix 스토리지 계정, 파일 공유, 테스트 세션 호스트 백업을 위한 복구 서비스 자격 증명 모음, Microsoft Entra ID 조인 pr Active Directory 도메인 조인을 사용하는 확장과 같은 Azure Virtual Desktop 리소스를 만들 수 있습니다.

Terraform(AzAPI 공급자) 리소스 정의

storageAccounts/fileServices 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

리소스 그룹

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.Storage/storageAccounts/fileServices 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.

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
      }
    }
  })
}

속성 값

CorsRule

이름	묘사	값
allowedHeaders	CorsRule 요소가 있는 경우 필수입니다. 원본 간 요청의 일부가 될 수 있는 헤더 목록입니다.	string[] (필수)
allowedMethods	CorsRule 요소가 있는 경우 필수입니다. 원본에서 실행할 수 있는 HTTP 메서드 목록입니다.	다음 중 어느 것을 포함하는 문자열 배열: 'CONNECT' 'DELETE' 'GET' 'HEAD' 'MERGE' 'OPTIONS' 'PATCH' 'POST' 'PUT' 'TRACE'(필수)
allowedOrigins	CorsRule 요소가 있는 경우 필수입니다. CORS를 통해 허용되는 원본 도메인 목록 또는 모든 도메인을 허용하는 "*"입니다.	string[] (필수)
exposedHeaders	CorsRule 요소가 있는 경우 필수입니다. CORS 클라이언트에 노출할 응답 헤더 목록입니다.	string[] (필수)
maxAgeInSeconds	CorsRule 요소가 있는 경우 필수입니다. 클라이언트/브라우저가 실행 전 응답을 캐시해야 하는 시간(초)입니다.	int(필수)

CorsRules

이름	묘사	값
corsRules	CORS 규칙 목록입니다. 요청에 최대 5개의 CorsRule 요소를 포함할 수 있습니다.	CorsRule[]

DeleteRetentionPolicy

이름	묘사	값
allowPermanentDelete	true로 설정된 경우 이 속성을 사용하면 일시 삭제된 Blob 버전 및 스냅샷을 삭제할 수 있습니다. 이 속성은 Blob 복원 정책을 사용할 수 없습니다. 이 속성은 Blob 서비스에만 적용되며 컨테이너 또는 파일 공유에는 적용되지 않습니다.	bool
일	삭제된 항목을 보존해야 하는 일 수를 나타냅니다. 지정된 최소값은 1이고 최대값은 365일 수 있습니다.	int 제약 조건: 최소값 = 1 최대값 = 365
사용	DeleteRetentionPolicy를 사용할 수 있는지 여부를 나타냅니다.	bool

FileServicePropertiesProperties

이름	묘사	값
cors	파일 서비스에 대한 CORS 규칙을 지정합니다. 요청에 최대 5개의 CorsRule 요소를 포함할 수 있습니다. 요청 본문에 CorsRule 요소가 포함되지 않으면 모든 CORS 규칙이 삭제되고 파일 서비스에 대해 CORS가 비활성화됩니다.	CorsRules
protocolSettings	파일 서비스에 대한 프로토콜 설정	ProtocolSettings
shareDeleteRetentionPolicy	공유 일시 삭제에 대한 파일 서비스 속성입니다.	DeleteRetentionPolicy

Microsoft.Storage/storageAccounts/fileServices

이름	묘사	값
이름	리소스 이름	'default'(필수)
parent_id	이 리소스의 부모인 리소스의 ID입니다.	유형의 리소스에 대한 ID: storageAccounts
속성	스토리지 계정의 파일 서비스의 속성입니다.	FileServicePropertiesProperties
형	리소스 종류	"Microsoft.Storage/storageAccounts/fileServices@2023-01-01"

다채널

이름	묘사	값
사용	다중 채널이 사용되는지 여부를 나타냅니다.	bool

ProtocolSettings

이름	묘사	값
smb	SMB 프로토콜에 대한 설정	SmbSetting

SmbSetting

이름	묘사	값
authenticationMethods	서버에서 지원하는 SMB 인증 방법입니다. 유효한 값은 NTLMv2, Kerberos입니다. 구분 기호가 ';'인 문자열로 전달되어야 합니다.	문자열
channelEncryption	서버에서 지원하는 SMB 채널 암호화입니다. 유효한 값은 AES-128-CCM, AES-128-GCM, AES-256-GCM입니다. 구분 기호가 ';'인 문자열로 전달되어야 합니다.	문자열
kerberosTicketEncryption	서버에서 지원하는 Kerberos 티켓 암호화입니다. 유효한 값은 RC4-HMAC, AES-256입니다. 구분 기호가 ';'인 문자열로 전달되어야 합니다.	문자열
다채널	다중 채널 설정입니다. 프리미엄 FileStorage에만 적용됩니다.	다중 채널
버전	서버에서 지원하는 SMB 프로토콜 버전입니다. 유효한 값은 SMB2.1, SMB3.0, SMB3.1.1입니다. 구분 기호가 ';'인 문자열로 전달되어야 합니다.	문자열

다음을 통해 공유

Microsoft.Storage storageAccounts/fileServices 2023-01-01

Bicep 리소스 정의

리소스 형식

속성 값

CorsRule

CorsRules

DeleteRetentionPolicy

FileServicePropertiesProperties

Microsoft.Storage/storageAccounts/fileServices

다채널

ProtocolSettings

SmbSetting

사용 예제

Azure 빠른 시작 샘플

ARM 템플릿 리소스 정의

리소스 형식

속성 값

CorsRule

CorsRules

DeleteRetentionPolicy

FileServicePropertiesProperties

Microsoft.Storage/storageAccounts/fileServices

다채널

ProtocolSettings

SmbSetting

사용 예제

Azure 빠른 시작 템플릿

Terraform(AzAPI 공급자) 리소스 정의

리소스 형식

속성 값

CorsRule

CorsRules

DeleteRetentionPolicy

FileServicePropertiesProperties

Microsoft.Storage/storageAccounts/fileServices

다채널

ProtocolSettings

SmbSetting

피드백

추가 리소스