Volumes - Get

서비스:
Azure NetApp Files
API 버전:
2026-05-01

지정된 볼륨의 세부 정보 가져오기

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/capacityPools/{poolName}/volumes/{volumeName}?api-version=2026-05-01

URI 매개 변수

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

string

pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,127}$

NetApp 계정의 이름
poolName
 path True

string

minLength: 1
maxLength: 64
pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,63}$

용량 풀의 이름
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

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

string (uuid)

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

string

minLength: 1
maxLength: 64
pattern: ^[a-zA-Z][a-zA-Z0-9\-_]{0,63}$

볼륨의 이름
api-version
 query True

string

minLength: 1

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

응답

Name 형식 Description
200 OK

Volume

Azure 운영이 성공적으로 완료되었습니다.
Other Status Codes

ErrorResponse

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

보안

azure_auth

Azure Active Directory OAuth2 흐름.

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

범위

Name Description
user_impersonation 사용자 계정을 사칭하다

예제

Volumes_Get

샘플 요청

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1/volumes/volume1?api-version=2026-05-01

샘플 응답

상태 코드:
200 
{
  "name": "account1/pool1/volume1",
  "type": "Microsoft.NetApp/netAppAccounts/capacityPools/volumes",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1/volumes/volume1",
  "location": "eastus",
  "properties": {
    "creationToken": "my-unique-file-path",
    "fileSystemId": "9760acf5-4638-11e7-9bdb-020073ca7778",
    "networkFeatures": "Standard",
    "networkSiblingSetId": "0f434a03-ce0b-4935-81af-d98652ffb1c4",
    "provisioningState": "Succeeded",
    "serviceLevel": "Premium",
    "storageToNetworkProximity": "T2",
    "subnetId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/testvnet3/subnets/testsubnet3",
    "throughputMibps": 128,
    "usageThreshold": 107374182400
  }
}

정의

Name Description
AcceptGrowCapacityPoolForShortTermCloneSplit

단기 복제 볼륨을 자동 분할하는 동안 분할 후 상위 풀에 볼륨을 수용할 공간이 충분하지 않으면 자동으로 크기가 조정되어 청구가 증가합니다. 용량 풀 크기 자동 증가를 수락하고 단기 복제 볼륨을 생성하려면 속성을 accepted로 설정합니다.
ActualRansomwareProtectionState

고급 랜섬웨어 보호 기능의 실제 상태
AvsDataStore

볼륨이 AVS(Azure VMware Solution) 데이터 저장소 용도로 사용하도록 설정되는지 여부를 지정합니다
BreakthroughMode

볼륨이 브레이크스루 모드에서 작동하는지 여부를 지정합니다. '사용'으로 설정하면 볼륨이 이 모드에 대해 구성된 리소스에서 실행되어 향상된 성능과 더 높은 처리량을 제공합니다. '사용 안 함'으로 설정하거나 생략하면 볼륨이 기본 구성을 사용합니다. 이 기능은 구성된 지역에서만 사용할 수 있으며 처음 사용하는 사용자는 혁신 모드를 사용하기 전에 온보딩을 완료해야 합니다.
ChownMode

이 매개변수는 파일의 소유권을 변경할 수 있는 권한이 있는 사용자를 지정합니다. 제한 - 루트 사용자만 파일의 소유권을 변경할 수 있습니다. unrestricted - 루트가 아닌 사용자는 자신이 소유한 파일의 소유권을 변경할 수 있습니다.
CoolAccessRetrievalPolicy

coolAccessRetrievalPolicy는 쿨 액세스 지원 볼륨의 읽기 패턴을 기반으로 쿨 계층에서 표준 스토리지로의 데이터 검색 동작을 결정합니다. 이 필드에 사용할 수 있는 값은 다음과 같습니다. 기본값 - 데이터는 임의 읽기 시 쿨 계층에서 표준 스토리지로 가져옵니다. 이 정책은 기본값입니다. OnRead - 모든 클라이언트 기반 데이터 읽기는 순차적 읽기와 임의 읽기 모두에서 쿨 계층에서 표준 스토리지로 끌어온다. Never - 쿨 계층에서 표준 스토리지로 클라이언트 기반 데이터를 끌어오지 않습니다.
CoolAccessTieringPolicy

coolAccessTieringPolicy는 쿨 티어로 이동되는 콜드 데이터 블록을 결정합니다. 이 필드에 사용할 수 있는 값은 자동 - 스냅샷 복사본과 활성 파일 시스템 모두에서 콜드 사용자 데이터 블록을 쿨 계층 계층으로 이동합니다. 이 정책은 기본값입니다. SnapshotOnly - 활성 파일 시스템과 연결되지 않은 볼륨 스냅샷 복사본의 사용자 데이터 블록을 쿨 계층으로 이동합니다.
createdByType

리소스를 만든 ID 유형입니다.
DesiredRansomwareProtectionState

Advanced Ransomware Protection 기능의 원하는 상태
DestinationReplication

