Microsoft.Storage 스토리지계정/파일서비스/공유

• 최신
• 2025-01-01
• 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-미리보기
• 2019-06-01
• 2019-04-01

Bicep 리소스 정의

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

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

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

리소스 형식

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

resource symbolicname 'Microsoft.Storage/storageAccounts/fileServices/shares@2025-01-01' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    accessTier: 'string'
    enabledProtocols: 'string'
    fileSharePaidBursting: {
      paidBurstingEnabled: bool
      paidBurstingMaxBandwidthMibps: int
      paidBurstingMaxIops: int
    }
    metadata: {
      {customized property}: 'string'
    }
    provisionedBandwidthMibps: int
    provisionedIops: int
    rootSquash: 'string'
    shareQuota: int
    signedIdentifiers: [
      {
        accessPolicy: {
          expiryTime: 'string'
          permission: 'string'
          startTime: 'string'
        }
        id: 'string'
      }
    ]
  }
}

속성 값

Microsoft.Storage/storageAccounts/fileServices/shares

이름	묘사	값
이름	리소스 이름	문자열 제약 조건: 최소 길이 = 3 최대 길이 = 63(필수)
부모	Bicep에서 자식 리소스에 대한 부모 리소스를 지정할 수 있습니다. 자식 리소스가 부모 리소스 외부에서 선언된 경우에만 이 속성을 추가해야 합니다. 자세한 내용은 부모 리소스외부의 자식 리소스 참조하세요.	형식의 리소스에 대한 기호 이름: storageAccounts/fileServices
속성	파일 공유의 속성입니다.	fileShareProperties

액세스정책

이름	묘사	값
만료 시간	액세스 정책의 만료 시간	문자열
허가	약식 사용 권한 목록입니다.	문자열
시작 시간	액세스 정책의 시작 시간	문자열

파일셰어프로퍼티

이름	묘사	값
accessTier	특정 공유에 대한 액세스 계층입니다. GpV2 계정은 TransactionOptimized(기본값), 핫 및 쿨 중에서 선택할 수 있습니다. FileStorage 계정은 프리미엄을 선택할 수 있습니다.	'쿨' '핫' '프리미엄' '트랜잭션 최적화'
enabled프로토콜	파일 공유에 사용되는 인증 프로토콜입니다. 공유를 만들 때만 지정할 수 있습니다.	'NFS' '중소기업'
파일공유지불버스팅	파일 공유 유료 버스팅 속성입니다.	파일공유속성파일공유유료버스팅
메타데이터	공유와 메타데이터로 연결할 이름-값 쌍입니다.	FileSharePropertiesMetadata
프로비저닝된 대역폭Mibps	공유의 프로비전된 대역폭(초당 mebibytes)입니다. 이 속성은 Files Provisioned v2 계정 유형에서 만든 파일 공유에만 해당합니다. 프로비전된 대역폭에 허용되는 최소값과 최대값은 GetFileServiceUsage API 응답을 참조하세요.	정수 (int)
프로비저닝Iops	공유의 프로비전된 IOPS입니다. 이 속성은 Files Provisioned v2 계정 유형에서 만든 파일 공유에만 해당합니다. 프로비전된 IOPS에 허용되는 최소값과 최대값은 GetFileServiceUsage API 응답을 참조하세요.	정수 (int)
root스쿼시	이 속성은 NFS 공유 전용입니다. 기본값은 NoRootSquash입니다.	'올스쿼시' '노루트스쿼시' '루트스쿼시'
shareQuota 공유할당량	프로비전된 공유 크기(기비바이트)입니다. 0보다 크고 5TB(5120)보다 작거나 같아야 합니다. 대용량 파일 공유의 경우 최대 크기는 102400입니다. Files Provisioned v2 계정 유형에서 만든 파일 공유의 경우 허용되는 최소 및 최대 프로비저닝된 스토리지 크기에 대한 GetFileServiceUsage API 응답을 참조하세요.	정수 (int)
서명된식별자	공유에 지정된 저장된 액세스 정책 목록입니다.	서명된 식별자[]

