Volumes - Get

Popis svazku
Získání podrobností o zadaném svazku

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

Parametry identifikátoru URI

Name In Required Type Description
accountName
path True
  • string

Název účtu NetApp

poolName
path True
  • string

Název fondu kapacity

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

resourceGroupName
path True
  • string

Název skupiny prostředků.

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

subscriptionId
path True
  • string

Přihlašovací údaje předplatného, které jednoznačně identifikují předplatné Microsoft Azure. ID předplatného tvoří součást identifikátoru URI pro každé volání služby.

volumeName
path True
  • string

Název svazku

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

api-version
query True
  • string

Verze rozhraní API, která se má použít pro tuto operaci.

Odpovědi

Name Type Description
200 OK

OK

Other Status Codes

Odpověď na chybu popisující, proč operace selhala.

Zabezpečení

azure_auth

Tok OAuth2 v Azure Active Directory

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

Scopes

Name Description
user_impersonation zosobnění uživatelského účtu

Příklady

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"
  }
}

Definice

avsDataStore

avsDataStore

ChownMode

Tento parametr určuje, kdo má oprávnění změnit vlastnictví souboru. restricted – Vlastnictví souboru může změnit pouze kořenový uživatel. bez omezení – uživatelé, kteří nejsou rooty, můžou změnit vlastnictví souborů, které vlastní.

DataProtection

Ochrana dat

enableSubvolumes

Příznak označující, jestli jsou na svazku povoleny operace podvolumu

EndpointType

Určuje, jestli je místní svazek zdrojem nebo cílem replikace svazku.

ExportPolicy

exportPolicy

exportPolicyRule

Pravidlo zásad exportu svazku

mountTargetProperties

Vlastnosti cíle připojení

NetworkFeatures

Síťové funkce

placementKeyValuePairs

Parametry specifické pro aplikaci pro umístění svazků ve skupině svazků

replicationObject

Vlastnosti replikace

ReplicationSchedule

Plán

SecurityStyle

Styl zabezpečení svazku, výchozí unix, výchozí hodnota ntfs pro duální protokol nebo CIFS

ServiceLevel

serviceLevel

volume

Prostředek svazku

volumeBackupProperties

Vlastnosti zálohování svazku

volumeSnapshotProperties

Vlastnosti snímku svazku

VolumeStorageToNetworkProximity

Blízkost úložiště k síti

avsDataStore

avsDataStore

Name Type Description
Disabled
  • string

avsDataStore je zakázané.

Enabled
  • string

avsDataStore je povolené.

ChownMode

Tento parametr určuje, kdo má oprávnění změnit vlastnictví souboru. restricted – Vlastnictví souboru může změnit pouze kořenový uživatel. bez omezení – uživatelé, kteří nejsou rooty, můžou změnit vlastnictví souborů, které vlastní.

Name Type Description
Restricted
  • string
Unrestricted
  • string

DataProtection

Ochrana dat

Name Type Description
backup

Backup
Vlastnosti zálohování

replication

Replikace
Vlastnosti replikace

snapshot

Snímek
Vlastnosti snímku

enableSubvolumes

Příznak označující, jestli jsou na svazku povoleny operace podvolumu

Name Type Description
Disabled
  • string

Podvolumes nejsou povoleny.

Enabled
  • string

Jsou povoleny podvolumey.

EndpointType

Určuje, jestli je místní svazek zdrojem nebo cílem replikace svazku.

Name Type Description
dst
  • string
src
  • string

ExportPolicy

exportPolicy

Name Type Description
rules

Pravidlo zásad exportu
Pravidlo zásad exportu

exportPolicyRule

Pravidlo zásad exportu svazku

Name Type Default Value Description
allowedClients
  • string

Specifikace příchozího přenosu dat klienta jako řetězec oddělený čárkami s identifikátory IPv4 CIDR, adresami hostitele IPv4 a názvy hostitelů

chownMode Restricted

