Volumes - Get

Décrire un volume
Obtenir les détails du volume spécifié

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

Paramètres URI

Name In Required Type Description
accountName
path True
  • string

Nom du compte NetApp

poolName
path True
  • string

Nom du pool de capacités

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

resourceGroupName
path True
  • string

Nom du groupe de ressources.

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

subscriptionId
path True
  • string

Informations d’identification d’abonnement qui identifient de manière unique l’abonnement Microsoft Azure. L’ID d’abonnement fait partie de l’URI pour chaque appel de service.

volumeName
path True
  • string

Nom du volume

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

api-version
query True
  • string

Version de l’API à utiliser pour cette opération.

Réponses

Name Type Description
200 OK

OK

Other Status Codes

Réponse d’erreur décrivant la raison de l’échec de l’opération.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

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

Scopes

Name Description
user_impersonation emprunt d’identité de votre compte d’utilisateur

Exemples

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

Définitions

avsDataStore

avsDataStore

ChownMode

Ce paramètre spécifie qui est autorisé à modifier la propriété d’un fichier. restreint : seul l’utilisateur racine peut modifier la propriété du fichier. sans restriction : les utilisateurs non racines peuvent modifier la propriété des fichiers qu’ils possèdent.

DataProtection

DataProtection

enableSubvolumes

Indicateur indiquant si les opérations de sous-activité sont activées sur le volume

EndpointType

Indique si le volume local est la source ou la destination de la réplication de volume

ExportPolicy

exportPolicy

exportPolicyRule

Règle de stratégie d’exportation de volume

mountTargetProperties

Propriétés de la cible de montage

NetworkFeatures

Fonctionnalités réseau

placementKeyValuePairs

Paramètres spécifiques à l’application pour le placement des volumes dans le groupe de volumes

replicationObject

Propriétés de réplication

ReplicationSchedule

Planifier

SecurityStyle

Style de sécurité du volume, unix par défaut, par défaut, ntfs pour le protocole double protocole ou CIFS

ServiceLevel

serviceLevel

volume

Ressource de volume

volumeBackupProperties

Propriétés de sauvegarde de volume

volumeSnapshotProperties

Propriétés de l’instantané de volume

VolumeStorageToNetworkProximity

Stockage à proximité du réseau

avsDataStore

avsDataStore

Name Type Description
Disabled
  • string

avsDataStore est désactivé

Enabled
  • string

avsDataStore est activé

ChownMode

Ce paramètre spécifie qui est autorisé à modifier la propriété d’un fichier. restreint : seul l’utilisateur racine peut modifier la propriété du fichier. sans restriction : les utilisateurs non racines peuvent modifier la propriété des fichiers qu’ils possèdent.

Name Type Description
Restricted
  • string
Unrestricted
  • string

DataProtection

DataProtection

Name Type Description
backup

Backup
Propriétés de sauvegarde

replication

Replication
Propriétés de réplication

snapshot

Instantané
Propriétés d’instantané.

enableSubvolumes

Indicateur indiquant si les opérations de sous-activité sont activées sur le volume

Name Type Description
Disabled
  • string

Les sous-nombres ne sont pas activés

Enabled
  • string

Les sous-volums sont activés

EndpointType

Indique si le volume local est la source ou la destination de la réplication de volume

Name Type Description
dst
  • string
src
  • string

ExportPolicy

exportPolicy

Name Type Description
rules

Règle d’exportation de stratégie
Règle d’exportation de stratégie

exportPolicyRule

Règle de stratégie d’exportation de volume

Name Type Default Value Description
allowedClients
  • string

Spécification d’entrée du client en tant que chaîne séparée par des virgules avec des CIDRs IPv4, des adresses d’hôte IPv4 et des noms d’hôtes

chownMode Restricted

Ce paramètre spécifie qui est autorisé à modifier la propriété d’un fichier. restreint : seul l’utilisateur racine peut modifier la propriété du fichier. sans restriction : les utilisateurs non racines peuvent modifier la propriété des fichiers qu’ils possèdent.

cifs
  • boolean

Autorise le protocole CIFS

hasRootAccess
  • boolean
True

Dispose d’un accès racine au volume

kerberos5ReadOnly
  • boolean
False

Accès Kerberos5 En lecture seule. Pour être utilisé avec swagger version 2020-05-01 ou ultérieure

kerberos5ReadWrite
  • boolean
False

Accès en lecture-écriture Kerberos5. Pour être utilisé avec swagger version 2020-05-01 ou ultérieure

kerberos5iReadOnly
  • boolean
False

Accès Kerberos5i En lecture seule. Pour être utilisé avec swagger version 2020-05-01 ou ultérieure

kerberos5iReadWrite
  • boolean
False

Accès en lecture et en écriture Kerberos5i. Pour être utilisé avec swagger version 2020-05-01 ou ultérieure

kerberos5pReadOnly
  • boolean
False

Accès En lecture seule Kerberos5p. Pour être utilisé avec swagger version 2020-05-01 ou ultérieure

kerberos5pReadWrite
  • boolean
False

Accès en lecture et en écriture Kerberos5p. Pour être utilisé avec swagger version 2020-05-01 ou ultérieure