대상 복제 속성
EnableSubvolumes

폐기된 볼륨에서 하위 볼륨 연산이 활성화되었는지 여부를 나타내는 플래그입니다. 서브볼륨 연산과 이 플래그는 향후 API 버전에서 제거될 예정입니다.
EncryptionKeySource

볼륨의 데이터를 암호화하는 데 사용되는 키의 원본입니다. NetApp 계정에 encryption.keySource = 'Microsoft.KeyVault'가 있는 경우에 적용됩니다. 가능한 값(대/소문자를 구분하지 않는 값)은 'Microsoft.NetApp, Microsoft.KeyVault'입니다.
EndpointType

로컬 볼륨이 볼륨 복제의 원본인지 대상인지 여부를 나타냅니다.
ErrorAdditionalInfo

리소스 관리 오류 추가 정보
ErrorDetail

오류 세부 정보입니다.
ErrorResponse

오류 응답
ExportPolicyRule

볼륨 내보내기 정책 규칙
ExternalReplicationSetupStatus

외부 복제에만 적용되는 속성입니다. 외부 복제 설정의 상태에 대해 기계가 읽을 수 있는 값을 제공합니다.
FileAccessLogs

볼륨에 있는 활성 진단 설정에 따라 볼륨에 대해 파일 액세스 로그를 사용할 수 있는지 여부를 나타내는 플래그입니다.
MirrorState

복제 상태
MountTargetProperties

탑재 대상 속성
NetworkFeatures

볼륨 또는 현재 업데이트 상태에 사용할 수 있는 네트워크 기능입니다.
PlacementKeyValuePairs

볼륨 그룹에 볼륨 배치를 위한 애플리케이션별 매개 변수
RansomwareProtectionSettings

고급 랜섬웨어 방지 보고서(ARP) 설정
RemotePath

ANF로 마이그레이션할 볼륨의 전체 경로입니다. 마이그레이션 볼륨에 필요
ReplicationObject

복제 속성
ReplicationSchedule

일정
ReplicationType

복제가 영역 간 또는 지역 간인지 여부를 나타냅니다.
SecurityStyle

볼륨의 보안 스타일, 기본 유닉스는 이중 프로토콜 또는 CIFS 프로토콜의 경우 기본적으로 ntfs로 설정됩니다.
ServiceLevel

파일 시스템의 서비스 수준
SmbAccessBasedEnumeration

SMB 공유에 대한 액세스 기반 열거형 공유 속성을 사용하도록 설정합니다. SMB/DualProtocol 볼륨에만 적용
SmbNonBrowsable

SMB 공유에 대해 찾아볼 수 없는 속성을 사용하도록 설정합니다. SMB/DualProtocol 볼륨에만 적용
systemData

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.
Volume

볼륨 리소스
VolumeBackupProperties

볼륨 백업 속성
VolumePropertiesDataProtection

DataProtection 형식 볼륨에는 복제 세부 정보가 포함된 개체가 포함됩니다.
VolumePropertiesExportPolicy

내보내기 정책 규칙 집합
VolumeRelocationProperties

볼륨 재배치 속성
VolumeReplicationRelationshipStatus

볼륨 복제 관계의 상태
VolumeSnapshotProperties

볼륨 스냅샷 속성
VolumeStorageToNetworkProximity

볼륨에 대한 네트워크 근접 정보에 스토리지를 제공합니다.

AcceptGrowCapacityPoolForShortTermCloneSplit

열거형

단기 복제 볼륨을 자동 분할하는 동안 분할 후 상위 풀에 볼륨을 수용할 공간이 충분하지 않으면 자동으로 크기가 조정되어 청구가 증가합니다. 용량 풀 크기 자동 증가를 수락하고 단기 복제 볼륨을 생성하려면 속성을 accepted로 설정합니다.

값 Description
Accepted

단기 복제 분할을 위한 자동 증가 용량 풀이 허용됩니다.
Declined

단기 클론 분할을 위한 자동 증가 용량 풀이 거부됩니다. 단기 복제 볼륨 생성은 허용되지 않으며, 단기 복제 볼륨을 만들려면 자동 증가 용량 풀을 허용합니다.

ActualRansomwareProtectionState

열거형

고급 랜섬웨어 보호 기능의 실제 상태

값 Description
Disabled

고급 랜섬웨어 방지가 비활성화되었습니다.
Enabled

고급 랜섬웨어 보호가 활성화되었습니다.
Learning

Advanced Ransomware Protection이 학습 모드에 있습니다.
Paused

Advanced Ransomware Protection이 일시 중지된 상태입니다.

AvsDataStore

열거형

볼륨이 AVS(Azure VMware Solution) 데이터 저장소 용도로 사용하도록 설정되는지 여부를 지정합니다

값 Description
Enabled

avsDataStore가 사용하도록 설정됨
Disabled

avsDataStore를 사용할 수 없습니다.

BreakthroughMode

열거형

