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 |
|---|---|---|---|---|
|
account
|
path | True |
string minLength: 3maxLength: 24 pattern: ^[a-z0-9]+$ |
지정된 리소스 그룹 내의 스토리지 계정 이름입니다. Storage 계정 이름은 3자에서 24자 사이여야 하고 숫자 및 소문자만 사용해야 합니다. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다. |
|
subscription
|
path | True |
string (uuid) |
대상 구독의 ID입니다. 값은 UUID여야 합니다. |
|
api-version
|
query | True |
string minLength: 1 |
이 작업에 사용할 API 버전입니다. |
응답
| Name | 형식 | Description |
|---|---|---|
| 200 OK |
Azure 작업이 성공적으로 완료되었습니다. |
|
| Other Status Codes |
예기치 않은 오류 응답입니다. |
보안
azure_auth
Azure Active Directory OAuth2 흐름.
형식:
oauth2
Flow:
implicit
권한 부여 URL:
https://login.microsoftonline.com/common/oauth2/authorize
범위
| Name | Description |
|---|---|
| user_impersonation | 사용자 계정 가장 |
예제
GetFileServices
샘플 요청
샘플 응답
{
"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 |
|---|---|
|
Allowed |
|
|
Cloud |
Storage 서비스의 오류 응답입니다. |
|
Cloud |
Storage 서비스의 오류 응답입니다. |
|
Cors |
Blob 서비스에 대한 CORS 규칙을 지정합니다. |
|
Cors |
CORS 규칙을 설정합니다. 요청에 최대 5개의 CorsRule 요소를 포함할 수 있습니다. |
|
Delete |
일시 삭제에 대한 서비스 속성입니다. |
|
Encryption |
전송 중 암호화 설정. |
|
File |
스토리지 계정의 파일 서비스의 속성입니다. |
| Multichannel |
다중 채널 설정입니다. 프리미엄 FileStorage에만 적용됩니다. |
|
Nfs |
NFS 프로토콜 설정 |
|
Protocol |
파일 서비스에 대한 프로토콜 설정 |
| Sku |
스토리지 계정의 SKU입니다. |
|
Sku |
SKU 이름입니다. 계정을 만드는 데 필요합니다. 업데이트에 대한 선택 사항입니다. 이전 버전에서는 SKU 이름을 accountType이라고 했습니다. |
|
Sku |
SKU 레벨. 이는 SKU 이름을 기반으로 합니다. |
|
Smb |
SMB 프로토콜에 대한 설정 |
AllowedMethods
| 값 | Description |
|---|---|
| DELETE | |
| GET | |
| HEAD | |
| MERGE | |
| POST | |
| OPTIONS | |
| PUT | |
| PATCH | |
| CONNECT | |
| TRACE |
CloudError
Storage 서비스의 오류 응답입니다.
| Name | 형식 | Description |
|---|---|---|
| error |
Storage 서비스의 오류 응답입니다. |
CloudErrorBody
Storage 서비스의 오류 응답입니다.
| Name | 형식 | Description |
|---|---|---|
| code |
string |
오류의 식별자입니다. 코드는 고정적이며 프로그래밍 방식으로 사용할 수 있습니다. |
| details |
오류에 대한 추가 세부 정보 목록입니다. |
|
| message |
string |
사용자 인터페이스에 표시하기에 적합한 오류를 설명하는 메시지입니다. |
| target |
string |
특정 오류의 대상입니다. 예를 들어 오류가 발생한 속성의 이름입니다. |
CorsRule
Blob 서비스에 대한 CORS 규칙을 지정합니다.
| Name | 형식 | Description |
|---|---|---|
| allowedHeaders |
string[] |
CorsRule 요소가 있는 경우 필수입니다. 원본 간 요청의 일부가 될 수 있는 헤더 목록입니다. |
| allowedMethods |
CorsRule 요소가 있는 경우 필수입니다. 원본에서 실행할 수 있는 HTTP 메서드 목록입니다. |
|
| allowedOrigins |
string[] |
CorsRule 요소가 있는 경우 필수입니다. CORS를 통해 허용되는 원본 도메인 목록 또는 모든 도메인을 허용하는 "*"입니다. |
| exposedHeaders |
string[] |
CorsRule 요소가 있는 경우 필수입니다. CORS 클라이언트에 노출할 응답 헤더 목록입니다. |
| maxAgeInSeconds |
integer (int32) |
CorsRule 요소가 있는 경우 필수입니다. 클라이언트/브라우저가 실행 전 응답을 캐시해야 하는 시간(초)입니다. |
CorsRules
CORS 규칙을 설정합니다. 요청에 최대 5개의 CorsRule 요소를 포함할 수 있습니다.
| Name | 형식 | Description |
|---|---|---|
| corsRules |
Cors |
CORS 규칙 목록입니다. 요청에 최대 5개의 CorsRule 요소를 포함할 수 있습니다. |
DeleteRetentionPolicy
일시 삭제에 대한 서비스 속성입니다.
| Name | 형식 | Description |
|---|---|---|
| allowPermanentDelete |
boolean |
true로 설정된 경우 이 속성을 사용하면 일시 삭제된 Blob 버전 및 스냅샷을 삭제할 수 있습니다. 이 속성은 Blob 복원 정책을 사용할 수 없습니다. 이 속성은 Blob 서비스에만 적용되며 컨테이너 또는 파일 공유에는 적용되지 않습니다. |
| days |
integer (int32) minimum: 1maximum: 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 |
파일 서비스에 대한 CORS 규칙을 지정합니다. 요청에 최대 5개의 CorsRule 요소를 포함할 수 있습니다. 요청 본문에 CorsRule 요소가 포함되지 않으면 모든 CORS 규칙이 삭제되고 파일 서비스에 대해 CORS가 비활성화됩니다. |
|
| properties.protocolSettings |
파일 서비스에 대한 프로토콜 설정 |
|
| properties.shareDeleteRetentionPolicy |
공유 일시 삭제에 대한 파일 서비스 속성입니다. |
|
| sku |
SKU 이름 및 계층입니다. |
|
| type |
string |
리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts" |
Multichannel
다중 채널 설정입니다. 프리미엄 FileStorage에만 적용됩니다.
| Name | 형식 | Description |
|---|---|---|
| enabled |
boolean |
다중 채널이 사용되는지 여부를 나타냅니다. |
NfsSetting
NFS 프로토콜 설정
| Name | 형식 | Description |
|---|---|---|
| encryptionInTransit |
전송 중 암호화 설정. |
ProtocolSettings
파일 서비스에 대한 프로토콜 설정
| Name | 형식 | Description |
|---|---|---|
| nfs |
NFS 프로토콜 설정 |
|
| smb |
SMB 프로토콜에 대한 설정 |
Sku
스토리지 계정의 SKU입니다.
| Name | 형식 | Description |
|---|---|---|
| name |
SKU 이름입니다. 계정을 만드는 데 필요합니다. 업데이트에 대한 선택 사항입니다. 이전 버전에서는 SKU 이름을 accountType이라고 했습니다. |
|
| tier |
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 |
전송 중 암호화 설정. |
|
| kerberosTicketEncryption |
string |
서버에서 지원하는 Kerberos 티켓 암호화입니다. 유효한 값은 RC4-HMAC, AES-256입니다. 구분 기호가 ';'인 문자열로 전달되어야 합니다. |
| multichannel |
다중 채널 설정입니다. 프리미엄 FileStorage에만 적용됩니다. |
|
| versions |
string |
서버에서 지원하는 SMB 프로토콜 버전입니다. 유효한 값은 SMB2.1, SMB3.0, SMB3.1.1입니다. 구분 기호가 ';'인 문자열로 전달되어야 합니다. |