다음을 통해 공유


File Services - Get Service Properties

CORS(원본 간 리소스 공유) 규칙을 포함하여 스토리지 계정의 파일 서비스 속성을 가져옵니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default?api-version=2025-06-01

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
accountName
path True

string

minLength: 3
maxLength: 24
pattern: ^[a-z0-9]+$

지정된 리소스 그룹 내의 스토리지 계정 이름입니다. Storage 계정 이름은 3자에서 24자 사이여야 하고 숫자 및 소문자만 사용해야 합니다.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다.

subscriptionId
path True

string (uuid)

대상 구독의 ID입니다. 값은 UUID여야 합니다.

api-version
query True

string

minLength: 1

이 작업에 사용할 API 버전입니다.

응답

Name 형식 Description
200 OK

FileServiceProperties

Azure 작업이 성공적으로 완료되었습니다.

Other Status Codes

CloudError

예기치 않은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

GetFileServices

샘플 요청

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/fileServices/default?api-version=2025-06-01

샘플 응답

{
  "name": "default",
  "type": "Microsoft.Storage/storageAccounts/fileServices",
  "id": "/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/fileServices/default",
  "properties": {
    "cors": {
      "corsRules": [
        {
          "allowedHeaders": [
            "x-ms-meta-abc",
            "x-ms-meta-data*",
            "x-ms-meta-target*"
          ],
          "allowedMethods": [
            "GET",
            "HEAD",
            "POST",
            "OPTIONS",
            "MERGE",
            "PUT"
          ],
          "allowedOrigins": [
            "http://www.contoso.com",
            "http://www.fabrikam.com"
          ],
          "exposedHeaders": [
            "x-ms-meta-*"
          ],
          "maxAgeInSeconds": 100
        },
        {
          "allowedHeaders": [
            "*"
          ],
          "allowedMethods": [
            "GET"
          ],
          "allowedOrigins": [
            "*"
          ],
          "exposedHeaders": [
            "*"
          ],
          "maxAgeInSeconds": 2
        },
        {
          "allowedHeaders": [
            "x-ms-meta-12345675754564*"
          ],
          "allowedMethods": [
            "GET",
            "PUT"
          ],
          "allowedOrigins": [
            "http://www.abc23.com",
            "https://www.fabrikam.com/*"
          ],
          "exposedHeaders": [
            "x-ms-meta-abc",
            "x-ms-meta-data*",
            "x-ms-meta-target*"
          ],
          "maxAgeInSeconds": 2000
        }
      ]
    }
  },
  "sku": {
    "name": "Standard_GRS",
    "tier": "Standard"
  }
}

정의

Name Description
AllowedMethods
CloudError

Storage 서비스의 오류 응답입니다.

CloudErrorBody

Storage 서비스의 오류 응답입니다.

CorsRule

Blob 서비스에 대한 CORS 규칙을 지정합니다.

CorsRules

CORS 규칙을 설정합니다. 요청에 최대 5개의 CorsRule 요소를 포함할 수 있습니다.

DeleteRetentionPolicy

일시 삭제에 대한 서비스 속성입니다.

EncryptionInTransit

전송 중 암호화 설정.

FileServiceProperties

스토리지 계정의 파일 서비스의 속성입니다.

Multichannel

다중 채널 설정입니다. 프리미엄 FileStorage에만 적용됩니다.

NfsSetting

NFS 프로토콜 설정

ProtocolSettings

파일 서비스에 대한 프로토콜 설정

Sku

스토리지 계정의 SKU입니다.

SkuName

SKU 이름입니다. 계정을 만드는 데 필요합니다. 업데이트에 대한 선택 사항입니다. 이전 버전에서는 SKU 이름을 accountType이라고 했습니다.

SkuTier

SKU 레벨. 이는 SKU 이름을 기반으로 합니다.

SmbSetting

SMB 프로토콜에 대한 설정

AllowedMethods

Description
DELETE
GET
HEAD
MERGE
POST
OPTIONS
PUT
PATCH
CONNECT
TRACE

CloudError

Storage 서비스의 오류 응답입니다.

Name 형식 Description
error

CloudErrorBody

Storage 서비스의 오류 응답입니다.

CloudErrorBody

Storage 서비스의 오류 응답입니다.

Name 형식 Description
code

string

오류의 식별자입니다. 코드는 고정적이며 프로그래밍 방식으로 사용할 수 있습니다.

details

CloudErrorBody[]

오류에 대한 추가 세부 정보 목록입니다.

message

string

사용자 인터페이스에 표시하기에 적합한 오류를 설명하는 메시지입니다.

target

string

특정 오류의 대상입니다. 예를 들어 오류가 발생한 속성의 이름입니다.

CorsRule

Blob 서비스에 대한 CORS 규칙을 지정합니다.

Name 형식 Description
allowedHeaders

string[]

CorsRule 요소가 있는 경우 필수입니다. 원본 간 요청의 일부가 될 수 있는 헤더 목록입니다.

allowedMethods

AllowedMethods[]

CorsRule 요소가 있는 경우 필수입니다. 원본에서 실행할 수 있는 HTTP 메서드 목록입니다.

allowedOrigins

string[]

CorsRule 요소가 있는 경우 필수입니다. CORS를 통해 허용되는 원본 도메인 목록 또는 모든 도메인을 허용하는 "*"입니다.