볼륨이 브레이크스루 모드에서 작동하는지 여부를 지정합니다. '사용'으로 설정하면 볼륨이 이 모드에 대해 구성된 리소스에서 실행되어 향상된 성능과 더 높은 처리량을 제공합니다. '사용 안 함'으로 설정하거나 생략하면 볼륨이 기본 구성을 사용합니다. 이 기능은 구성된 지역에서만 사용할 수 있으며 처음 사용하는 사용자는 혁신 모드를 사용하기 전에 온보딩을 완료해야 합니다.

값 Description
Enabled

볼륨은 일관된 고성능과 더 높은 처리량을 보장하는 Breakthrough 모드에 대해 구성된 리소스에서 실행됩니다.
Disabled

볼륨은 기본 성능 및 처리량을 제공하는 구성을 사용합니다.

ChownMode

열거형

이 매개변수는 파일의 소유권을 변경할 수 있는 권한이 있는 사용자를 지정합니다. 제한 - 루트 사용자만 파일의 소유권을 변경할 수 있습니다. unrestricted - 루트가 아닌 사용자는 자신이 소유한 파일의 소유권을 변경할 수 있습니다.

값 Description
Restricted
Unrestricted

CoolAccessRetrievalPolicy

열거형

coolAccessRetrievalPolicy는 쿨 액세스 지원 볼륨의 읽기 패턴을 기반으로 쿨 계층에서 표준 스토리지로의 데이터 검색 동작을 결정합니다. 이 필드에 사용할 수 있는 값은 다음과 같습니다. 기본값 - 데이터는 임의 읽기 시 쿨 계층에서 표준 스토리지로 가져옵니다. 이 정책은 기본값입니다. OnRead - 모든 클라이언트 기반 데이터 읽기는 순차적 읽기와 임의 읽기 모두에서 쿨 계층에서 표준 스토리지로 끌어온다. Never - 쿨 계층에서 표준 스토리지로 클라이언트 기반 데이터를 끌어오지 않습니다.

값 Description
Default
OnRead
Never

CoolAccessTieringPolicy

열거형

coolAccessTieringPolicy는 쿨 티어로 이동되는 콜드 데이터 블록을 결정합니다. 이 필드에 사용할 수 있는 값은 자동 - 스냅샷 복사본과 활성 파일 시스템 모두에서 콜드 사용자 데이터 블록을 쿨 계층 계층으로 이동합니다. 이 정책은 기본값입니다. SnapshotOnly - 활성 파일 시스템과 연결되지 않은 볼륨 스냅샷 복사본의 사용자 데이터 블록을 쿨 계층으로 이동합니다.

값 Description
Auto
SnapshotOnly

createdByType

열거형

리소스를 만든 ID 유형입니다.

값 Description
User
Application
ManagedIdentity
Key

DesiredRansomwareProtectionState

열거형

Advanced Ransomware Protection 기능의 원하는 상태

값 Description
Disabled

고급 랜섬웨어 방지가 비활성화되었습니다.
Enabled

고급 랜섬웨어 보호가 활성화되었습니다.

DestinationReplication

Object

대상 복제 속성

Name 형식 Description
region

string

대상 볼륨의 원격 지역입니다.
replicationType

ReplicationType

복제가 영역 간 또는 지역 간인지 여부를 나타냅니다.
resourceId

string (arm-id)

원격 볼륨의 리소스 ID
zone

string

대상 볼륨의 원격 영역입니다.

EnableSubvolumes

열거형

폐기된 볼륨에서 하위 볼륨 연산이 활성화되었는지 여부를 나타내는 플래그입니다. 서브볼륨 연산과 이 플래그는 향후 API 버전에서 제거될 예정입니다.

값 Description
Enabled

하위 명령이 사용하도록 설정됨
Disabled

하위 함수를 사용할 수 없습니다.

EncryptionKeySource

열거형

볼륨의 데이터를 암호화하는 데 사용되는 키의 원본입니다. NetApp 계정에 encryption.keySource = 'Microsoft.KeyVault'가 있는 경우에 적용됩니다. 가능한 값(대/소문자를 구분하지 않는 값)은 'Microsoft.NetApp, Microsoft.KeyVault'입니다.

값 Description
Microsoft.NetApp

Microsoft 관리형 키 암호화
Microsoft.KeyVault

고객 관리형 키 암호화

EndpointType

열거형

로컬 볼륨이 볼륨 복제의 원본인지 대상인지 여부를 나타냅니다.

값 Description
src
dst

ErrorAdditionalInfo

Object

리소스 관리 오류 추가 정보

Name 형식 Description
info

object

추가 정보입니다.
type

string

추가 정보 유형입니다.

ErrorDetail

Object

오류 세부 정보입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보
code

string

오류 코드입니다.
details

ErrorDetail[]

오류 세부 정보입니다.
message

string

오류 메시지입니다.
target

string

오류 대상.

ErrorResponse

Object

오류 응답

Name 형식 Description
error

ErrorDetail

오류 개체입니다.

ExportPolicyRule

Object