nfsv3
  • boolean

Autorise le protocole NFSv3. Activer uniquement pour les volumes de type NFSv3

nfsv41
  • boolean

Autorise le protocole NFSv4.1. Activer uniquement pour les volumes de type NFSv4.1

ruleIndex
  • integer

Index de commande

unixReadOnly
  • boolean

Accès en lecture seule

unixReadWrite
  • boolean

Accès en lecture-écriture

mountTargetProperties

Propriétés de la cible de montage

Name Type Description
fileSystemId
  • string

fileSystemId
UUID v4 utilisé pour identifier mountTarget

ipAddress
  • string

ipAddress
Adresse IPv4 de la cible de montage

mountTargetId
  • string

mountTargetId
UUID v4 utilisé pour identifier mountTarget

smbServerFqdn
  • string

smbServerFQDN
Nom de domaine complet du serveur SMB, nom de domaine complet( FQDN)

NetworkFeatures

Fonctionnalités réseau

Name Type Description
Basic
  • string

Fonctionnalité réseau de base.

Standard
  • string

Fonctionnalité réseau standard.

placementKeyValuePairs

Paramètres spécifiques à l’application pour le placement des volumes dans le groupe de volumes

Name Type Description
key
  • string

Clé d’un paramètre spécifique à l’application pour le placement des volumes dans le groupe de volumes

value
  • string

Valeur d’un paramètre spécifique à l’application pour le placement des volumes dans le groupe de volumes

replicationObject

Propriétés de réplication

Name Type Description
endpointType

Indique si le volume local est la source ou la destination de la réplication de volume

remoteVolumeRegion
  • string

Région distante pour l’autre extrémité de la réplication de volume.

remoteVolumeResourceId
  • string

ID de ressource du volume distant.

replicationId
  • string

Id

replicationSchedule

Planifier

ReplicationSchedule

Planifier

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

SecurityStyle

Style de sécurité du volume, unix par défaut, par défaut, ntfs pour le protocole double protocole ou CIFS

Name Type Description
ntfs
  • string
unix
  • string

ServiceLevel

serviceLevel

Name Type Description
Premium
  • string

Niveau de service Premium

Standard
  • string

Niveau de service standard

StandardZRS
  • string

Niveau de service de stockage redondant interzone

Ultra
  • string

Niveau de service Ultra

volume

Ressource de volume

Name Type Default Value Description
etag
  • string

Chaîne en lecture seule unique qui change chaque fois que la ressource est mise à jour.

id
  • string

ID de ressource complet pour la ressource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location
  • string

Emplacement géographique où la ressource vit

name
  • string

nom de la ressource.

properties.avsDataStore Disabled

avsDataStore
Spécifie si le volume est activé à des fins de magasin de données AZURE VMWARE SOLUTION (AVS)

properties.backupId
  • string

ID de la sauvegarde
UUID v4 ou identificateur de ressource utilisé pour identifier la sauvegarde.

properties.baremetalTenantId
  • string

ID de locataire Baremetal
Identificateur de locataire Numetal unique.

properties.capacityPoolResourceId
  • string

ID de ressource du pool utilisé en cas de création d’un volume via un groupe de volumes

properties.cloneProgress
  • integer

Lorsqu’un volume est restauré à partir d’un instantané d’un autre volume, affiche le pourcentage d’achèvement de ce processus de clonage. Lorsque cette valeur est vide/null, aucun processus de clonage ne se produit actuellement sur ce volume. Cette valeur sera mise à jour toutes les 5 minutes pendant le clonage.

properties.coolAccess
  • boolean
False

Spécifie si l’accès froid (hiérarchisation) est activé pour le volume.

properties.coolnessPeriod
  • integer

Spécifie le nombre de jours après lesquels les données qui ne sont pas accessibles par les clients seront hiérarchisé.

properties.creationToken
  • string

Jeton de création ou chemin d’accès au fichier
Chemin d’accès unique du fichier pour le volume. Utilisé lors de la création de cibles de montage

properties.dataProtection

DataProtection
Les volumes de type DataProtection incluent un objet contenant les détails de la réplication

properties.defaultGroupQuotaInKiBs
  • integer
0

Quota de groupe par défaut pour le volume en KiBs. Si isDefaultQuotaEnabled est défini, la valeur minimale de 4 KiB s’applique.

properties.defaultUserQuotaInKiBs
  • integer
0

Quota d’utilisateurs par défaut pour le volume dans KiBs. Si isDefaultQuotaEnabled est défini, la valeur minimale de 4 KiB s’applique.

properties.enableSubvolumes Disabled

Indicateur indiquant si les opérations de sous-activité sont activées sur le volume

properties.encryptionKeySource
  • string

Source de clé de chiffrement. Les valeurs possibles sont les suivantes : « Microsoft.NetApp »

properties.exportPolicy

exportPolicy
Ensemble de règles de stratégie d’exportation

properties.fileSystemId
  • string

FileSystem ID
Identificateur de système de fichiers unique.

properties.isDefaultQuotaEnabled
  • boolean
False