Tento parametr určuje, kdo má oprávnění změnit vlastnictví souboru. restricted – Vlastnictví souboru může změnit pouze kořenový uživatel. bez omezení – uživatelé, kteří nejsou rooty, můžou změnit vlastnictví souborů, které vlastní.

cifs
  • boolean

Povoluje protokol CIFS.

hasRootAccess
  • boolean
True

Má kořenový přístup ke svazku.

kerberos5ReadOnly
  • boolean
False

Přístup jen pro čtení protokolu Kerberos5. Použití s Swagger verze 2020-05-01 nebo novější

kerberos5ReadWrite
  • boolean
False

Přístup ke čtení a zápisu protokolu Kerberos5 Použití s Swagger verze 2020-05-01 nebo novější

kerberos5iReadOnly
  • boolean
False

Přístup jen pro čtení protokolu Kerberos5i Použití s Swagger verze 2020-05-01 nebo novější

kerberos5iReadWrite
  • boolean
False

Přístup ke čtení a zápisu kerberos5i Použití s Swagger verze 2020-05-01 nebo novější

kerberos5pReadOnly
  • boolean
False

Přístup jen pro čtení protokolu Kerberos5p Použití s Swagger verze 2020-05-01 nebo novější

kerberos5pReadWrite
  • boolean
False

Přístup ke čtení a zápisu protokolu Kerberos5p. Použití s Swagger verze 2020-05-01 nebo novější

nfsv3
  • boolean

Povoluje protokol NFSv3. Povolení pouze pro svazky typu NFSv3

nfsv41
  • boolean

Povoluje protokol NFSv4.1. Povolení pouze pro svazky typu NFSv4.1

ruleIndex
  • integer

Index objednávek

unixReadOnly
  • boolean

Přístup jenom pro čtení

unixReadWrite
  • boolean

Přístup pro čtení a zápis

mountTargetProperties

Vlastnosti cíle připojení

Name Type Description
fileSystemId
  • string

fileSystemId
UUID v4 sloužící k identifikaci MountTargetu

ipAddress
  • string

ipAddress
Adresa IPv4 cíle připojení

mountTargetId
  • string

mountTargetId
UUID v4 sloužící k identifikaci MountTargetu

smbServerFqdn
  • string

smbServerFQDN
Plně kvalifikovaný název domény serveru SMB, plně kvalifikovaný název domény

NetworkFeatures

Síťové funkce

Name Type Description
Basic
  • string

Základní síťová funkce

Standard
  • string

Standardní síťová funkce.

placementKeyValuePairs

Parametry specifické pro aplikaci pro umístění svazků ve skupině svazků

Name Type Description
key
  • string

Klíč pro parametr specifický pro aplikaci pro umístění svazků ve skupině svazků

value
  • string

Hodnota parametru specifického pro aplikaci pro umístění svazků ve skupině svazků

replicationObject

Vlastnosti replikace

Name Type Description
endpointType

Určuje, jestli je místní svazek zdrojem nebo cílem replikace svazku.

remoteVolumeRegion
  • string

Vzdálená oblast pro druhý konec replikace svazku.

remoteVolumeResourceId
  • string

ID prostředku vzdáleného svazku.

replicationId
  • string

Id

replicationSchedule

Plán

ReplicationSchedule

Plán

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

SecurityStyle

Styl zabezpečení svazku, výchozí unix, výchozí hodnota ntfs pro duální protokol nebo CIFS

Name Type Description
ntfs
  • string
unix
  • string

ServiceLevel

serviceLevel

Name Type Description
Premium
  • string

Úroveň služby Premium

Standard
  • string

Standardní úroveň služby

StandardZRS
  • string

Zónově redundantní úroveň služby úložiště

Ultra
  • string

Úroveň služby Ultra

volume

Prostředek svazku

Name Type Default Value Description
etag
  • string

Jedinečný řetězec jen pro čtení, který se změní při každé aktualizaci prostředku.

