Volumes - Get

Descrivere un volume
Ottenere i dettagli del volume specificato

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

Parametri dell'URI

Name In Required Type Description
accountName
path True
  • string

Nome dell'account NetApp

poolName
path True
  • string

Nome del pool di capacità

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

resourceGroupName
path True
  • string

Nome del gruppo di risorse.

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

subscriptionId
path True
  • string

Credenziali di sottoscrizione che identificano in modo univoco la sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata di servizio.

volumeName
path True
  • string

Nome del volume

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

api-version
query True
  • string

Versione dell'API da usare per questa operazione.

Risposte

Name Type Description
200 OK

OK

Other Status Codes

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

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

Scopes

Name Description
user_impersonation rappresentare l'account utente

Esempio

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

Definizioni

avsDataStore

avsDataStore

ChownMode

Questo parametro specifica chi è autorizzato a modificare la proprietà di un file. con restrizioni: solo l'utente radice può modificare la proprietà del file. senza restrizioni: gli utenti non radice possono modificare la proprietà dei file di cui sono proprietari.

DataProtection

DataProtection

enableSubvolumes

Flag che indica se le operazioni di sottovolume sono abilitate nel volume

EndpointType

Indica se il volume locale è l'origine o la destinazione per la replica del volume

ExportPolicy

exportPolicy

exportPolicyRule

Regola dei criteri di esportazione dei volumi

mountTargetProperties

Montare le proprietà di destinazione

NetworkFeatures

Funzionalità di rete

placementKeyValuePairs

Parametri specifici dell'applicazione per il posizionamento dei volumi nel gruppo di volumi

replicationObject

Proprietà di replica

ReplicationSchedule

Pianifica

SecurityStyle

Lo stile di sicurezza del volume, unix predefinito, viene usato per impostazione predefinita ntfs per il protocollo DUAL o il protocollo CIFS

ServiceLevel

serviceLevel

volume

Risorsa volume

volumeBackupProperties

Proprietà di backup del volume

volumeSnapshotProperties

Proprietà snapshot del volume

VolumeStorageToNetworkProximity

Prossimità tra archiviazione e rete

avsDataStore

avsDataStore

Name Type Description
Disabled
  • string

AvsDataStore è disabilitato

Enabled
  • string

AvsDataStore è abilitato

ChownMode

Questo parametro specifica chi è autorizzato a modificare la proprietà di un file. con restrizioni: solo l'utente radice può modificare la proprietà del file. senza restrizioni: gli utenti non radice possono modificare la proprietà dei file di cui sono proprietari.

Name Type Description
Restricted
  • string
Unrestricted
  • string

DataProtection

DataProtection

Name Type Description
backup

Backup
Proprietà di backup

replication

Replica
Proprietà di replica

snapshot

Snapshot
Proprietà snapshot.

enableSubvolumes

Flag che indica se le operazioni di sottovolume sono abilitate nel volume

Name Type Description
Disabled
  • string

le sottovolume non sono abilitate

Enabled
  • string

le sottovolume sono abilitate

EndpointType

Indica se il volume locale è l'origine o la destinazione per la replica del volume

Name Type Description
dst
  • string
src
  • string

ExportPolicy

exportPolicy

Name Type Description
rules

Regola dei criteri di esportazione
Regola dei criteri di esportazione

exportPolicyRule

Regola dei criteri di esportazione dei volumi

Name Type Default Value Description
allowedClients
  • string

Specifica di ingresso client come stringa delimitata da virgole con CIDR IPv4, indirizzi host IPv4 e nomi host

chownMode Restricted

Questo parametro specifica chi è autorizzato a modificare la proprietà di un file. con restrizioni: solo l'utente radice può modificare la proprietà del file. senza restrizioni: gli utenti non radice possono modificare la proprietà dei file di cui sono proprietari.

cifs
  • boolean

Consente il protocollo CIFS

hasRootAccess
  • boolean
True

Ha accesso radice al volume

kerberos5ReadOnly
  • boolean
False

Accesso in sola lettura Kerberos5. Da usare con swagger versione 2020-05-01 o successiva

kerberos5ReadWrite
  • boolean
False

Accesso in lettura e scrittura Kerberos5. Da usare con swagger versione 2020-05-01 o successiva

kerberos5iReadOnly
  • boolean
False

Accesso in sola lettura Kerberos5i. Da usare con swagger versione 2020-05-01 o successiva

kerberos5iReadWrite
  • boolean
False

Accesso in lettura e scrittura Kerberos5i. Da usare con swagger versione 2020-05-01 o successiva

kerberos5pReadOnly
  • boolean
False

Accesso in sola lettura Kerberos5p. Da usare con swagger versione 2020-05-01 o successiva

kerberos5pReadWrite
  • boolean
False

Accesso in lettura e scrittura Kerberos5p. Da usare con swagger versione 2020-05-01 o successiva

nfsv3
  • boolean

Consente il protocollo NFSv3. Abilitare solo per i volumi di tipo NFSv3