Spécifie si le quota par défaut est activé pour le volume.

properties.isRestoring
  • boolean

Restoring

properties.kerberosEnabled
  • boolean
False

Décrivez si un volume est KerberosEnabled. Pour être utilisé avec swagger version 2020-05-01 ou ultérieure

properties.ldapEnabled
  • boolean
False

Spécifie si LDAP est activé ou non pour un volume NFS donné.

properties.maximumNumberOfFiles
  • integer

Nombre maximal de fichiers autorisés. Nécessite une demande de service afin d’être modifiée. Uniquement autorisé à être modifié si le quota de volume est supérieur à 4TiB.

properties.mountTargets

mountTargets
Liste des cibles de montage

properties.networkFeatures Basic

Fonctionnalités réseau
Fonctionnalités réseau de base ou Standard disponibles pour le volume.

properties.networkSiblingSetId
  • string

ID de jeu de frères réseau
ID de jeu de frères réseau pour le groupe de volumes partageant des ressources réseau.

properties.placementRules

Règles de placement de volume
Règles de placement spécifiques à l’application pour le volume particulier

properties.protocolTypes
  • string[]

protocolTypes
Ensemble de types de protocole, NFSv3 par défaut, CIFS pour le protocole SMB

properties.provisioningState
  • string

Gestion de cycle de vie Azure

properties.proximityPlacementGroup
  • string

Groupe de placement de proximité associé au volume

properties.securityStyle unix

Style de sécurité du volume, unix par défaut, par défaut, ntfs pour le protocole double protocole ou CIFS

properties.serviceLevel Premium

serviceLevel
Niveau de service du système de fichiers

properties.smbContinuouslyAvailable
  • boolean
False

Active la propriété de partage disponible en continu pour le volume smb. Applicable uniquement pour le volume SMB

properties.smbEncryption
  • boolean
False

Active le chiffrement pour les données smb3 en cours d’exécution. Applicable uniquement pour le volume SMB/DualProtocol. Pour être utilisé avec swagger version 2020-08-01 ou ultérieure

properties.snapshotDirectoryVisible
  • boolean
True

Si cette option est activée (true), le volume contient un répertoire d’instantané en lecture seule qui fournit l’accès à chacun des instantanés du volume (valeur par défaut true).

properties.snapshotId
  • string

ID d’instantané
UUID v4 ou identificateur de ressource utilisé pour identifier l’instantané.

properties.storageToNetworkProximity

Stockage à proximité du réseau
Fournit un stockage aux informations de proximité réseau pour le volume.

properties.subnetId
  • string

URI de ressource Azure pour un sous-réseau délégué. Doit avoir la délégation Microsoft.NetApp/volumes

properties.t2Network
  • string

Informations réseau T2

properties.throughputMibps
  • number

Débit maximal en Mibits/s pouvant être atteint par ce volume et il est accepté comme entrée uniquement pour le volume qosType manuel

properties.unixPermissions
  • string
0770

Autorisations UNIX pour le volume NFS accepté au format octal 4 chiffres. Le premier chiffre sélectionne l’ID d’utilisateur défini(4), l’ID de groupe (2) et les attributs sticky (1). Le deuxième chiffre sélectionne l’autorisation pour le propriétaire du fichier : lecture (4), écriture (2) et exécution (1). Troisièmement, les autorisations sont sélectionnées pour d’autres utilisateurs du même groupe. quatrième pour les autres utilisateurs non dans le groupe. 0755 : donne des autorisations en lecture/écriture/exécution au propriétaire et en lecture/exécution au groupe et aux autres utilisateurs.

properties.usageThreshold
  • integer
0

usageThreshold
Quota de stockage maximal autorisé pour un système de fichiers en octets. Il s’agit d’un quota souple utilisé uniquement pour l’alerte. La taille minimale est de 100 Gio. La limite supérieure est 100TiB. Spécifié en octets.

properties.volumeGroupName
  • string

Nom du groupe de volumes

properties.volumeSpecName
  • string

Le nom des spécifications de volume est la désignation ou l’identificateur spécifique de l’application pour le volume particulier dans un groupe de volumes pour les données, les journaux d’activité

properties.volumeType
  • string

Quel type de volume il s’agit. Pour les volumes de destination dans la réplication interrégion, définissez le type sur DataProtection

tags
  • object

Balises de ressource.

type
  • string

Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

volumeBackupProperties

Propriétés de sauvegarde de volume

Name Type Description
backupEnabled
  • boolean

Sauvegarde activée

backupPolicyId
  • string

ID de ressource de stratégie de sauvegarde

policyEnforced
  • boolean

Stratégie appliquée

vaultId
  • string

ID de ressource du coffre

volumeSnapshotProperties

Propriétés de l’instantané de volume

Name Type Description
snapshotPolicyId
  • string

ResourceId de stratégie d’instantané

VolumeStorageToNetworkProximity

Stockage à proximité du réseau

Name Type Description
Default
  • string

Stockage de base pour la connectivité réseau.

T1
  • string

Stockage T1 standard vers la connectivité réseau.

T2
  • string

Stockage T2 standard vers la connectivité réseau.