id
  • string

Plně kvalifikované ID prostředku pro daný prostředek. Příklad – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location
  • string

Geografické umístění, kde se prostředek nachází

name
  • string

Název prostředku

properties.avsDataStore Disabled

avsDataStore
Určuje, jestli je svazek povolený pro účely úložiště dat Azure VMware Solution (AVS).

properties.backupId
  • string

ID zálohy
Identifikátor UUID verze 4 nebo prostředku použitý k identifikaci zálohy.

properties.baremetalTenantId
  • string

ID tenanta baremetal
Jedinečný identifikátor tenanta baremetal.

properties.capacityPoolResourceId
  • string

ID zdroje fondu použité v případě vytvoření svazku prostřednictvím skupiny svazků

properties.cloneProgress
  • integer

Při obnovování svazku ze snímku jiného svazku se zobrazí procento dokončení tohoto procesu klonování. Pokud je tato hodnota prázdná nebo null, na tomto svazku aktuálně neprobíhá žádný proces klonování. Tato hodnota se během klonování aktualizuje každých 5 minut.

properties.coolAccess
  • boolean
False

Určuje, jestli je pro svazek povolený cool access(vrstvení).

properties.coolnessPeriod
  • integer

Určuje počet dní, po kterých budou data, ke kterým klienti nepřistupují, vrstvit.

properties.creationToken
  • string

Cesta k vytvoření tokenu nebo souboru
Jedinečná cesta k souboru svazku. Používá se při vytváření cílů připojení.

properties.dataProtection

Ochrana dat
Svazky typu DataProtection zahrnují objekt obsahující podrobnosti o replikaci.

properties.defaultGroupQuotaInKiBs
  • integer
0

Výchozí kvóta skupiny pro svazek v KiBs Pokud je nastavena hodnota IsDefaultQuotaEnabled, použije se minimální hodnota 4 kiB.

properties.defaultUserQuotaInKiBs
  • integer
0

Výchozí kvóta uživatele pro svazek v KiBs Pokud je nastavena hodnota IsDefaultQuotaEnabled, použije se minimální hodnota 4 kiB .

properties.enableSubvolumes Disabled

Příznak označující, jestli jsou na svazku povoleny dílčí operace

properties.encryptionKeySource
  • string

Zdroj šifrovacího klíče Možné hodnoty: Microsoft.NetApp

properties.exportPolicy

exportPolicy
Sada pravidel zásad exportu

properties.fileSystemId
  • string

ID systému souborů
Jedinečný identifikátor systému souborů.

properties.isDefaultQuotaEnabled
  • boolean
False

Určuje, jestli je pro svazek povolená výchozí kvóta.

properties.isRestoring
  • boolean

Obnovení

properties.kerberosEnabled
  • boolean
False

Popište, jestli je svazek KerberosEnabled. Použití se swaggerem verze 2020-05-01 nebo novějším

properties.ldapEnabled
  • boolean
False

Určuje, jestli je pro daný svazek NFS povolený nebo není povolený protokol LDAP.

properties.maximumNumberOfFiles
  • integer

Maximální povolený počet souborů Potřebuje žádost o službu, aby se změnila. Pokud je kvóta svazku větší než 4TiB, je možné ji změnit.

properties.mountTargets

mountTargets
Seznam cílů připojení

properties.networkFeatures Basic

Síťové funkce
Základní síťové funkce nebo funkce Standard dostupné pro svazek

properties.networkSiblingSetId
  • string

ID sady síťovýchblů
ID sady sibling sítě pro skupinu svazků, které sdílejí síťové prostředky

properties.placementRules

Pravidla umístění svazků
Pravidla umístění specifická pro konkrétní svazek aplikace

properties.protocolTypes
  • string[]

ProtocolTypes
Sada typů protokolů, výchozí NFSv3, CIFS pro protokol SMB

properties.provisioningState
  • string