파일공유속성파일공유유료버스팅

이름	묘사	값
유료버스팅활성화	공유에 대해 유료 버스팅을 사용할 수 있는지 여부를 나타냅니다. 이 속성은 Files Provisioned v1 SSD 계정 유형에서 만든 파일 공유에만 해당합니다.	부울
유료버스팅최대 대역폭Mibps	공유에 대한 최대 유료 버스트 대역폭(초당 mebibytes)입니다. 이 속성은 Files Provisioned v1 SSD 계정 유형에서 만든 파일 공유에만 해당합니다. 허용되는 최대 값은 공유에 허용되는 최대 대역폭인 10340입니다.	정수 (int)
유료버스팅MaxIops	공유에 대한 최대 유료 버스트 IOPS입니다. 이 속성은 Files Provisioned v1 SSD 계정 유형에서 만든 파일 공유에만 해당합니다. 허용되는 최대값은 공유에 허용되는 최대 IOPS인 102400입니다.	정수 (int)

파일셰어프로퍼티메타데이터

이름	묘사	값

서명된 식별자

이름	묘사	값
액세스 정책	액세스 정책	액세스정책
아이디	저장된 액세스 정책의 고유 식별자입니다.	문자열

사용 예제

Azure 빠른 시작 샘플

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

Bicep 파일	묘사
Azure Cloud Shell - VNet 스토리지	이 템플릿은 Azure Cloud Shell 스토리지를 Azure 가상 네트워크에 배포합니다.
파일 공유를 사용하여 스토리지 계정 만들기	이 템플릿은 Azure Storage 계정 및 파일 공유를 만듭니다.
여러 파일 공유를 사용하여 스토리지 계정 만들기	Azure Storage 계정 및 여러 파일 공유를 만듭니다.
FSLogix 및 AD DS 조인을 사용하여 AVD 만들기	이 템플릿을 사용하면 호스트 풀, 애플리케이션 그룹, 작업 영역, FSLogix 스토리지 계정, 파일 공유, 테스트 세션 호스트 백업을 위한 복구 서비스 자격 증명 모음, Microsoft Entra ID 조인 pr Active Directory 도메인 조인을 사용하는 확장과 같은 Azure Virtual Desktop 리소스를 만들 수 있습니다.
함수 앱 및 프라이빗 엔드포인트 보안 스토리지 만들기	이 템플릿을 사용하면 프라이빗 엔드포인트를 통해 Azure Storage와 통신하는 Azure Function App을 배포할 수 있습니다.
Azure Frontdoor 의해 보호되는 함수 앱	이 템플릿을 사용하면 Azure Frontdoor Premium에서 보호하고 게시하는 Azure 프리미엄 함수를 배포할 수 있습니다. Azure Frontdoor와 Azure Functions 간의 연결은 Azure Private Link로 보호됩니다.
프라이빗 함수 앱 및 프라이빗 엔드포인트 보안 스토리지	이 템플릿은 프라이빗 엔드포인트가 있고 프라이빗 엔드포인트를 통해 Azure Storage와 통신하는 프리미엄 계획에 함수 앱을 프로비전합니다.

ARM 템플릿 리소스 정의

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

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

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

리소스 형식

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

{
  "type": "Microsoft.Storage/storageAccounts/fileServices/shares",
  "apiVersion": "2025-01-01",
  "name": "string",
  "properties": {
    "accessTier": "string",
    "enabledProtocols": "string",
    "fileSharePaidBursting": {
      "paidBurstingEnabled": "bool",
      "paidBurstingMaxBandwidthMibps": "int",
      "paidBurstingMaxIops": "int"
    },
    "metadata": {
      "{customized property}": "string"
    },
    "provisionedBandwidthMibps": "int",
    "provisionedIops": "int",
    "rootSquash": "string",
    "shareQuota": "int",
    "signedIdentifiers": [
      {
        "accessPolicy": {
          "expiryTime": "string",
          "permission": "string",
          "startTime": "string"
        },
        "id": "string"
      }
    ]
  }
}