볼륨 내보내기 정책 규칙

Name 형식 Default value Description
allowedClients

string

IPv4 CIDR, IPv4 호스트 주소 및 호스트 이름을 사용하여 쉼표로 구분된 문자열로 클라이언트 수신 사양
chownMode

ChownMode

Restricted

이 매개변수는 파일의 소유권을 변경할 수 있는 권한이 있는 사용자를 지정합니다. 제한 - 루트 사용자만 파일의 소유권을 변경할 수 있습니다. unrestricted - 루트가 아닌 사용자는 자신이 소유한 파일의 소유권을 변경할 수 있습니다.
cifs

boolean

CIFS 프로토콜 허용
hasRootAccess

boolean

True

볼륨에 대한 루트 액세스 권한이 있습니다.
kerberos5ReadOnly

boolean

False

Kerberos5 읽기 전용 액세스입니다. swagger 버전 2020-05-01 이상에서 사용하려면
kerberos5ReadWrite

boolean

False

Kerberos5 읽기 및 쓰기 권한입니다. swagger 버전 2020-05-01 이상에서 사용하려면
kerberos5iReadOnly

boolean

False

Kerberos5i 읽기 전용 액세스 권한입니다. swagger 버전 2020-05-01 이상에서 사용하려면
kerberos5iReadWrite

boolean

False

Kerberos5i 읽기 및 쓰기 권한입니다. swagger 버전 2020-05-01 이상에서 사용하려면
kerberos5pReadOnly

boolean

False

Kerberos5p 읽기 전용 액세스입니다. swagger 버전 2020-05-01 이상에서 사용하려면
kerberos5pReadWrite

boolean

False

Kerberos5p 읽기 및 쓰기 권한입니다. swagger 버전 2020-05-01 이상에서 사용하려면
nfsv3

boolean

NFSv3 프로토콜을 허용합니다. NFSv3 형식 볼륨에 대해서만 사용
nfsv41

boolean

NFSv4.1 프로토콜을 허용합니다. NFSv4.1 형식 볼륨에 대해서만 사용
ruleIndex

integer (int32)

주문 인덱스
unixReadOnly

boolean

읽기 전용 액세스
unixReadWrite

boolean

읽기 및 쓰기 액세스

ExternalReplicationSetupStatus

열거형

외부 복제에만 적용되는 속성입니다. 외부 복제 설정의 상태에 대해 기계가 읽을 수 있는 값을 제공합니다.

값 Description
ClusterPeerRequired

'peerExternalCluster' 작업을 사용하여 클러스터를 피어링해야 합니다.
ClusterPeerPending

설정을 진행하기 전에 클러스터에서 피어링을 수락해야 합니다
VServerPeerRequired

외부 복제 설정을 완료하려면 클러스터에서 'authorizeExternalReplication'을 호출하고 반환된 'vserver peer accept' 명령을 수락해야 합니다
ReplicationCreateRequired

외부 복제 설정을 완료하려면 'authorizeExternalReplication'을 호출해야 합니다.
NoActionRequired

외부 복제 설정이 완료되었으므로 이제 복제 상태의 'mirrorState'를 모니터링하여 복제 상태를 확인할 수 있습니다

FileAccessLogs

열거형

볼륨에 있는 활성 진단 설정에 따라 볼륨에 대해 파일 액세스 로그를 사용할 수 있는지 여부를 나타내는 플래그입니다.

값 Description
Enabled

fileAccessLogs를 사용하도록 설정됨
Disabled

fileAccessLogs를 사용할 수 없습니다.

MirrorState

열거형

복제 상태

값 Description
Uninitialized
Mirrored
Broken

MountTargetProperties

Object

탑재 대상 속성

Name 형식 Description
fileSystemId

string

minLength: 36
maxLength: 36
pattern: ^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$

MountTarget을 식별하는 데 사용되는 UUID v4
ipAddress

string

탑재 대상의 IPv4 주소
mountTargetId

string

minLength: 36
maxLength: 36
pattern: ^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$

MountTarget을 식별하는 데 사용되는 UUID v4
smbServerFqdn

string

SMB 서버의 정규화된 도메인 이름 FQDN

NetworkFeatures

열거형

볼륨 또는 현재 업데이트 상태에 사용할 수 있는 네트워크 기능입니다.

값 Description
Basic

기본 네트워크 기능.
Standard

표준 네트워크 기능.
Basic_Standard

기본에서 표준 네트워크 기능으로 업데이트합니다.
Standard_Basic

표준에서 기본 네트워크 기능으로 업데이트합니다.

PlacementKeyValuePairs

Object

볼륨 그룹에 볼륨 배치를 위한 애플리케이션별 매개 변수

Name 형식 Description
key

string

볼륨 그룹에 볼륨을 배치하기 위한 애플리케이션별 매개 변수의 키
value

string

볼륨 그룹에 볼륨을 배치하기 위한 애플리케이션별 매개 변수의 값

RansomwareProtectionSettings

Object

