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=2023-07-01
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
account
|
path | True |
string |
Název účtu NetApp Regex pattern: |
pool
|
path | True |
string |
Název fondu kapacity Regex pattern: |
resource
|
path | True |
string |
Název skupiny prostředků. V názvu se rozlišují malá a velká písmena. |
subscription
|
path | True |
string uuid |
ID cílového předplatného. Hodnota musí být UUID. |
volume
|
path | True |
string |
Název svazku Regex pattern: |
api-version
|
query | True |
string |
Verze rozhraní API, která se má použít pro tuto operaci. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Chybová odpověď popisující, proč operace selhala. |
Zabezpečení
azure_auth
Tok Azure Active Directory OAuth2
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
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
Name | Description |
---|---|
avs |
avsDataStore |
Chown |
Tento parametr určuje, kdo má oprávnění ke změně vlastnictví souboru. restricted – Vlastnictví souboru může změnit pouze uživatel root. unrestricted – uživatelé, kteří nejsou root, můžou změnit vlastnictví souborů, které vlastní. |
cool |
coolAccessRetrievalPolicy určuje chování načítání dat ze studené úrovně do úložiště úrovně Standard na základě vzoru čtení pro svazky s povoleným přístupem. Možné hodnoty pro toto pole jsou: Výchozí – Data se při náhodném čtení přečtou z studené úrovně do standardního úložiště. Tato zásada je výchozí. OnRead – Všechna čtení dat řízených klientem se přetahují z studené úrovně do standardního úložiště při sekvenčním i náhodném čtení. Nikdy – Z studené úrovně do úložiště úrovně Standard se nepřetahuje žádná data řízených klientem. |
created |
Typ identity, která prostředek vytvořila. |
Data |
Ochrana dat |
enable |
Příznak označující, jestli jsou na svazku povolené operace podvolu |
Encryption |
Zdroj klíče, který se používá k šifrování dat ve svazku. Platí, pokud má účet NetApp encryption.keySource = 'Microsoft.KeyVault'. Možné hodnoty (nerozlišují malá a malá písmena): Microsoft.NetApp, Microsoft.KeyVault |
Endpoint |
Určuje, jestli je místní svazek zdrojem nebo cílem replikace svazku. |
Error |
Další informace o chybě správy prostředků |
Error |
Podrobnosti o chybě. |
Error |
Odpověď na chybu |
Export |
exportPolicy |
export |
Pravidlo zásad exportu svazků |
file |
Příznak označující, jestli jsou pro svazek povolené protokoly přístupu k souborům na základě aktivního nastavení diagnostiky, které jsou na svazku přítomné. |
mount |
Vlastnosti cíle připojení |
Network |
Funkce sítě |
placement |
Parametry specifické pro aplikaci pro umístění svazků ve skupině svazků |
replication |
Vlastnosti replikace |
Replication |
Plán |
Security |
Styl zabezpečení svazku , výchozí unix, výchozí ntfs pro duální protokol nebo CIFS protokol |
Service |
serviceLevel |
smb |
smbAccessBasedEnumeration |
smb |
smbNonBrowsable |
system |
Metadata týkající se vytvoření a poslední změny prostředku |
volume |
Prostředek svazku |
volume |
Vlastnosti přemístění svazku |
volume |
Vlastnosti snímku svazku |
Volume |
Vzdálenost mezi úložištěm a sítí |
avsDataStore
avsDataStore
Name | Typ | Description |
---|---|---|
Disabled |
string |
avsDataStore je zakázaný. |
Enabled |
string |
avsDataStore je povolený. |
ChownMode
Tento parametr určuje, kdo má oprávnění ke změně vlastnictví souboru. restricted – Vlastnictví souboru může změnit pouze uživatel root. unrestricted – uživatelé, kteří nejsou root, můžou změnit vlastnictví souborů, které vlastní.
Name | Typ | Description |
---|---|---|
Restricted |
string |
|
Unrestricted |
string |
coolAccessRetrievalPolicy
coolAccessRetrievalPolicy určuje chování načítání dat ze studené úrovně do úložiště úrovně Standard na základě vzoru čtení pro svazky s povoleným přístupem. Možné hodnoty pro toto pole jsou: Výchozí – Data se při náhodném čtení přečtou z studené úrovně do standardního úložiště. Tato zásada je výchozí. OnRead – Všechna čtení dat řízených klientem se přetahují z studené úrovně do standardního úložiště při sekvenčním i náhodném čtení. Nikdy – Z studené úrovně do úložiště úrovně Standard se nepřetahuje žádná data řízených klientem.
Name | Typ | Description |
---|---|---|
Default |
string |
|
Never |
string |
|
OnRead |
string |
createdByType
Typ identity, která prostředek vytvořila.
Name | Typ | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
DataProtection
Ochrana dat
Name | Typ | Description |
---|---|---|
replication |
Replikace |
|
snapshot |
Snímek |
|
volumeRelocation |
VolumeRelocation |
enableSubvolumes
Příznak označující, jestli jsou na svazku povolené operace podvolu
Name | Typ | Description |
---|---|---|
Disabled |
string |
subvolumes nejsou povolené |
Enabled |
string |
jsou povolené podvolu. |
EncryptionKeySource
Zdroj klíče, který se používá k šifrování dat ve svazku. Platí, pokud má účet NetApp encryption.keySource = 'Microsoft.KeyVault'. Možné hodnoty (nerozlišují malá a malá písmena): Microsoft.NetApp, Microsoft.KeyVault
Name | Typ | Description |
---|---|---|
Microsoft.KeyVault |
string |
Šifrování klíčů spravovaných zákazníkem |
Microsoft.NetApp |
string |
Šifrování klíčů spravovaných Microsoftem |
EndpointType
Určuje, jestli je místní svazek zdrojem nebo cílem replikace svazku.
Name | Typ | Description |
---|---|---|
dst |
string |
|
src |
string |
ErrorAdditionalInfo
Další informace o chybě správy prostředků
Name | Typ | Description |
---|---|---|
info |
object |
Další informace. |
type |
string |
Typ další informace. |
ErrorDetail
Podrobnosti o chybě.
Name | Typ | Description |
---|---|---|
additionalInfo |
Další informace o chybě. |
|
code |
string |
Kód chyby |
details |
Podrobnosti o chybě |
|
message |
string |
Chybová zpráva |
target |
string |
Cíl chyby. |
ErrorResponse
Odpověď na chybu
Name | Typ | Description |
---|---|---|
error |
Objekt chyby. |
ExportPolicy
exportPolicy
Name | Typ | Description |
---|---|---|
rules |
Pravidlo zásad exportu |
exportPolicyRule
Pravidlo zásad exportu svazků
Name | Typ | Výchozí hodnota | Description |
---|---|---|---|
allowedClients |
string |
Specifikace příchozího přenosu dat klienta jako řetězec oddělený čárkami s identifikátory CIDR IPv4, adresami hostitelů IPv4 a názvy hostitelů |
|
chownMode | Restricted |
Tento parametr určuje, kdo má oprávnění ke změně vlastnictví souboru. restricted – Vlastnictví souboru může změnit pouze uživatel root. unrestricted – uživatelé, kteří nejsou root, 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 |
Kerberos5 – přístup jen pro čtení. Pro použití se swaggerem verze 2020-05-01 nebo novější |
kerberos5ReadWrite |
boolean |
False |
Kerberos5 – oprávnění ke čtení a zápisu. Pro použití se swaggerem verze 2020-05-01 nebo novější |
kerberos5iReadOnly |
boolean |
False |
Kerberos5i Přístup jen pro čtení. Pro použití se swaggerem verze 2020-05-01 nebo novější |
kerberos5iReadWrite |
boolean |
False |
Kerberos5i – Oprávnění ke čtení a zápisu. Pro použití se swaggerem verze 2020-05-01 nebo novější |
kerberos5pReadOnly |
boolean |
False |
Kerberos5p Přístup jen pro čtení. Pro použití se swaggerem verze 2020-05-01 nebo novější |
kerberos5pReadWrite |
boolean |
False |
Přístup pro čtení a zápis protokolu Kerberos5p. Pro použití se swaggerem verze 2020-05-01 nebo novější |
nfsv3 |
boolean |
Umožňuje protokol NFSv3. Povolit pouze pro svazky typu NFSv3 |
|
nfsv41 |
boolean |
Povoluje protokol NFSv4.1. Povolit pouze pro svazky typu NFSv4.1 |
|
ruleIndex |
integer |
Index objednávek |
|
unixReadOnly |
boolean |
Přístup jenom pro čtení |
|
unixReadWrite |
boolean |
Oprávnění ke čtení a zápisu |
fileAccessLogs
Příznak označující, jestli jsou pro svazek povolené protokoly přístupu k souborům na základě aktivního nastavení diagnostiky, které jsou na svazku přítomné.
Name | Typ | Description |
---|---|---|
Disabled |
string |
fileAccessLogs nejsou povolené. |
Enabled |
string |
protokoly fileAccessLogs jsou povolené. |
mountTargetProperties
Vlastnosti cíle připojení
Name | Typ | Description |
---|---|---|
fileSystemId |
string |
fileSystemId |
ipAddress |
string |
ipAddress |
mountTargetId |
string |
mountTargetId |
smbServerFqdn |
string |
smbServerFQDN |
NetworkFeatures
Funkce sítě
Name | Typ | Description |
---|---|---|
Basic |
string |
Základní síťové funkce. |
Basic_Standard |
string |
Aktualizace síťových funkcí z úrovně Basic na standard. |
Standard |
string |
Standardní síťové funkce. |
Standard_Basic |
string |
Aktualizace síťových funkcí ze standardu na úroveň Basic |
placementKeyValuePairs
Parametry specifické pro aplikaci pro umístění svazků ve skupině svazků
Name | Typ | 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 | Typ | 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 | Typ | Description |
---|---|---|
_10minutely |
string |
|
daily |
string |
|
hourly |
string |
SecurityStyle
Styl zabezpečení svazku , výchozí unix, výchozí ntfs pro duální protokol nebo CIFS protokol
Name | Typ | Description |
---|---|---|
ntfs |
string |
|
unix |
string |
ServiceLevel
serviceLevel
Name | Typ | Description |
---|---|---|
Premium |
string |
Úroveň služeb Premium |
Standard |
string |
Standardní úroveň služby |
StandardZRS |
string |
Úroveň služby zónově redundantního úložiště |
Ultra |
string |
Úroveň služeb Úrovně Ultra |
smbAccessBasedEnumeration
smbAccessBasedEnumeration
Name | Typ | Description |
---|---|---|
Disabled |
string |
Nastavení sdílené složky smbAccessBasedEnumeration je zakázané. |
Enabled |
string |
Nastavení sdílené složky smbAccessBasedEnumeration je povolené. |
smbNonBrowsable
smbNonBrowsable
Name | Typ | Description |
---|---|---|
Disabled |
string |
Nastavení sdílené složky smbNonBrowsable je zakázané. |
Enabled |
string |
Nastavení sdílené složky smbNonBrowsable je povolené. |
systemData
Metadata týkající se vytvoření a poslední změny prostředku
Name | Typ | Description |
---|---|---|
createdAt |
string |
Časové razítko vytvoření prostředku (UTC) |
createdBy |
string |
Identita, která prostředek vytvořila. |
createdByType |
Typ identity, která vytvořila prostředek. |
|
lastModifiedAt |
string |
Časové razítko poslední změny prostředku (UTC) |
lastModifiedBy |
string |
Identita, která naposledy změnila prostředek. |
lastModifiedByType |
Typ identity, která naposledy změnila prostředek. |
volume
Prostředek svazku
Name | Typ | Výchozí hodnota | Description |
---|---|---|---|
etag |
string |
Jedinečný řetězec jen pro čtení, který se mění při každé aktualizaci prostředku. |
|
id |
string |
Plně kvalifikované ID prostředku. Např. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
|
location |
string |
Geografické umístění, ve kterém se nachází prostředek |
|
name |
string |
Název prostředku |
|
properties.actualThroughputMibps |
number |
Skutečná propustnost v MiB/s pro automatické svazky qosType vypočítaná na základě velikosti a úrovně služby |
|
properties.avsDataStore | Disabled |
avsDataStore |
|
properties.backupId |
string |
ID zálohy |
|
properties.baremetalTenantId |
string |
ID tenanta bez baremetal |
|
properties.capacityPoolResourceId |
string |
ID prostředku fondu použité v případě vytvoření svazku prostřednictvím skupiny svazků |
|
properties.cloneProgress |
integer |
Když se svazek obnovuje ze snímku jiného svazku, 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ý studený přístup (vrstvení). |
properties.coolAccessRetrievalPolicy |
coolAccessRetrievalPolicy určuje chování načítání dat ze studené úrovně do úložiště úrovně Standard na základě vzoru čtení pro svazky s povoleným přístupem. Možné hodnoty pro toto pole jsou: Výchozí – Data se při náhodném čtení přečtou z studené úrovně do standardního úložiště. Tato zásada je výchozí. OnRead – Všechna čtení dat řízených klientem se přetahují z studené úrovně do standardního úložiště při sekvenčním i náhodném čtení. Nikdy – Z studené úrovně do úložiště úrovně Standard se nepřetahuje žádná data řízených klientem. |
||
properties.coolnessPeriod |
integer |
Určuje počet dnů, po jejichž uplynutí budou data, ke kterým klienti nepřistupují, vrstvit. |
|
properties.creationToken |
string |
Vytvoření tokenu nebo cesty k souboru |
|
properties.dataProtection |
Ochrana dat |
||
properties.dataStoreResourceId |
string[] |
dataStoreResourceId |
|
properties.defaultGroupQuotaInKiBs |
integer |
0 |
Výchozí kvóta skupiny pro svazek v kiB. Pokud je nastavená hodnota isDefaultQuotaEnabled, použije se minimální hodnota 4 kiB. |
properties.defaultUserQuotaInKiBs |
integer |
0 |
Výchozí uživatelská kvóta pro svazek v kiB. Pokud je nastavená hodnota isDefaultQuotaEnabled, použije se minimální hodnota 4 kiB. |
properties.deleteBaseSnapshot |
boolean |
Pokud je povoleno (true), snímek, ze které byl svazek vytvořen, se po dokončení operace vytvoření svazku automaticky odstraní. Výchozí hodnota je false. |
|
properties.enableSubvolumes | Disabled |
Příznak označující, jestli jsou na svazku povolené operace podvolu |
|
properties.encrypted |
boolean |
Určuje, jestli je svazek šifrovaný nebo ne. K dispozici pouze na svazcích vytvořených nebo aktualizovaných po 1. 1. 2022. |
|
properties.encryptionKeySource | Microsoft.NetApp |
Zdroj klíče, který se používá k šifrování dat ve svazku. Platí, pokud má účet NetApp encryption.keySource = 'Microsoft.KeyVault'. Možné hodnoty (nerozlišují malá a malá písmena): Microsoft.NetApp, Microsoft.KeyVault |
|
properties.exportPolicy |
exportPolicy |
||
properties.fileAccessLogs | Disabled |
Příznak označující, jestli jsou pro svazek povolené protokoly přístupu k souborům na základě aktivního nastavení diagnostiky, které jsou na svazku přítomné. |
|
properties.fileSystemId |
string |
ID systému souborů |
|
properties.isDefaultQuotaEnabled |
boolean |
False |
Určuje, jestli je pro svazek povolená výchozí kvóta. |
properties.isLargeVolume |
boolean |
False |
Je velký objem |
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ší |
properties.keyVaultPrivateEndpointResourceId |
string |
ID prostředku privátního koncového bodu pro KeyVault. Musí se nacházet ve stejné virtuální síti jako svazek. Platí pouze v případě, že encryptionKeySource = 'Microsoft.KeyVault'. |
|
properties.ldapEnabled |
boolean |
False |
Určuje, jestli je pro daný svazek NFS povolený protokol LDAP. |
properties.maximumNumberOfFiles |
integer |
Maximální povolený počet souborů. Aby bylo možné změnit, potřebuje žádost o službu. Změnu je možné pouze v případě, že je kvóta svazku větší než 4TiB. |
|
properties.mountTargets |
mountTargets |
||
properties.networkFeatures | Basic |
Funkce sítě |
|
properties.networkSiblingSetId |
string |
ID sady na stejné síti |
|
properties.originatingResourceId |
string |
ID původního prostředku |
|
properties.placementRules |
Pravidla umístění svazků |
||
properties.protocolTypes |
string[] |
protocolTypes |
|
properties.provisionedAvailabilityZone |
string |
Zřízená zóna dostupnosti |
|
properties.provisioningState |
string |
Správa životního cyklu Azure |
|
properties.proximityPlacementGroup |
string |
Skupina umístění bezkontaktní komunikace přidružená ke svazku |
|
properties.securityStyle | unix |
Styl zabezpečení svazku , výchozí unix, výchozí ntfs pro duální protokol nebo CIFS protokol |
|
properties.serviceLevel | Premium |
serviceLevel |
|
properties.smbAccessBasedEnumeration |
smbAccessBasedEnumeration |
||
properties.smbContinuouslyAvailable |
boolean |
False |
Povolí 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 za letu. Platí jenom pro svazek SMB/DualProtocol. Použití se swaggerem verze 2020-08-01 nebo novější |
properties.smbNonBrowsable |
smbNonBrowsable |
||
properties.snapshotDirectoryVisible |
boolean |
True |
Pokud je povoleno (true), bude svazek obsahovat adresář snímků jen pro čtení, který poskytuje přístup ke každému snímku svazku (výchozí hodnota je true). |
properties.snapshotId |
string |
ID snímku |
|
properties.storageToNetworkProximity |
Vzdálenost mezi úložištěm a sítí |
||
properties.subnetId |
string |
Identifikátor URI prostředku Azure pro delegovanou podsíť Musí mít delegování Microsoft.NetApp/volumes. |
|
properties.t2Network |
string |
Informace o síti T2 |
|
properties.throughputMibps |
number |
Maximální propustnost v MiB/s, které může tento svazek dosáhnout, a tato propustnost bude přijata jako vstup pouze pro ruční svazek qosType. |
|
properties.unixPermissions |
string |
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), id skupiny (2) a atributy sticky (1). Druhá číslice vybere oprávnění pro vlastníka souboru: čtení (4), zápis (2) a spuštění (1). Třetí vybere oprávnění pro ostatní uživatele ve stejné skupině. čtvrtý pro ostatní uživatele, kteří nejsou ve skupině. 0755 – uděluje oprávnění ke čtení,zápisu/spouštění vlastníka a čtení/spouštění skupině a dalším uživatelům. |
|
properties.usageThreshold |
integer |
0 |
usageThreshold |
properties.volumeGroupName |
string |
Název skupiny svazků |
|
properties.volumeSpecName |
string |
Název specifikace svazku je označení nebo identifikátor konkrétního svazku ve skupině svazků specifické pro aplikaci, například data, protokol. |
|
properties.volumeType |
string |
O jaký typ svazku se jedná. Pro cílové svazky v replikaci mezi oblastmi nastavte typ na DataProtection. |
|
systemData |
Azure Resource Manager metadata obsahující informace createdBy a modifiedBy. |
||
tags |
object |
Značky prostředků. |
|
type |
string |
Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts |
|
zones |
string[] |
Zóna dostupnosti |
volumeRelocationProperties
Vlastnosti přemístění svazku
Name | Typ | Description |
---|---|---|
readyToBeFinalized |
boolean |
Má dokončené přemístění a je připraven k vyčištění |
relocationRequested |
boolean |
Žádost o přemístění pro tento svazek |
volumeSnapshotProperties
Vlastnosti snímku svazku
Name | Typ | Description |
---|---|---|
snapshotPolicyId |
string |
ID prostředku zásady snímku |
VolumeStorageToNetworkProximity
Vzdálenost mezi úložištěm a sítí
Name | Typ | Description |
---|---|---|
AcrossT2 |
string |
Připojení úložiště Standard AcrossT2 k síti. |
Default |
string |
Základní připojení úložiště k síti. |
T1 |
string |
Standardní úložiště T1 k síťovému připojení. |
T2 |
string |
Standardní úložiště T2 k síťovému připojení. |