속성 값

Microsoft.Storage/storageAccounts/fileServices/shares

이름	묘사	값
API버전	api 버전	'2025-01-01'
이름	리소스 이름	문자열 제약 조건: 최소 길이 = 3 최대 길이 = 63(필수)
속성	파일 공유의 속성입니다.	fileShareProperties
형	리소스 종류	'Microsoft.Storage/storageAccounts/fileServices/shares'

액세스정책

이름	묘사	값
만료 시간	액세스 정책의 만료 시간	문자열
허가	약식 사용 권한 목록입니다.	문자열
시작 시간	액세스 정책의 시작 시간	문자열

파일셰어프로퍼티

이름	묘사	값
accessTier	특정 공유에 대한 액세스 계층입니다. GpV2 계정은 TransactionOptimized(기본값), 핫 및 쿨 중에서 선택할 수 있습니다. FileStorage 계정은 프리미엄을 선택할 수 있습니다.	'쿨' '핫' '프리미엄' '트랜잭션 최적화'
enabled프로토콜	파일 공유에 사용되는 인증 프로토콜입니다. 공유를 만들 때만 지정할 수 있습니다.	'NFS' '중소기업'
파일공유지불버스팅	파일 공유 유료 버스팅 속성입니다.	파일공유속성파일공유유료버스팅
메타데이터	공유와 메타데이터로 연결할 이름-값 쌍입니다.	FileSharePropertiesMetadata
프로비저닝된 대역폭Mibps	공유의 프로비전된 대역폭(초당 mebibytes)입니다. 이 속성은 Files Provisioned v2 계정 유형에서 만든 파일 공유에만 해당합니다. 프로비전된 대역폭에 허용되는 최소값과 최대값은 GetFileServiceUsage API 응답을 참조하세요.	정수 (int)
프로비저닝Iops	공유의 프로비전된 IOPS입니다. 이 속성은 Files Provisioned v2 계정 유형에서 만든 파일 공유에만 해당합니다. 프로비전된 IOPS에 허용되는 최소값과 최대값은 GetFileServiceUsage API 응답을 참조하세요.	정수 (int)
root스쿼시	이 속성은 NFS 공유 전용입니다. 기본값은 NoRootSquash입니다.	'올스쿼시' '노루트스쿼시' '루트스쿼시'
shareQuota 공유할당량	프로비전된 공유 크기(기비바이트)입니다. 0보다 크고 5TB(5120)보다 작거나 같아야 합니다. 대용량 파일 공유의 경우 최대 크기는 102400입니다. Files Provisioned v2 계정 유형에서 만든 파일 공유의 경우 허용되는 최소 및 최대 프로비저닝된 스토리지 크기에 대한 GetFileServiceUsage API 응답을 참조하세요.	정수 (int)
서명된식별자	공유에 지정된 저장된 액세스 정책 목록입니다.	서명된 식별자[]

파일공유속성파일공유유료버스팅

이름	묘사	값
유료버스팅활성화	공유에 대해 유료 버스팅을 사용할 수 있는지 여부를 나타냅니다. 이 속성은 Files Provisioned v1 SSD 계정 유형에서 만든 파일 공유에만 해당합니다.	부울
유료버스팅최대 대역폭Mibps	공유에 대한 최대 유료 버스트 대역폭(초당 mebibytes)입니다. 이 속성은 Files Provisioned v1 SSD 계정 유형에서 만든 파일 공유에만 해당합니다. 허용되는 최대 값은 공유에 허용되는 최대 대역폭인 10340입니다.	정수 (int)
유료버스팅MaxIops	공유에 대한 최대 유료 버스트 IOPS입니다. 이 속성은 Files Provisioned v1 SSD 계정 유형에서 만든 파일 공유에만 해당합니다. 허용되는 최대값은 공유에 허용되는 최대 IOPS인 102400입니다.	정수 (int)