고급 랜섬웨어 방지 보고서(ARP) 설정

Name 형식 Description
actualRansomwareProtectionState

ActualRansomwareProtectionState

볼륨에서 현재 활성 상태인 Advanced Ransomware Protection 기능의 실제 상태
desiredRansomwareProtectionState

DesiredRansomwareProtectionState

볼륨에서 사용할 수 있는 고급 랜섬웨어 방지 기능 상태의 원하는 값

RemotePath

Object

ANF로 마이그레이션할 볼륨의 전체 경로입니다. 마이그레이션 볼륨에 필요

Name 형식 Description
externalHostName

string

ONTAP 호스트에 대한 경로
serverName

string

ONTAP 호스트의 서버 이름
volumeName

string

서버의 볼륨 이름

ReplicationObject

Object

복제 속성

Name 형식 Description
destinationReplications

DestinationReplication[]

대상 복제 목록
endpointType

EndpointType

로컬 볼륨이 볼륨 복제의 원본인지 대상인지 여부를 나타냅니다.
externalReplicationSetupInfo

string

외부 복제 설정을 완료하기 위한 다음 단계에 대한 사람이 읽을 수 있는 지침이 포함되어 있습니다.
externalReplicationSetupStatus

ExternalReplicationSetupStatus

외부 복제에만 적용되는 속성입니다. 외부 복제 설정의 상태에 대해 기계가 읽을 수 있는 값을 제공합니다.
mirrorState

MirrorState

mirror state 속성은 복제에 대한 데이터 복제의 현재 상태를 설명합니다. 데이터가 적극적으로 미러링되고 있는지, 복제 프로세스가 일시 중지되었는지 또는 아직 초기화되지 않았는지에 대한 통찰력을 제공합니다.
relationshipStatus

VolumeReplicationRelationshipStatus

볼륨 복제의 상태
remotePath

RemotePath

ANF로 마이그레이션할 볼륨의 전체 경로입니다. 마이그레이션 볼륨에 필요
remoteVolumeRegion

string

볼륨 복제의 다른 쪽 끝에 대한 원격 지역입니다.
remoteVolumeResourceId

string

원격 볼륨의 리소스 ID입니다. 지역 간 및 영역 간 복제에 필요
replicationId

string

아이디
replicationSchedule

ReplicationSchedule

일정

ReplicationSchedule

열거형

일정

값 Description
_10minutely
hourly
daily

ReplicationType

열거형

복제가 영역 간 또는 지역 간인지 여부를 나타냅니다.

값 Description
CrossRegionReplication

지역 간 복제
CrossZoneReplication

영역 간 복제

SecurityStyle

열거형

볼륨의 보안 스타일, 기본 유닉스는 이중 프로토콜 또는 CIFS 프로토콜의 경우 기본적으로 ntfs로 설정됩니다.

값 Description
ntfs
unix

ServiceLevel

열거형

파일 시스템의 서비스 수준

값 Description
Standard

표준 서비스 수준
Premium

Premium 서비스 계층
Ultra

Ultra 서비스 수준
StandardZRS

영역 중복 스토리지 서비스 수준입니다. 이 기능은 곧 더 이상 사용되지 않습니다.
Flexible

유연한 서비스 수준

SmbAccessBasedEnumeration

열거형

SMB 공유에 대한 액세스 기반 열거형 공유 속성을 사용하도록 설정합니다. SMB/DualProtocol 볼륨에만 적용

값 Description
Disabled

smbAccessBasedEnumeration 공유 설정이 비활성화됨
Enabled

smbAccessBasedEnumeration 공유 설정이 사용하도록 설정됨

SmbNonBrowsable

열거형

SMB 공유에 대해 찾아볼 수 없는 속성을 사용하도록 설정합니다. SMB/DualProtocol 볼륨에만 적용

값 Description
Disabled

smbNonBrowsable 공유 설정이 비활성화됨
Enabled

smbNonBrowsable 공유 설정이 사용됨

systemData

Object

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name 형식 Description
createdAt

string (date-time)

리소스 만들기의 타임스탬프(UTC)입니다.
createdBy

string

리소스를 만든 ID입니다.
createdByType

createdByType

리소스를 만든 ID 유형입니다.
lastModifiedAt

string (date-time)

리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy

string

리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType

createdByType

리소스를 마지막으로 수정한 ID의 형식입니다.

Volume

Object

볼륨 리소스

Name 형식 Default value Description
etag

string

"etag가 응답 본문에 제공되면 일반 etag 규칙에 따라 헤더로 제공될 수도 있습니다. 엔터티 태그는 동일한 요청된 리소스에서 둘 이상의 엔터티를 비교하는 데 사용됩니다. HTTP/1.1은 etag(섹션 14.19), If-Match(섹션 14.24), If-None-Match(섹션 14.26) 및 If-Range(섹션 14.27) 헤더 필드에서 엔터티 태그를 사용합니다.")
id

string (arm-id)

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

string

리소스가 있는 지리적 위치
name