nfsv41
  • boolean

Consente il protocollo NFSv4.1. Abilitare solo per i volumi di tipo NFSv4.1

ruleIndex
  • integer

Indice dell'ordine

unixReadOnly
  • boolean

Accesso in sola lettura

unixReadWrite
  • boolean

Accesso in lettura e scrittura

mountTargetProperties

Montare le proprietà di destinazione

Name Type Description
fileSystemId
  • string

fileSystemId
UUID v4 usato per identificare MountTarget

ipAddress
  • string

IpAddress
Indirizzo IPv4 della destinazione di montaggio

mountTargetId
  • string

mountTargetId
UUID v4 usato per identificare MountTarget

smbServerFqdn
  • string

smbServerFQDN
Nome di dominio completo del server SMB, FQDN

NetworkFeatures

Funzionalità di rete

Name Type Description
Basic
  • string

Funzionalità di rete di base.

Standard
  • string

Funzionalità di rete standard.

placementKeyValuePairs

Parametri specifici dell'applicazione per il posizionamento dei volumi nel gruppo di volumi

Name Type Description
key
  • string

Chiave per un parametro specifico dell'applicazione per il posizionamento dei volumi nel gruppo di volumi

value
  • string

Valore per un parametro specifico dell'applicazione per il posizionamento dei volumi nel gruppo di volumi

replicationObject

Proprietà di replica

Name Type Description
endpointType

Indica se il volume locale è l'origine o la destinazione per la replica del volume

remoteVolumeRegion
  • string

Area remota per l'altra estremità della replica del volume.

remoteVolumeResourceId
  • string

ID risorsa del volume remoto.

replicationId
  • string

Id

replicationSchedule

Pianifica

ReplicationSchedule

Pianifica

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

SecurityStyle

Lo stile di sicurezza del volume, unix predefinito, viene usato per impostazione predefinita ntfs per il protocollo DUAL o il protocollo CIFS

Name Type Description
ntfs
  • string
unix
  • string

ServiceLevel

serviceLevel

Name Type Description
Premium
  • string

Livello di servizio Premium

Standard
  • string

Livello di servizio standard

StandardZRS
  • string

Livello di servizio di archiviazione con ridondanza della zona

Ultra
  • string

Livello di servizio Ultra

volume

Risorsa volume

Name Type Default Value Description
etag
  • string

Stringa di sola lettura univoca che cambia ogni volta che la risorsa viene aggiornata.

id
  • string

ID di risorsa completo per la risorsa. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location
  • string

Posizione geografica in cui vive la risorsa

name
  • string

nome della risorsa.

properties.avsDataStore Disabled

avsDataStore
Specifica se il volume è abilitato per lo scopo dell'archivio dati soluzione Azure VMware (AVS)

properties.backupId
  • string

ID backup
UUID v4 o identificatore di risorsa usato per identificare il backup.

properties.baremetalTenantId
  • string

Baremetal Tenant ID
Identificatore univoco del tenant baremetal.

properties.capacityPoolResourceId
  • string

ID risorsa pool usato nel caso di creazione di un volume tramite un gruppo di volumi

properties.cloneProgress
  • integer

Quando un volume viene ripristinato dallo snapshot di un altro volume, mostrerà il completamento percentuale di questo processo di clonazione. Quando questo valore è vuoto/null non esiste attualmente alcun processo di clonazione in questo volume. Questo valore verrà aggiornato ogni 5 minuti durante la clonazione.

properties.coolAccess
  • boolean
False

Specifica se l'accesso sporadico (livelloing) è abilitato per il volume.

properties.coolnessPeriod
  • integer

Specifica il numero di giorni dopo il quale i dati non accessibili dai client verranno a livelli.

properties.creationToken
  • string

Token di creazione o percorso file
Percorso di file univoco per il volume. Usato durante la creazione di destinazioni di montaggio

properties.dataProtection

DataProtection
I volumi di tipo DataProtection includono un oggetto contenente i dettagli della replica

properties.defaultGroupQuotaInKiBs
  • integer
0

Quota di gruppo predefinita per il volume in KiBs. Se isDefaultQuotaEnabled è impostato, si applica il valore minimo di 4 KiBs.

properties.defaultUserQuotaInKiBs
  • integer
0

Quota utente predefinita per il volume in KiBs. Se isDefaultQuotaEnabled è impostato, il valore minimo di 4 KiBs si applica .

properties.enableSubvolumes Disabled

Flag che indica se le operazioni di sottovolume sono abilitate nel volume

properties.encryptionKeySource
  • string

Origine chiave di crittografia. I valori possibili sono: 'Microsoft.NetApp'

properties.exportPolicy

exportPolicy
Set di regole dei criteri di esportazione

properties.fileSystemId
  • string

FileSystem ID
Identificatore univoco del filesystem.

properties.isDefaultQuotaEnabled
  • boolean
False

Specifica se la quota predefinita è abilitata per il volume.