파일셰어프로퍼티메타데이터

이름	묘사	값

서명된 식별자

이름	묘사	값
액세스 정책	액세스 정책	액세스정책
아이디	저장된 액세스 정책의 고유 식별자입니다.	문자열

사용 예제

Azure 빠른 시작 템플릿

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

템플렛	묘사
Azure Cloud Shell - VNet 스토리지 Azure 배포	이 템플릿은 Azure Cloud Shell 스토리지를 Azure 가상 네트워크에 배포합니다.
프라이빗 엔드포인트를 통해 Azure 파일 공유에 연결 Azure 배포	이 샘플에서는 가상 네트워크 및 프라이빗 DNS 영역을 구성하여 프라이빗 엔드포인트를 통해 Azure 파일 공유에 액세스하는 방법을 보여줍니다.
파일 공유를 사용하여 스토리지 계정 만들기 Azure 배포	이 템플릿은 Azure Storage 계정 및 파일 공유를 만듭니다.
여러 파일 공유를 사용하여 스토리지 계정 만들기 Azure 배포	Azure Storage 계정 및 여러 파일 공유를 만듭니다.
FSLogix 및 AD DS 조인을 사용하여 AVD 만들기 Azure 배포	이 템플릿을 사용하면 호스트 풀, 애플리케이션 그룹, 작업 영역, FSLogix 스토리지 계정, 파일 공유, 테스트 세션 호스트 백업을 위한 복구 서비스 자격 증명 모음, Microsoft Entra ID 조인 pr Active Directory 도메인 조인을 사용하는 확장과 같은 Azure Virtual Desktop 리소스를 만들 수 있습니다.
함수 앱 및 프라이빗 엔드포인트 보안 스토리지 만들기 Azure 배포	이 템플릿을 사용하면 프라이빗 엔드포인트를 통해 Azure Storage와 통신하는 Azure Function App을 배포할 수 있습니다.
VM 확장 집합, Azure Files 및 Mysql 사용하여 Drupal 배포 Azure 배포	Drupal(Apache/PHP)을 실행하는 각 VM에 & 부하 분산 장치/NAT 뒤에 VM 확장 집합을 배포합니다. 모든 노드는 만든 Azure 파일 공유 스토리지 및 MySQL 데이터베이스를 공유합니다.
Azure Frontdoor 의해 보호되는 함수 앱 Azure 배포	이 템플릿을 사용하면 Azure Frontdoor Premium에서 보호하고 게시하는 Azure 프리미엄 함수를 배포할 수 있습니다. Azure Frontdoor와 Azure Functions 간의 연결은 Azure Private Link로 보호됩니다.
프라이빗 함수 앱 및 프라이빗 엔드포인트 보안 스토리지 Azure 배포	이 템플릿은 프라이빗 엔드포인트가 있고 프라이빗 엔드포인트를 통해 Azure Storage와 통신하는 프리미엄 계획에 함수 앱을 프로비전합니다.

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

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

• 리소스 그룹

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

리소스 형식

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Storage/storageAccounts/fileServices/shares@2025-01-01"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      accessTier = "string"
      enabledProtocols = "string"
      fileSharePaidBursting = {
        paidBurstingEnabled = bool
        paidBurstingMaxBandwidthMibps = int
        paidBurstingMaxIops = int
      }
      metadata = {
        {customized property} = "string"
      }
      provisionedBandwidthMibps = int
      provisionedIops = int
      rootSquash = "string"
      shareQuota = int
      signedIdentifiers = [
        {
          accessPolicy = {
            expiryTime = "string"
            permission = "string"
            startTime = "string"
          }
          id = "string"
        }
      ]
    }
  }
}

속성 값

Microsoft.Storage/storageAccounts/fileServices/shares