string

리소스의 이름
properties.acceptGrowCapacityPoolForShortTermCloneSplit

AcceptGrowCapacityPoolForShortTermCloneSplit

단기 복제 볼륨을 자동 분할하는 동안 분할 후 상위 풀에 볼륨을 수용할 공간이 충분하지 않으면 자동으로 크기가 조정되어 청구가 증가합니다. 용량 풀 크기 자동 증가를 수락하고 단기 복제 볼륨을 생성하려면 속성을 accepted로 설정합니다.
properties.actualThroughputMibps

number (float)

크기 및 serviceLevel을 기반으로 계산된 자동 qosType 볼륨에 대한 실제 처리량(MiB/s)
properties.avsDataStore

AvsDataStore

Disabled

볼륨이 AVS(Azure VMware Solution) 데이터 저장소 용도로 사용하도록 설정되는지 여부를 지정합니다
properties.backupId

string (arm-id)

백업을 식별하는 데 사용되는 리소스 식별자입니다.
properties.baremetalTenantId

string

고유 Baremetal 테넌트 식별자입니다.
properties.breakthroughMode

BreakthroughMode

볼륨이 브레이크스루 모드에서 작동하는지 여부를 지정합니다.
properties.capacityPoolResourceId

string

볼륨 그룹을 통해 볼륨을 만드는 경우에 사용되는 풀 리소스 ID
properties.cloneProgress

integer (int32)

볼륨이 다른 볼륨의 스냅샷에서 복원되는 경우 이 복제 프로세스의 완료율을 표시합니다. 이 값이 비어 있거나 null이면 현재 이 볼륨에서 발생하는 복제 프로세스가 없습니다. 이 값은 복제하는 동안 5분마다 업데이트됩니다.
properties.coolAccess

boolean

False

볼륨에 쿨 액세스(계층화)를 사용할 수 있는지 여부를 지정합니다.
properties.coolAccessRetrievalPolicy

CoolAccessRetrievalPolicy

coolAccessRetrievalPolicy는 쿨 액세스 지원 볼륨의 읽기 패턴을 기반으로 쿨 계층에서 표준 스토리지로의 데이터 검색 동작을 결정합니다. 이 필드에 사용할 수 있는 값은 다음과 같습니다. 기본값 - 데이터는 임의 읽기 시 쿨 계층에서 표준 스토리지로 가져옵니다. 이 정책은 기본값입니다. OnRead - 모든 클라이언트 기반 데이터 읽기는 순차적 읽기와 임의 읽기 모두에서 쿨 계층에서 표준 스토리지로 끌어온다. Never - 쿨 계층에서 표준 스토리지로 클라이언트 기반 데이터를 끌어오지 않습니다.
properties.coolAccessTieringPolicy

CoolAccessTieringPolicy

coolAccessTieringPolicy는 쿨 티어로 이동되는 콜드 데이터 블록을 결정합니다. 이 필드에 사용할 수 있는 값은 자동 - 스냅샷 복사본과 활성 파일 시스템 모두에서 콜드 사용자 데이터 블록을 쿨 계층 계층으로 이동합니다. 이 정책은 기본값입니다. SnapshotOnly - 활성 파일 시스템과 연결되지 않은 볼륨 스냅샷 복사본의 사용자 데이터 블록을 쿨 계층으로 이동합니다.
properties.coolnessPeriod

integer (int32)

minimum: 2
maximum: 183

클라이언트에서 액세스하지 않는 데이터를 계층화할 일 수를 지정합니다.
properties.creationToken

string

minLength: 1
maxLength: 80
pattern: ^[a-zA-Z][a-zA-Z0-9\-_]{0,79}$

볼륨에 대한 고유한 파일 경로입니다. 탑재 대상을 만들 때 사용됨
properties.dataProtection

VolumePropertiesDataProtection

DataProtection 형식 볼륨에는 복제 세부 정보가 포함된 개체가 포함됩니다.
properties.dataStoreResourceId

string[]

데이터 저장소 리소스 고유 식별자
properties.defaultGroupQuotaInKiBs

integer (int64)

0

KiBs의 볼륨에 대한 기본 그룹 할당량입니다. isDefaultQuotaEnabled가 설정된 경우 최소값 4KiB가 적용됩니다.
properties.defaultUserQuotaInKiBs

integer (int64)

0

KiB의 볼륨에 대한 기본 사용자 할당량입니다. isDefaultQuotaEnabled가 설정되면 최소값 4KiB가 적용됩니다.
properties.deleteBaseSnapshot

boolean

사용(true)이면 볼륨 만들기 작업이 완료된 후 볼륨을 만든 스냅샷이 자동으로 삭제됩니다. 기본값은 false입니다.
properties.effectiveNetworkFeatures

NetworkFeatures

Basic

볼륨에 사용할 수 있는 네트워크 기능 유형 또는 현재 유효 업데이트 상태의 유효 값입니다.
properties.enableSubvolumes

EnableSubvolumes

Disabled

