Volumes - Get

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

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

URI 매개 변수

Name In Required Type Description
accountName
path True
  • string

NetApp 계정의 이름

poolName
path True
  • string

용량 풀의 이름

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

resourceGroupName
path True
  • string

리소스 그룹의 이름.

Regex pattern: ^[-\w\._\(\)]+$

subscriptionId
path True
  • string

Microsoft Azure 구독을 고유하게 식별하는 구독 자격 증명입니다. 구독 ID는 모든 서비스 호출에 대한 URI의 파트를 형성합니다.

volumeName
path True
  • string

볼륨의 이름

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

api-version
query True
  • string

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

응답

Name Type Description
200 OK

정상

Other Status Codes

작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation 사용자 계정 가장

예제

Volumes_Get

Sample Request

GET https://management.azure.com/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1/volumes/volume1?api-version=2021-10-01

Sample Response

{
  "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1/volumes/volume1",
  "name": "account1/pool1/volume1",
  "type": "Microsoft.NetApp/netAppAccounts/capacityPools/volumes",
  "location": "eastus",
  "properties": {
    "fileSystemId": "9760acf5-4638-11e7-9bdb-020073ca7778",
    "creationToken": "some-amazing-filepath",
    "usageThreshold": 107374182400,
    "serviceLevel": "Premium",
    "provisioningState": "Succeeded",
    "throughputMibps": 128,
    "subnetId": "/subscriptions/9760acf5-4638-11e7-9bdb-020073ca7778/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/testvnet3/subnets/testsubnet3",
    "networkFeatures": "Standard",
    "networkSiblingSetId": "0f434a03-ce0b-4935-81af-d98652ffb1c4",
    "storageToNetworkProximity": "T2"
  }
}

정의

avsDataStore

avsDataStore

ChownMode

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

DataProtection

DataProtection

enableSubvolumes

볼륨에서 하위 호출 작업을 사용할 수 있는지 여부를 나타내는 플래그

EndpointType

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

ExportPolicy

exportPolicy

exportPolicyRule

볼륨 내보내기 정책 규칙

mountTargetProperties

탑재 대상 속성

NetworkFeatures

네트워크 기능

placementKeyValuePairs

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

replicationObject

복제 속성

ReplicationSchedule

예약

SecurityStyle

볼륨의 보안 스타일,기본 unix, 이중 프로토콜 또는 CIFS 프로토콜에 대 한 ntfs 기본값

ServiceLevel

serviceLevel

volume

볼륨 리소스

volumeBackupProperties

볼륨 백업 속성

volumeSnapshotProperties

볼륨 스냅샷 속성

VolumeStorageToNetworkProximity

네트워크 근접에 대한 스토리지

avsDataStore

avsDataStore

Name Type Description
Disabled
  • string

avsDataStore를 사용할 수 없습니다.

Enabled
  • string

avsDataStore가 사용하도록 설정됨

ChownMode

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

Name Type Description
Restricted
  • string
Unrestricted
  • string

DataProtection

DataProtection

Name Type Description
backup

Backup
백업 속성

replication

복제
복제 속성

snapshot

스냅샷
스냅샷 속성입니다.

enableSubvolumes

볼륨에서 하위 호출 작업을 사용할 수 있는지 여부를 나타내는 플래그

Name Type Description
Disabled
  • string

subvolumes를 사용할 수 없습니다.

Enabled
  • string

subvolumes가 사용하도록 설정됨

EndpointType

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

Name Type Description
dst
  • string
src
  • string

ExportPolicy

exportPolicy

Name Type Description
rules

정책 규칙 내보내기
정책 규칙 내보내기

exportPolicyRule

볼륨 내보내기 정책 규칙

Name Type Default Value Description
allowedClients
  • string

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

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

주문 인덱스

unixReadOnly
  • boolean

읽기 전용 액세스

unixReadWrite
  • boolean

읽기 및 쓰기 액세스

mountTargetProperties

탑재 대상 속성

Name Type Description
fileSystemId
  • string

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

ipAddress
  • string

ipAddress
탑재 대상의 IPv4 주소

mountTargetId
  • string

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

smbServerFqdn
  • string

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

NetworkFeatures

네트워크 기능

Name Type Description
Basic
  • string

기본 네트워크 기능.

Standard
  • string

표준 네트워크 기능.

placementKeyValuePairs

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

Name Type Description
key
  • string

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

value
  • string

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

replicationObject

복제 속성

Name Type Description
endpointType

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

remoteVolumeRegion
  • string

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

remoteVolumeResourceId
  • string

원격 볼륨의 리소스 ID입니다.

replicationId
  • string

Id

replicationSchedule

예약

ReplicationSchedule

예약

Name Type Description
_10minutely
  • string
daily
  • string
hourly
  • string

SecurityStyle

볼륨의 보안 스타일,기본 unix, 이중 프로토콜 또는 CIFS 프로토콜에 대 한 ntfs 기본값