properties.isRestoring
  • boolean

Restoring

properties.kerberosEnabled
  • boolean
False

Descrivere se un volume è KerberosEnabled. Da usare con swagger versione 2020-05-01 o successiva

properties.ldapEnabled
  • boolean
False

Specifica se LDAP è abilitato o meno per un determinato volume NFS.

properties.maximumNumberOfFiles
  • integer

Numero massimo di file consentiti. Deve essere modificata una richiesta di servizio. È possibile modificare solo se la quota del volume è maggiore di 4TiB.

properties.mountTargets

mountTargets
Elenco di destinazioni di montaggio

properties.networkFeatures Basic

Funzionalità di rete
Funzionalità di base o Standard disponibili per il volume.

properties.networkSiblingSetId
  • string

ID set di pari livello di rete
Id set di pari livello di rete per il gruppo di volumi che condividono le risorse di rete.

properties.placementRules

Regole di posizionamento dei volumi
Regole di posizionamento specifiche dell'applicazione per il volume specifico

properties.protocolTypes
  • string[]

protocolTypes
Set di tipi di protocollo, predefinito NFSv3, CIFS per il protocollo SMB

properties.provisioningState
  • string

Gestione del ciclo di vita di Azure

properties.proximityPlacementGroup
  • string

Gruppo di posizionamento di prossimità associato al volume

properties.securityStyle unix

Stile di sicurezza del volume, unix predefinito, impostazione predefinita in ntfs per il protocollo dual o il protocollo CIFS

properties.serviceLevel Premium

serviceLevel
Livello di servizio del file system

properties.smbContinuouslyAvailable
  • boolean
False

Abilita la proprietà di condivisione disponibile continuamente per il volume smb. Applicabile solo per il volume SMB

properties.smbEncryption
  • boolean
False

Abilita la crittografia per i dati smb3 in anteprima. Applicabile solo per il volume SMB/DualProtocol. Da usare con swagger versione 2020-08-01 o successiva

properties.snapshotDirectoryVisible
  • boolean
True

Se abilitato (true) il volume conterrà una directory snapshot di sola lettura che fornisce l'accesso a ognuno degli snapshot del volume (impostazione predefinita su true).

properties.snapshotId
  • string

Snapshot ID
UUID v4 o identificatore di risorsa usato per identificare lo snapshot.

properties.storageToNetworkProximity

Archiviazione in prossimità della rete
Fornisce l'archiviazione alle informazioni di prossimità di rete per il volume.

properties.subnetId
  • string

URI risorsa di Azure per una subnet delegata. Deve avere la delega di Microsoft.NetApp/volumi

properties.t2Network
  • string

Informazioni sulla rete T2

properties.throughputMibps
  • number

Velocità effettiva massima in Mibps che può essere ottenuta da questo volume e verrà accettata come input solo per il volume qosType manuale

properties.unixPermissions
  • string
0770

Autorizzazioni UNIX per il volume NFS accettato in formato ottale 4 cifre. Prima cifra seleziona gli attributi ID utente (4), imposta ID gruppo (2) e sticky (1). La seconda cifra seleziona l'autorizzazione per il proprietario del file: lettura (4), scrittura (2) ed esecuzione (1). In terzo luogo vengono selezionate le autorizzazioni per altri utenti nello stesso gruppo. quarto per gli altri utenti non nel gruppo. 0755 : offre autorizzazioni di lettura/scrittura/esecuzione per il proprietario e la lettura/esecuzione per raggruppare e altri utenti.

properties.usageThreshold
  • integer
0

usageThreshold
Quota di archiviazione massima consentita per un file system in byte. Questa è una quota temporanea usata solo per l'avviso. La dimensione minima è 100 GiB. Il limite superiore è 100TiB. Specificato in byte.

properties.volumeGroupName
  • string

Nome gruppo di volumi

properties.volumeSpecName
  • string

Il nome della specifica del volume è la designazione o l'identificatore dell'applicazione per il volume specifico in un gruppo di volumi, ad esempio dati, log

properties.volumeType
  • string

Il tipo di volume è questo. Per i volumi di destinazione nella replica tra aree, impostare il tipo su DataProtection

tags
  • object

Tag di risorse.

type
  • string

Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

volumeBackupProperties

Proprietà di backup del volume

Name Type Description
backupEnabled
  • boolean

Backup abilitato

backupPolicyId
  • string

ID risorsa criteri di backup

policyEnforced
  • boolean

Criteri applicati

vaultId
  • string

ID risorsa dell'insieme di credenziali

volumeSnapshotProperties

Proprietà snapshot del volume

Name Type Description
snapshotPolicyId
  • string

Id risorsa criteri snapshot

VolumeStorageToNetworkProximity

Prossimità tra archiviazione e rete

Name Type Description
Default
  • string

Archiviazione di base per la connettività di rete.

T1
  • string

Archiviazione T1 standard per la connettività di rete.

T2
  • string

Archiviazione T2 standard per la connettività di rete.