폐기된 볼륨에서 하위 볼륨 연산이 활성화되었는지 여부를 나타내는 플래그입니다. 서브볼륨 연산과 이 플래그는 향후 API 버전에서 제거될 예정입니다.
properties.encrypted

boolean

볼륨이 암호화되었는지 여부를 지정합니다. 2022-01-01 이후 생성되거나 업데이트된 볼륨에서만 사용할 수 있습니다.
properties.encryptionKeySource

EncryptionKeySource

Microsoft.NetApp

볼륨의 데이터를 암호화하는 데 사용되는 키의 원본입니다. NetApp 계정에 encryption.keySource = 'Microsoft.KeyVault'가 있는 경우에 적용됩니다. 가능한 값(대/소문자를 구분하지 않는 값)은 'Microsoft.NetApp, Microsoft.KeyVault'입니다.
properties.exportPolicy

VolumePropertiesExportPolicy

내보내기 정책 규칙 집합
properties.fileAccessLogs

FileAccessLogs

Disabled

볼륨에 있는 활성 진단 설정에 따라 볼륨에 대해 파일 액세스 로그를 사용할 수 있는지 여부를 나타내는 플래그입니다.
properties.fileSystemId

string

minLength: 36
maxLength: 36
pattern: ^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$

고유한 FileSystem 식별자입니다.
properties.inheritedSizeInBytes

integer (int64)

상위 볼륨이 있는 단기 복제 볼륨이 공유하는 공간(바이트)입니다.
properties.isDefaultQuotaEnabled

boolean

False

볼륨에 대해 기본 할당량을 사용할 수 있는지를 지정합니다.
properties.isLargeVolume

boolean

False

볼륨이 큰 볼륨인지 일반 볼륨인지를 지정합니다.
properties.isRestoring

boolean

복원
properties.kerberosEnabled

boolean

False

볼륨이 KerberosEnabled인지 설명합니다. swagger 버전 2020-05-01 이상에서 사용하려면
properties.keyVaultPrivateEndpointResourceId

string

KeyVault에 대한 프라이빗 엔드포인트의 리소스 ID입니다. 볼륨과 동일한 VNET에 있어야 합니다. encryptionKeySource = 'Microsoft.KeyVault'인 경우에만 적용됩니다.
properties.ldapEnabled

boolean

False

지정된 NFS 볼륨에 대해 LDAP를 사용할지 여부를 지정합니다.
properties.maximumNumberOfFiles

integer (int64)

허용되는 최대 파일 수입니다. 변경하려면 서비스 요청이 필요합니다. 볼륨 할당량이 4TiB를 초과하는 경우에만 변경할 수 있습니다.
properties.mountTargets

MountTargetProperties[]

탑재 대상 목록
properties.networkFeatures

NetworkFeatures

Basic

생성 당시 볼륨에서 사용할 수 있는 네트워크 기능 유형의 원래 값입니다.
properties.networkSiblingSetId

string

minLength: 36
maxLength: 36
pattern: ^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$

네트워킹 리소스를 공유하는 볼륨 그룹에 대한 네트워크 형제 집합 ID입니다.
properties.originatingResourceId

string

볼륨이 복원되는 스냅샷 또는 백업의 ID입니다.
properties.placementRules

PlacementKeyValuePairs[]

특정 볼륨에 대한 애플리케이션별 배치 규칙
properties.protocolTypes

string[]

프로토콜 형식 집합, 기본 NFSv3, SMB 프로토콜용 CIFS
properties.provisionedAvailabilityZone

string

볼륨이 프로비전되는 가용성 영역입니다. 볼륨이 있는 논리 가용성 영역을 참조합니다.
properties.provisioningState

string

Azure 수명 주기 관리
properties.proximityPlacementGroup

string

볼륨과 연결된 근접 배치 그룹
properties.securityStyle

SecurityStyle

unix

볼륨의 보안 스타일, 기본 유닉스는 이중 프로토콜 또는 CIFS 프로토콜의 경우 기본적으로 ntfs로 설정됩니다.
properties.serviceLevel

ServiceLevel

Premium

파일 시스템의 서비스 수준
properties.smbAccessBasedEnumeration

SmbAccessBasedEnumeration

SMB 공유에 대한 액세스 기반 열거형 공유 속성을 사용하도록 설정합니다. SMB/DualProtocol 볼륨에만 적용
properties.smbContinuouslyAvailable

boolean

False

smb 볼륨에 대해 지속적으로 사용 가능한 공유 속성을 사용하도록 설정합니다. SMB 볼륨에만 적용
properties.smbEncryption

boolean

False

전송 중인 smb3 데이터에 대한 암호화를 활성화합니다. SMB/DualProtocol 볼륨에만 적용됩니다. swagger 버전 2020-08-01 이상에서 사용하려면
properties.smbNonBrowsable

SmbNonBrowsable

SMB 공유에 대해 찾아볼 수 없는 속성을 사용하도록 설정합니다. SMB/DualProtocol 볼륨에만 적용
properties.snapshotDirectoryVisible