이름	묘사	값
이름	리소스 이름	문자열 제약 조건: 최소 길이 = 3 최대 길이 = 63(필수)
부모 ID	이 리소스의 부모인 리소스의 ID입니다.	유형의 리소스에 대한 ID: storageAccounts/fileServices
속성	파일 공유의 속성입니다.	fileShareProperties
형	리소스 종류	"Microsoft.Storage/storageAccounts/fileServices/shares@2025-01-01"

액세스정책

이름	묘사	값
만료 시간	액세스 정책의 만료 시간	문자열
허가	약식 사용 권한 목록입니다.	문자열
시작 시간	액세스 정책의 시작 시간	문자열

파일셰어프로퍼티

이름	묘사	값
accessTier	특정 공유에 대한 액세스 계층입니다. GpV2 계정은 TransactionOptimized(기본값), 핫 및 쿨 중에서 선택할 수 있습니다. FileStorage 계정은 프리미엄을 선택할 수 있습니다.	'쿨' '핫' '프리미엄' '트랜잭션 최적화'
enabled프로토콜	파일 공유에 사용되는 인증 프로토콜입니다. 공유를 만들 때만 지정할 수 있습니다.	'NFS' '중소기업'
파일공유지불버스팅	파일 공유 유료 버스팅 속성입니다.	파일공유속성파일공유유료버스팅
메타데이터	공유와 메타데이터로 연결할 이름-값 쌍입니다.	FileSharePropertiesMetadata
프로비저닝된 대역폭Mibps	공유의 프로비전된 대역폭(초당 mebibytes)입니다. 이 속성은 Files Provisioned v2 계정 유형에서 만든 파일 공유에만 해당합니다. 프로비전된 대역폭에 허용되는 최소값과 최대값은 GetFileServiceUsage API 응답을 참조하세요.	정수 (int)
프로비저닝Iops	공유의 프로비전된 IOPS입니다. 이 속성은 Files Provisioned v2 계정 유형에서 만든 파일 공유에만 해당합니다. 프로비전된 IOPS에 허용되는 최소값과 최대값은 GetFileServiceUsage API 응답을 참조하세요.	정수 (int)
root스쿼시	이 속성은 NFS 공유 전용입니다. 기본값은 NoRootSquash입니다.	'올스쿼시' '노루트스쿼시' '루트스쿼시'
shareQuota 공유할당량	프로비전된 공유 크기(기비바이트)입니다. 0보다 크고 5TB(5120)보다 작거나 같아야 합니다. 대용량 파일 공유의 경우 최대 크기는 102400입니다. Files Provisioned v2 계정 유형에서 만든 파일 공유의 경우 허용되는 최소 및 최대 프로비저닝된 스토리지 크기에 대한 GetFileServiceUsage API 응답을 참조하세요.	정수 (int)
서명된식별자	공유에 지정된 저장된 액세스 정책 목록입니다.	서명된 식별자[]

파일공유속성파일공유유료버스팅

이름	묘사	값
유료버스팅활성화	공유에 대해 유료 버스팅을 사용할 수 있는지 여부를 나타냅니다. 이 속성은 Files Provisioned v1 SSD 계정 유형에서 만든 파일 공유에만 해당합니다.	부울
유료버스팅최대 대역폭Mibps	공유에 대한 최대 유료 버스트 대역폭(초당 mebibytes)입니다. 이 속성은 Files Provisioned v1 SSD 계정 유형에서 만든 파일 공유에만 해당합니다. 허용되는 최대 값은 공유에 허용되는 최대 대역폭인 10340입니다.	정수 (int)
유료버스팅MaxIops	공유에 대한 최대 유료 버스트 IOPS입니다. 이 속성은 Files Provisioned v1 SSD 계정 유형에서 만든 파일 공유에만 해당합니다. 허용되는 최대값은 공유에 허용되는 최대 IOPS인 102400입니다.	정수 (int)

파일셰어프로퍼티메타데이터

이름	묘사	값

서명된 식별자

이름	묘사	값
액세스 정책	액세스 정책	액세스정책
아이디	저장된 액세스 정책의 고유 식별자입니다.	문자열