Name Type Description
ntfs
  • string
unix
  • string

ServiceLevel

serviceLevel

Name Type Description
Premium
  • string

Premium 서비스 계층

Standard
  • string

표준 서비스 수준

StandardZRS
  • string

영역 중복 스토리지 서비스 수준

Ultra
  • string

Ultra 서비스 수준

volume

볼륨 리소스

Name Type Default Value Description
etag
  • string

리소스를 업데이트할 때마다 변경되는 고유한 읽기 전용 문자열입니다.

id
  • string

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

location
  • string

리소스가 있는 지리적 위치

name
  • string

리소스의 이름입니다.

properties.avsDataStore Disabled

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

properties.backupId
  • string

백업 ID
백업을 식별하는 데 사용되는 UUID v4 또는 리소스 식별자입니다.

properties.baremetalTenantId
  • string

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

properties.capacityPoolResourceId
  • string

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

properties.cloneProgress
  • integer

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

properties.coolAccess
  • boolean
False

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

properties.coolnessPeriod
  • integer

클라이언트에서 액세스하지 않는 데이터가 계층화되는 후의 일 수를 지정합니다.

properties.creationToken
  • string

만들기 토큰 또는 파일 경로
볼륨에 대한 고유한 파일 경로입니다. 탑재 대상을 만들 때 사용됨

properties.dataProtection

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

properties.defaultGroupQuotaInKiBs
  • integer
0

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

properties.defaultUserQuotaInKiBs
  • integer
0

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

properties.enableSubvolumes Disabled

볼륨에서 하위 명령 작업을 사용할 수 있는지 여부를 나타내는 플래그

properties.encryptionKeySource
  • string

암호화 키 원본입니다. 가능한 값은 'Microsoft.NetApp'입니다.

properties.exportPolicy

exportPolicy
내보내기 정책 규칙 집합

properties.fileSystemId
  • string

FileSystem ID
고유 FileSystem 식별자입니다.

properties.isDefaultQuotaEnabled
  • boolean
False

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

properties.isRestoring
  • boolean

복원 중

properties.kerberosEnabled
  • boolean
False

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

properties.ldapEnabled
  • boolean
False

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

properties.maximumNumberOfFiles
  • integer

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

properties.mountTargets

mountTargets
탑재 대상 목록

properties.networkFeatures Basic

네트워크 기능
볼륨에 사용할 수 있는 기본 네트워크 또는 표준 기능입니다.

properties.networkSiblingSetId
  • string

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

properties.placementRules

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

properties.protocolTypes
  • string[]

protocolTypes
프로토콜 형식 집합, 기본 NFSv3, SMB 프로토콜용 CIFS

properties.provisioningState
  • string

Azure 수명 주기 관리

properties.proximityPlacementGroup
  • string

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

properties.securityStyle unix

볼륨의 보안 스타일, 기본 unix, 이중 프로토콜 또는 CIFS 프로토콜에 대한 기본값은 ntfs입니다.

properties.serviceLevel Premium

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

properties.smbContinuouslyAvailable
  • boolean
False

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

properties.smbEncryption
  • boolean
False

Smb3 데이터에 대한 암호화를 사용하도록 설정합니다. SMB/DualProtocol 볼륨에만 적용됩니다. swagger 버전 2020-08-01 이상에서 사용하려면

properties.snapshotDirectoryVisible
  • boolean
True

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

properties.snapshotId
  • string

스냅샷 ID
스냅샷을 식별하는 데 사용되는 UUID v4 또는 리소스 식별자입니다.

properties.storageToNetworkProximity

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

properties.subnetId
  • string

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

properties.t2Network
  • string

T2 네트워크 정보

properties.throughputMibps
  • number

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

properties.unixPermissions
  • string
0770

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

properties.usageThreshold
  • integer
0

usageThreshold
파일 시스템에 허용되는 최대 스토리지 할당량(바이트)입니다. 경고에만 사용되는 소프트 할당량입니다. 최소 크기는 100GiB입니다. 상한은 100TiB입니다. 바이트 단위로 지정됩니다.

properties.volumeGroupName
  • string

볼륨 그룹 이름

properties.volumeSpecName
  • string

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

properties.volumeType
  • string

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

tags
  • object

리소스 태그입니다.

type
  • string

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

volumeBackupProperties

볼륨 백업 속성

Name Type Description
backupEnabled
  • boolean

백업 사용

backupPolicyId
  • string

백업 정책 리소스 ID

policyEnforced
  • boolean

정책 적용

vaultId
  • string

자격 증명 모음 리소스 ID

volumeSnapshotProperties

볼륨 스냅샷 속성

Name Type Description
snapshotPolicyId
  • string

스냅샷 정책 ResourceId

VolumeStorageToNetworkProximity

네트워크 근접에 대한 스토리지

Name Type Description
Default
  • string

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

T1
  • string

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

T2
  • string

표준 T2 스토리지에서 네트워크 연결로 연결합니다.