boolean

True

사용(true)이면 볼륨에 각 볼륨의 스냅샷에 대한 액세스를 제공하는 읽기 전용 스냅샷 디렉터리가 포함됩니다(기본값은 true).
properties.snapshotId

string (arm-id)

스냅샷을 식별하는 데 사용되는 리소스 식별자입니다.
properties.storageToNetworkProximity

VolumeStorageToNetworkProximity

볼륨에 대한 네트워크 근접 정보에 스토리지를 제공합니다.
properties.subnetId

string

위임된 서브넷에 대한 Azure Resource URI입니다. 위임 Microsoft.NetApp/volumes가 있어야 합니다.
properties.t2Network

string

T2 네트워크 정보
properties.throughputMibps

number (float)

이 볼륨에서 달성할 수 있는 MiB/s의 최대 처리량이며 수동 qosType 볼륨에 대해서만 입력으로 허용됩니다.
properties.unixPermissions

string

minLength: 4
maxLength: 4

NFS 볼륨에 대한 UNIX 권한은 8진수 4자리 형식으로 허용됩니다. 첫 번째 숫자는 집합 사용자 ID(4), 집합 그룹 ID(2) 및 고정(1) 특성을 선택합니다. 두 번째 숫자는 파일 소유자에 대한 사용 권한을 선택합니다. 읽기(4), 쓰기(2) 및 실행(1). 세 번째는 동일한 그룹의 다른 사용자에 대한 사용 권한을 선택합니다. 그룹에 없는 다른 사용자의 경우 네 번째입니다. 0755 - 소유자에게 읽기/쓰기/실행 권한을 부여하고 그룹 및 기타 사용자에게 읽기/실행 권한을 부여합니다.
properties.usageThreshold

integer (int64)

minimum: 53687091200
maximum: 2638827906662400 		0

파일 시스템에 허용되는 최대 스토리지 할당량(바이트)입니다. 경고에만 사용되는 소프트 할당량입니다. 일반 볼륨의 경우 유효한 값은 50GiB에서 100TiB 범위입니다. 대용량의 경우 유효한 값은 100TiB에서 500TiB 범위이며 예외적으로 2400GiB에서 2400TiB까지입니다. 바이트 단위로 1GiB의 배수로 표현되는 값입니다.
properties.volumeGroupName

string

볼륨 그룹 이름
properties.volumeSpecName

string

볼륨 사양 이름은 데이터, 로그와 같은 볼륨 그룹의 특정 볼륨에 대한 애플리케이션별 지정 또는 식별자입니다.
properties.volumeType

string

이 볼륨의 유형은 무엇인가요? 지역 간 복제의 대상 볼륨의 경우 형식을 DataProtection으로 설정합니다. 복제 볼륨을 만들려면 형식을 ShortTermClone으로 설정합니다.
systemData

systemData

createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.
tags

object

리소스 태그.
type

string

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

string[]

가용성 영역입니다.

VolumeBackupProperties

Object

볼륨 백업 속성

Name 형식 Description
backupPolicyId

string (arm-id)

백업 정책 리소스 ID
backupVaultId

string (arm-id)

Backup 자격 증명 모음 리소스 ID
policyEnforced

boolean

정책 적용

VolumePropertiesDataProtection

Object

DataProtection 형식 볼륨에는 복제 세부 정보가 포함된 개체가 포함됩니다.

Name 형식 Description
backup

VolumeBackupProperties

Backup 속성
ransomwareProtection

RansomwareProtectionSettings

고급 랜섬웨어 보호 설정
replication

ReplicationObject

복제 속성
snapshot

VolumeSnapshotProperties

스냅샷 속성입니다.
volumeRelocation

VolumeRelocationProperties

VolumeRelocation 속성

VolumePropertiesExportPolicy

Object

내보내기 정책 규칙 집합

Name 형식 Description
rules

ExportPolicyRule[]

정책 규칙 내보내기

VolumeRelocationProperties

Object

볼륨 재배치 속성

Name 형식 Description
readyToBeFinalized

boolean

재배치가 완료되어 정리할 준비가 되었습니다.
relocationRequested

boolean

이 볼륨에 대한 재배치가 요청되었습니다.

VolumeReplicationRelationshipStatus

열거형

볼륨 복제 관계의 상태

값 Description
Idle
Transferring

VolumeSnapshotProperties

Object

볼륨 스냅샷 속성

Name 형식 Description
snapshotPolicyId

string

스냅샷 정책 ResourceId

VolumeStorageToNetworkProximity

열거형

볼륨에 대한 네트워크 근접 정보에 스토리지를 제공합니다.

값 Description
Default

네트워크 연결에 대한 기본 스토리지입니다.
T1

네트워크 연결에 대한 표준 T1 스토리지입니다.
T2

네트워크 연결에 대한 표준 T2 스토리지입니다.
AcrossT2

표준 AcrossT2 스토리지에서 네트워크 연결로.