Správa životního cyklu Azure

properties.proximityPlacementGroup
  • string

Skupina umístění blízkosti přidružená ke svazku

properties.securityStyle unix

Styl zabezpečení svazku, výchozí unix, ve výchozím nastavení ntfs pro duální protokol nebo PROTOKOL CIFS

properties.serviceLevel Premium

serviceLevel
Úroveň služby systému souborů

properties.smbContinuouslyAvailable
  • boolean
False

Umožňuje nepřetržitě dostupnou vlastnost sdílené složky pro svazek smb. Platí jenom pro svazek SMB.

properties.smbEncryption
  • boolean
False

Umožňuje šifrování dat smb3 v testovacím prostředí. Platí jenom pro svazek SMB/DualProtocol. Použití swagger verze 2020-08-01 nebo novější

properties.snapshotDirectoryVisible
  • boolean
True

Pokud je tento svazek povolený (true), bude obsahovat adresář snímků jen pro čtení, který poskytuje přístup k jednotlivým snímkům svazku (výchozí hodnota je true).

properties.snapshotId
  • string

ID snímku
Identifikátor UUID v4 nebo prostředek použitý k identifikaci snímku

properties.storageToNetworkProximity

Blízkost úložiště k síti
Poskytuje úložiště informací o blízkosti sítě pro svazek.

properties.subnetId
  • string

Identifikátor URI prostředků Azure pro delegovanou podsíť. Musí mít delegování Microsoft.NetApp nebo svazky.

properties.t2Network
  • string

Informace o síti T2

properties.throughputMibps
  • number

Maximální propustnost v Mibps, kterou lze dosáhnout tímto svazkem, a to bude přijato jako vstup pouze pro ruční svazek qosType.

properties.unixPermissions
  • string
0770

Oprávnění systému UNIX pro svazek NFS přijatá v osmičkovém 4místném formátu První číslice vybere nastavené ID uživatele(4), nastaví ID skupiny (2) a rychlé atributy (1). Druhá číslice vybere oprávnění pro vlastníka souboru: čtení (4), zápis (2) a provedení (1). Třetí vybere oprávnění pro ostatní uživatele ve stejné skupině. čtvrtý pro ostatní uživatele, kteří nejsou ve skupině. 0755 – poskytuje oprávnění ke čtení, zápisu nebo spouštění pro vlastníka a čtení a spouštění pro skupinu a ostatní uživatele.

properties.usageThreshold
  • integer
0

usageThreshold
Maximální kvóta úložiště povolená pro systém souborů v bajtech Jedná se o měkkou kvótu použitou pouze pro upozorňování. Minimální velikost je 100 GiB. Horní limit je 100TiB. Zadané v bajtech.

properties.volumeGroupName
  • string

Název skupiny svazků

properties.volumeSpecName
  • string

Název specifikace svazku je označení nebo identifikátor konkrétního svazku pro konkrétní svazek ve skupině svazků, například data, protokol

properties.volumeType
  • string

Jaký je typ svazku. U cílových svazků v replikaci mezi oblastmi nastavte typ na DataProtection.

tags
  • object

Značky prostředků

type
  • string

Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

volumeBackupProperties

Vlastnosti zálohování svazku

Name Type Description
backupEnabled
  • boolean

Povoleno zálohování

backupPolicyId
  • string

ID prostředku zásady zálohování

policyEnforced
  • boolean

Vynucené zásady

vaultId
  • string

ID prostředku trezoru

volumeSnapshotProperties

Vlastnosti snímku svazku

Name Type Description
snapshotPolicyId
  • string

Id prostředku zásady snímků

VolumeStorageToNetworkProximity

Blízkost úložiště k síti

Name Type Description
Default
  • string

Základní úložiště k síťovému připojení

T1
  • string

Úložiště T1 úrovně Standard k připojení k síti

T2
  • string

Úložiště T2 úrovně Standard k síťovému připojení