exposedHeaders

string[]

CorsRule 요소가 있는 경우 필수입니다. CORS 클라이언트에 노출할 응답 헤더 목록입니다.

maxAgeInSeconds

integer (int32)

CorsRule 요소가 있는 경우 필수입니다. 클라이언트/브라우저가 실행 전 응답을 캐시해야 하는 시간(초)입니다.

CorsRules

CORS 규칙을 설정합니다. 요청에 최대 5개의 CorsRule 요소를 포함할 수 있습니다.

Name 형식 Description
corsRules

CorsRule[]

CORS 규칙 목록입니다. 요청에 최대 5개의 CorsRule 요소를 포함할 수 있습니다.

DeleteRetentionPolicy

일시 삭제에 대한 서비스 속성입니다.

Name 형식 Description
allowPermanentDelete

boolean

true로 설정된 경우 이 속성을 사용하면 일시 삭제된 Blob 버전 및 스냅샷을 삭제할 수 있습니다. 이 속성은 Blob 복원 정책을 사용할 수 없습니다. 이 속성은 Blob 서비스에만 적용되며 컨테이너 또는 파일 공유에는 적용되지 않습니다.

days

integer (int32)

minimum: 1
maximum: 365

삭제된 항목을 보존해야 하는 일 수를 나타냅니다. 지정된 최소값은 1이고 최대값은 365일 수 있습니다.

enabled

boolean

DeleteRetentionPolicy를 사용할 수 있는지 여부를 나타냅니다.

EncryptionInTransit

전송 중 암호화 설정.

Name 형식 Description
required

boolean

전송 중 암호화가 필요한지 여부를 나타냅니다.

FileServiceProperties

스토리지 계정의 파일 서비스의 속성입니다.

Name 형식 Description
id

string

리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

리소스의 이름

properties.cors

CorsRules

파일 서비스에 대한 CORS 규칙을 지정합니다. 요청에 최대 5개의 CorsRule 요소를 포함할 수 있습니다. 요청 본문에 CorsRule 요소가 포함되지 않으면 모든 CORS 규칙이 삭제되고 파일 서비스에 대해 CORS가 비활성화됩니다.

properties.protocolSettings

ProtocolSettings

파일 서비스에 대한 프로토콜 설정

properties.shareDeleteRetentionPolicy

DeleteRetentionPolicy

공유 일시 삭제에 대한 파일 서비스 속성입니다.

sku

Sku

SKU 이름 및 계층입니다.

type

string

리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

Multichannel

다중 채널 설정입니다. 프리미엄 FileStorage에만 적용됩니다.

Name 형식 Description
enabled

boolean

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

NfsSetting

NFS 프로토콜 설정

Name 형식 Description
encryptionInTransit

EncryptionInTransit

전송 중 암호화 설정.

ProtocolSettings

파일 서비스에 대한 프로토콜 설정

Name 형식 Description
nfs

NfsSetting

NFS 프로토콜 설정

smb

SmbSetting

SMB 프로토콜에 대한 설정

Sku

스토리지 계정의 SKU입니다.

Name 형식 Description
name

SkuName

SKU 이름입니다. 계정을 만드는 데 필요합니다. 업데이트에 대한 선택 사항입니다. 이전 버전에서는 SKU 이름을 accountType이라고 했습니다.

tier

SkuTier

SKU 레벨. 이는 SKU 이름을 기반으로 합니다.

SkuName

SKU 이름입니다. 계정을 만드는 데 필요합니다. 업데이트에 대한 선택 사항입니다. 이전 버전에서는 SKU 이름을 accountType이라고 했습니다.

Description
Standard_LRS
Standard_GRS
Standard_RAGRS
Standard_ZRS
Premium_LRS
Premium_ZRS
Standard_GZRS
Standard_RAGZRS
StandardV2_LRS
StandardV2_GRS
StandardV2_ZRS
StandardV2_GZRS
PremiumV2_LRS
PremiumV2_ZRS

SkuTier

SKU 레벨. 이는 SKU 이름을 기반으로 합니다.

Description
Standard
Premium

SmbSetting

SMB 프로토콜에 대한 설정

Name 형식 Description
authenticationMethods

string

서버에서 지원하는 SMB 인증 방법입니다. 유효한 값은 NTLMv2, Kerberos입니다. 구분 기호가 ';'인 문자열로 전달되어야 합니다.

channelEncryption

string

서버에서 지원하는 SMB 채널 암호화입니다. 유효한 값은 AES-128-CCM, AES-128-GCM, AES-256-GCM입니다. 구분 기호가 ';'인 문자열로 전달되어야 합니다.

encryptionInTransit

EncryptionInTransit

전송 중 암호화 설정.

kerberosTicketEncryption

string

서버에서 지원하는 Kerberos 티켓 암호화입니다. 유효한 값은 RC4-HMAC, AES-256입니다. 구분 기호가 ';'인 문자열로 전달되어야 합니다.

multichannel

Multichannel

다중 채널 설정입니다. 프리미엄 FileStorage에만 적용됩니다.

versions

string

서버에서 지원하는 SMB 프로토콜 버전입니다. 유효한 값은 SMB2.1, SMB3.0, SMB3.1.1입니다. 구분 기호가 ';'인 문자열로 전달되어야 합니다.