Volumes - Update

Référence

Service:: Azure NetApp Files

Version d'API:: 2024-07-01

Mettre à jour un volume
Corriger le volume spécifié

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
accountName	path	True	string	Nom du compte NetApp Modèle d’expression régulière: `^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,127}$`
poolName	path	True	string	Nom du pool de capacités Modèle d’expression régulière: `^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,63}$`
resourceGroupName	path	True	string	Nom du groupe de ressources. Le nom ne respecte pas la casse.
subscriptionId	path	True	string uuid	ID de l’abonnement cible. La valeur doit être un UUID.
volumeName	path	True	string	Nom du volume Modèle d’expression régulière: `^[a-zA-Z][a-zA-Z0-9\-_]{0,63}$`
api-version	query	True	string	Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom	Type	Description
location	string	Emplacement des ressources
properties.coolAccess	boolean	Spécifie si l’accès froid (hiérarchisation) est activé pour le volume.
properties.coolAccessRetrievalPolicy	coolAccessRetrievalPolicy	coolAccessRetrievalPolicy détermine le comportement de récupération des données du niveau froid au stockage standard en fonction du modèle de lecture pour les volumes activés pour l’accès froid. Les valeurs possibles pour ce champ sont les suivantes : les données sont extraites du niveau froid au stockage standard sur les lectures aléatoires. Cette stratégie est la valeur par défaut. OnRead : toutes les lectures de données pilotées par le client sont extraites du niveau froid au stockage standard sur les lectures séquentielles et aléatoires. Jamais - Aucune donnée pilotée par le client n’est extraite du niveau froid au stockage standard.
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.dataProtection	volumePatchProperties.DataProtection	DataProtection Les volumes de type DataProtection incluent un objet contenant les détails de la réplication
properties.defaultGroupQuotaInKiBs	integer	Quota de groupe par défaut pour le volume en KiB. Si isDefaultQuotaEnabled est défini, la valeur minimale de 4 Kib s’applique.
properties.defaultUserQuotaInKiBs	integer	Quota d’utilisateur par défaut pour le volume en KiB. Si isDefaultQuotaEnabled est défini, la valeur minimale de 4 KiB s’applique.
properties.exportPolicy	volumePatchProperties.ExportPolicy	exportPolicy Ensemble de règles de stratégie d’exportation
properties.isDefaultQuotaEnabled	boolean	Spécifie si le quota par défaut est activé pour le volume.
properties.protocolTypes	string[]	protocolTypes Ensemble de types de protocole, NFSv3 par défaut, CIFS pour le protocole SMB
properties.serviceLevel	ServiceLevel	serviceLevel Niveau de service du système de fichiers
properties.smbAccessBasedEnumeration	smbAccessBasedEnumeration	smbAccessBasedEnumeration Active la propriété de partage d’énumération basée sur l’accès pour les partages SMB. Applicable uniquement pour le volume SMB/DualProtocol
properties.smbNonBrowsable	smbNonBrowsable	smbNonBrowsable Active la propriété non extensible pour les partages SMB. Applicable uniquement pour le volume SMB/DualProtocol
properties.snapshotDirectoryVisible	boolean	Si cette option est activée (true), le volume contient un répertoire d’instantanés en lecture seule qui fournit l’accès à chacun des instantanés du volume.
properties.throughputMibps	number	Débit maximal en Mio/s pouvant être atteint par ce volume et il est accepté comme entrée uniquement pour le volume qosType manuel
properties.unixPermissions	string	Autorisations UNIX pour le volume NFS acceptés au format octal 4 chiffres. Le premier chiffre sélectionne l’ID utilisateur (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 qui ne se sont pas dans le groupe. 0755 : donne des autorisations de lecture/écriture/d’exécution au propriétaire et en lecture/exécution pour le groupe et d’autres utilisateurs.
properties.usageThreshold	integer	usageThreshold Quota de stockage maximal autorisé pour un système de fichiers en octets. Il s’agit d’un quota souple utilisé uniquement pour les alertes. Pour les volumes réguliers, les valeurs valides sont comprises entre 50GiB et 100TiB. Pour les volumes volumineux, les valeurs valides sont comprises entre 100TiB et 500TiB, et de 2400GiB à 2400TiB. Valeurs exprimées en octets sous forme de multiples de 1 Gio.
tags	object	Balises de ressource

Réponses

Nom	Type	Description
200 OK	volume	D’ACCORD
202 Accepted		Accepté - Créer ou mettre à jour une demande acceptée ; l’opération se termine de manière asynchrone
Other Status Codes	ErrorResponse	Réponse d’erreur décrivant pourquoi l’opération a échoué.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

Volumes_Update

Exemple de requête

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

{}


import com.azure.resourcemanager.netapp.models.Volume;

/**
 * Samples for Volumes Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/netapp/resource-manager/Microsoft.NetApp/stable/2024-07-01/examples/Volumes_Update.json
     */
    /**
     * Sample code: Volumes_Update.
     * 
     * @param manager Entry point to NetAppFilesManager.
     */
    public static void volumesUpdate(com.azure.resourcemanager.netapp.NetAppFilesManager manager) {
        Volume resource = manager.volumes()
            .getWithResponse("myRG", "account1", "pool1", "volume1", com.azure.core.util.Context.NONE).getValue();
        resource.update().apply();
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armnetapp_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/netapp/armnetapp/v7"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/366aaa13cdd218b9adac716680e49473673410c8/specification/netapp/resource-manager/Microsoft.NetApp/stable/2024-07-01/examples/Volumes_Update.json
func ExampleVolumesClient_BeginUpdate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armnetapp.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewVolumesClient().BeginUpdate(ctx, "myRG", "account1", "pool1", "volume1", armnetapp.VolumePatch{}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.Volume = armnetapp.Volume{
	// 	Name: to.Ptr("account1/pool1/volume1"),
	// 	Type: to.Ptr("Microsoft.NetApp/netAppAccounts/capacityPools/volumes"),
	// 	ID: to.Ptr("/subscriptions/subscriptionId/resourceGroups/resourceGroup/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1/volumes/volume1"),
	// 	Location: to.Ptr("eastus"),
	// 	Properties: &armnetapp.VolumeProperties{
	// 		CreationToken: to.Ptr("some-amazing-filepath"),
	// 		DataProtection: &armnetapp.VolumePropertiesDataProtection{
	// 			Snapshot: &armnetapp.VolumeSnapshotProperties{
	// 				SnapshotPolicyID: to.Ptr("/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRP/providers/Microsoft.NetApp/netAppAccounts/account1/snapshotPolicies/snapshotPolicy1"),
	// 			},
	// 		},
	// 		FileSystemID: to.Ptr("9760acf5-4638-11e7-9bdb-020073ca7778"),
	// 		NetworkFeatures: to.Ptr(armnetapp.NetworkFeaturesStandard),
	// 		NetworkSiblingSetID: to.Ptr("0f434a03-ce0b-4935-81af-d98652ffb1c4"),
	// 		ProvisioningState: to.Ptr("Succeeded"),
	// 		ServiceLevel: to.Ptr(armnetapp.ServiceLevelPremium),
	// 		StorageToNetworkProximity: to.Ptr(armnetapp.VolumeStorageToNetworkProximityT2),
	// 		SubnetID: to.Ptr("/subscriptions/9760acf5-4638-11e7-9bdb-020073ca7778/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/testvnet3/subnets/testsubnet3"),
	// 		ThroughputMibps: to.Ptr[float32](128),
	// 		UsageThreshold: to.Ptr[int64](107374182400),
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { NetAppManagementClient } = require("@azure/arm-netapp");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Patch the specified volume
 *
 * @summary Patch the specified volume
 * x-ms-original-file: specification/netapp/resource-manager/Microsoft.NetApp/stable/2024-07-01/examples/Volumes_Update.json
 */
async function volumesUpdate() {
  const subscriptionId =
    process.env["NETAPP_SUBSCRIPTION_ID"] || "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9";
  const resourceGroupName = process.env["NETAPP_RESOURCE_GROUP"] || "myRG";
  const accountName = "account1";
  const poolName = "pool1";
  const volumeName = "volume1";
  const body = {};
  const credential = new DefaultAzureCredential();
  const client = new NetAppManagementClient(credential, subscriptionId);
  const result = await client.volumes.beginUpdateAndWait(
    resourceGroupName,
    accountName,
    poolName,
    volumeName,
    body,
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

using Azure;
using Azure.ResourceManager;
using System;
using System.Net;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.NetApp.Models;
using Azure.ResourceManager.NetApp;

// Generated from example definition: specification/netapp/resource-manager/Microsoft.NetApp/stable/2024-07-01/examples/Volumes_Update.json
// this example is just showing the usage of "Volumes_Update" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this NetAppVolumeResource created on azure
// for more information of creating NetAppVolumeResource, please refer to the document of NetAppVolumeResource
string subscriptionId = "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9";
string resourceGroupName = "myRG";
string accountName = "account1";
string poolName = "pool1";
string volumeName = "volume1";
ResourceIdentifier netAppVolumeResourceId = NetAppVolumeResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, accountName, poolName, volumeName);
NetAppVolumeResource netAppVolume = client.GetNetAppVolumeResource(netAppVolumeResourceId);

// invoke the operation
NetAppVolumePatch patch = new NetAppVolumePatch(new AzureLocation("placeholder"));
ArmOperation<NetAppVolumeResource> lro = await netAppVolume.UpdateAsync(WaitUntil.Completed, patch);
NetAppVolumeResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
NetAppVolumeData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Exemple de réponse

Code d’état:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup/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",
    "dataProtection": {
      "snapshot": {
        "snapshotPolicyId": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRP/providers/Microsoft.NetApp/netAppAccounts/account1/snapshotPolicies/snapshotPolicy1"
      }
    }
  }
}

Code d’état:: 202

Location: https://management.azure.com/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/providers/Microsoft.NetApp/locations/eastus/operationResults/616ee961-4042-4935-b4a0-ed6f4dae0172?api-version=2024-07-01&operationResultResponseType=Location

Définitions

Nom	Description
avsDataStore	avsDataStore
ChownMode	Ce paramètre spécifie qui est autorisé à modifier la propriété d’un fichier. restricted : 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.
coolAccessRetrievalPolicy	coolAccessRetrievalPolicy détermine le comportement de récupération des données du niveau froid au stockage standard en fonction du modèle de lecture pour les volumes activés pour l’accès froid. Les valeurs possibles pour ce champ sont les suivantes : les données sont extraites du niveau froid au stockage standard sur les lectures aléatoires. Cette stratégie est la valeur par défaut. OnRead : toutes les lectures de données pilotées par le client sont extraites du niveau froid au stockage standard sur les lectures séquentielles et aléatoires. Jamais - Aucune donnée pilotée par le client n’est extraite du niveau froid au stockage standard.
createdByType	Type d’identité qui a créé la ressource.
DataProtection	DataProtection
enableSubvolumes	Indicateur indiquant si les opérations de sous-volume sont activées sur le volume
EncryptionKeySource	Source de clé utilisée pour chiffrer les données en volume. Applicable si le compte NetApp a encryption.keySource = 'Microsoft.KeyVault'. Les valeurs possibles (sans respect de la casse) sont : « Microsoft.NetApp, Microsoft.KeyVault »
EndpointType	Indique si le volume local est la source ou la destination de la réplication de volume
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
ExportPolicy	exportPolicy
exportPolicyRule	Règle de stratégie d’exportation de volume
fileAccessLogs	Indicateur indiquant si les journaux d’accès aux fichiers sont activés pour le volume, en fonction des paramètres de diagnostic actifs présents sur le 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
remotePath	Chemin complet d’un volume à migrer vers ANF. Requis pour les volumes de migration
replicationObject	Propriétés de réplication
ReplicationSchedule	Horaire
SecurityStyle	Le style de sécurité du volume, unix par défaut, est ntfs pour le protocole double protocole ou CIFS
ServiceLevel	serviceLevel
smbAccessBasedEnumeration	smbAccessBasedEnumeration
smbNonBrowsable	smbNonBrowsable
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.
volume	Ressource de volume
volumeBackupProperties	Propriétés de sauvegarde de volume
volumePatch	Ressource de correctif de volume
volumePatch.volumePatchProperties.DataProtection	DataProtection
volumePatch.volumePatchProperties.ExportPolicy	exportPolicy
volumePatchProperties.DataProtection	DataProtection
volumePatchProperties.ExportPolicy	exportPolicy
volumeRelocationProperties	Propriétés de réadressage de volume
volumeSnapshotProperties	Propriétés d’instantané de volume
VolumeStorageToNetworkProximity	Stockage à proximité du réseau

avsDataStore

Nom	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. restricted : 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.

Nom	Type	Description
Restricted	string
Unrestricted	string

coolAccessRetrievalPolicy

coolAccessRetrievalPolicy détermine le comportement de récupération des données du niveau froid au stockage standard en fonction du modèle de lecture pour les volumes activés pour l’accès froid. Les valeurs possibles pour ce champ sont les suivantes : les données sont extraites du niveau froid au stockage standard sur les lectures aléatoires. Cette stratégie est la valeur par défaut. OnRead : toutes les lectures de données pilotées par le client sont extraites du niveau froid au stockage standard sur les lectures séquentielles et aléatoires. Jamais - Aucune donnée pilotée par le client n’est extraite du niveau froid au stockage standard.

Nom	Type	Description
Default	string
Never	string
OnRead	string

createdByType

Type d’identité qui a créé la ressource.

Nom	Type	Description
Application	string
Key	string
ManagedIdentity	string
User	string

DataProtection

Nom	Type	Description
backup	volumeBackupProperties	Sauvegarde Propriétés de sauvegarde
replication	replicationObject	Réplication Propriétés de réplication
snapshot	volumeSnapshotProperties	Instantané Propriétés d’instantané.
volumeRelocation	volumeRelocationProperties	VolumeRelocation Propriétés VolumeRelocation

enableSubvolumes

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

Nom	Type	Description
Disabled	string	les sous-volums ne sont pas activés
Enabled	string	les sous-volumes sont activées

EncryptionKeySource

Source de clé utilisée pour chiffrer les données en volume. Applicable si le compte NetApp a encryption.keySource = 'Microsoft.KeyVault'. Les valeurs possibles (sans respect de la casse) sont : « Microsoft.NetApp, Microsoft.KeyVault »

Nom	Type	Description
Microsoft.KeyVault	string	Chiffrement de clé gérée par le client
Microsoft.NetApp	string	Chiffrement de clé managée par Microsoft

EndpointType

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

Nom	Type	Description
dst	string
src	string

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires.
type	string	Type d’informations supplémentaire.

ErrorDetail

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d’erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorResponse

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

ExportPolicy

exportPolicy

Nom	Type	Description
rules	exportPolicyRule[]	Règle de stratégie d’exportation Règle de stratégie d’exportation

exportPolicyRule

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

Nom	Type	Valeur par défaut	Description
allowedClients	string		Spécification d’entrée du client en tant que chaîne séparée par des virgules avec des CIDR IPv4, des adresses hôtes IPv4 et des noms d’hôtes
chownMode	ChownMode	Restricted	Ce paramètre spécifie qui est autorisé à modifier la propriété d’un fichier. restricted : 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 En lecture seule Kerberos5. 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 En lecture seule Kerberos5i. Pour être utilisé avec swagger version 2020-05-01 ou ultérieure
kerberos5iReadWrite	boolean	False	Accès en lecture-é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 et écriture

fileAccessLogs

Indicateur indiquant si les journaux d’accès aux fichiers sont activés pour le volume, en fonction des paramètres de diagnostic actifs présents sur le volume.

Nom	Type	Description
Disabled	string	fileAccessLogs n’est pas activé
Enabled	string	fileAccessLogs est activé

mountTargetProperties

Propriétés de la cible de montage

Nom	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

NetworkFeatures

Fonctionnalités réseau

Nom	Type	Description
Basic	string	Fonctionnalités réseau de base.
Basic_Standard	string	Mise à jour des fonctionnalités réseau de base vers Standard.
Standard	string	Fonctionnalités réseau standard.
Standard_Basic	string	Mise à jour de fonctionnalités réseau standard vers de base.

placementKeyValuePairs

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

Nom	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

remotePath

Chemin complet d’un volume à migrer vers ANF. Requis pour les volumes de migration

Nom	Type	Description
externalHostName	string	Chemin d’accès à un hôte ONTAP
serverName	string	Nom d’un serveur sur l’hôte ONTAP
volumeName	string	Nom d’un volume sur le serveur

replicationObject

Propriétés de réplication

Nom	Type	Description
endpointType	EndpointType	Indique si le volume local est la source ou la destination de la réplication de volume
remotePath	remotePath	Chemin complet d’un volume à migrer vers ANF. Requis pour les volumes de migration
remoteVolumeRegion	string	Région distante pour l’autre extrémité de la réplication de volume.
remoteVolumeResourceId	string	ID de ressource du volume distant. Obligatoire pour la réplication interrégion et interzone
replicationId	string	Id
replicationSchedule	ReplicationSchedule	Horaire

ReplicationSchedule

Horaire

Nom	Type	Description
_10minutely	string
daily	string
hourly	string

SecurityStyle

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

Nom	Type	Description
ntfs	string
unix	string

ServiceLevel

serviceLevel

Nom	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

smbAccessBasedEnumeration

Nom	Type	Description
Disabled	string	Le paramètre de partage smbAccessBasedEnumeration est désactivé
Enabled	string	Le paramètre de partage smbAccessBasedEnumeration est activé

smbNonBrowsable

Nom	Type	Description
Disabled	string	le paramètre de partage smbNonBrowsable est désactivé
Enabled	string	Le paramètre de partage smbNonBrowsable est activé

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string	Horodatage de la dernière modification de ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType	createdByType	Type d’identité qui a modifié la ressource pour la dernière fois.

volume

Ressource de volume

Nom	Type	Valeur par défaut	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. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »
location	string		Emplacement géographique où réside la ressource
name	string		Nom de la ressource
properties.actualThroughputMibps	number		Débit réel en Mio/s pour les volumes qosType automatiques calculés en fonction de la taille et du serviceLevel
properties.avsDataStore	avsDataStore	Disabled	avsDataStore Spécifie si le volume est activé pour le magasin de données Azure VMware Solution (AVS)
properties.backupId	string		ID de sauvegarde Identificateur de ressource utilisé pour identifier la sauvegarde.
properties.baremetalTenantId	string		ID de locataire Baremetal Identificateur de locataire Baremetal unique.
properties.capacityPoolResourceId	string		ID de ressource du pool utilisé en cas de création d’un volume par le biais d’un groupe de volumes
properties.cloneProgress	integer		Lorsqu’un volume est restauré à partir de l’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.coolAccessRetrievalPolicy	coolAccessRetrievalPolicy		coolAccessRetrievalPolicy détermine le comportement de récupération des données du niveau froid au stockage standard en fonction du modèle de lecture pour les volumes activés pour l’accès froid. Les valeurs possibles pour ce champ sont les suivantes : les données sont extraites du niveau froid au stockage standard sur les lectures aléatoires. Cette stratégie est la valeur par défaut. OnRead : toutes les lectures de données pilotées par le client sont extraites du niveau froid au stockage standard sur les lectures séquentielles et aléatoires. Jamais - Aucune donnée pilotée par le client n’est extraite du niveau froid au stockage standard.
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		DataProtection Les volumes de type DataProtection incluent un objet contenant les détails de la réplication
properties.dataStoreResourceId	string[]		dataStoreResourceId Identificateur unique de ressource du magasin de données
properties.defaultGroupQuotaInKiBs	integer	0	Quota de groupe par défaut pour le volume en KiB. Si isDefaultQuotaEnabled est défini, la valeur minimale de 4 Kib s’applique.
properties.defaultUserQuotaInKiBs	integer	0	Quota d’utilisateur par défaut pour le volume en KiB. Si isDefaultQuotaEnabled est défini, la valeur minimale de 4 KiB s’applique.
properties.deleteBaseSnapshot	boolean		Si la valeur est activée (true), l’instantané à partir duquel le volume a été créé est automatiquement supprimé une fois l’opération de création de volume terminée. La valeur par défaut est false
properties.effectiveNetworkFeatures	NetworkFeatures	Basic	Fonctionnalités réseau Valeur effective du type de fonctionnalités réseau disponible pour le volume ou état effectif actuel de la mise à jour.
properties.enableSubvolumes	enableSubvolumes	Disabled	Indicateur indiquant si les opérations de sous-volume sont activées sur le volume
properties.encrypted	boolean		Spécifie si le volume est chiffré ou non. Disponible uniquement sur les volumes créés ou mis à jour après 2022-01-01.
properties.encryptionKeySource	EncryptionKeySource	Microsoft.NetApp	Source de clé utilisée pour chiffrer les données en volume. Applicable si le compte NetApp a encryption.keySource = 'Microsoft.KeyVault'. Les valeurs possibles (sans respect de la casse) sont : « Microsoft.NetApp, Microsoft.KeyVault »
properties.exportPolicy	ExportPolicy		exportPolicy Ensemble de règles de stratégie d’exportation
properties.fileAccessLogs	fileAccessLogs	Disabled	Indicateur indiquant si les journaux d’accès aux fichiers sont activés pour le volume, en fonction des paramètres de diagnostic actifs présents sur le volume.
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.isLargeVolume	boolean	False	Est grand volume Spécifie si le volume est un volume volumineux ou un volume normal.
properties.isRestoring	boolean		Restauration
properties.kerberosEnabled	boolean	False	Décrivez si un volume est KerberosEnabled. Pour être utilisé avec swagger version 2020-05-01 ou ultérieure
properties.keyVaultPrivateEndpointResourceId	string		ID de ressource du point de terminaison privé pour KeyVault. Il doit résider dans le même réseau virtuel que le volume. Applicable uniquement si encryptionKeySource = 'Microsoft.KeyVault'.
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 pour être modifiée. Uniquement autorisé à être modifié si le quota de volume est supérieur à 4TiB.
properties.mountTargets	mountTargetProperties[]		mountTargets Liste des cibles de montage
properties.networkFeatures	NetworkFeatures	Basic	Fonctionnalités réseau Valeur d’origine du type de fonctionnalités réseau disponible pour le volume au moment de sa création.
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.originatingResourceId	string		ID de ressource d’origine ID de l’instantané ou de la sauvegarde à partir duquel le volume est restauré.
properties.placementRules	placementKeyValuePairs[]		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.provisionedAvailabilityZone	string		Zone de disponibilité provisionnée Zone de disponibilité où le volume est approvisionné. Cela fait référence à la zone de disponibilité logique où réside le volume.
properties.provisioningState	string		Gestion du cycle de vie Azure
properties.proximityPlacementGroup	string		Groupe de placement de proximité associé au volume
properties.securityStyle	SecurityStyle	unix	Le style de sécurité du volume, unix par défaut, est ntfs pour le protocole double protocole ou CIFS
properties.serviceLevel	ServiceLevel	Premium	serviceLevel Niveau de service du système de fichiers
properties.smbAccessBasedEnumeration	smbAccessBasedEnumeration		smbAccessBasedEnumeration Active la propriété de partage d’énumération basée sur l’accès pour les partages SMB. Applicable uniquement pour le volume SMB/DualProtocol
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. À utiliser avec swagger version 2020-08-01 ou ultérieure
properties.smbNonBrowsable	smbNonBrowsable		smbNonBrowsable Active la propriété non extensible pour les partages SMB. Applicable uniquement pour le volume SMB/DualProtocol
properties.snapshotDirectoryVisible	boolean	True	Si cette option est activée (true), le volume contient un répertoire d’instantanés 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é Identificateur de ressource utilisé pour identifier l’instantané.
properties.storageToNetworkProximity	VolumeStorageToNetworkProximity		Stockage à proximité du réseau Fournit du 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 Mio/s pouvant être atteint par ce volume et il est accepté comme entrée uniquement pour le volume qosType manuel
properties.unixPermissions	string		Autorisations UNIX pour le volume NFS acceptés au format octal 4 chiffres. Le premier chiffre sélectionne l’ID utilisateur (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 qui ne se sont pas dans le groupe. 0755 : donne des autorisations de lecture/écriture/d’exécution au propriétaire et en lecture/exécution pour le groupe et d’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 les alertes. Pour les volumes réguliers, les valeurs valides sont comprises entre 50GiB et 100TiB. Pour les volumes volumineux, les valeurs valides sont comprises entre 100TiB et 500TiB, et de 2400GiB à 2400TiB. Valeurs exprimées en octets sous forme de multiples de 1 Gio.
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, par exemple les données, les journaux
properties.volumeType	string		Quel est le type de volume. Pour les volumes de destination dans la réplication interrégion, définissez le type sur DataProtection
systemData	systemData		Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.
tags	object		Balises de ressource.
type	string		Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »
zones	string[]		Zone de disponibilité

volumeBackupProperties

Propriétés de sauvegarde de volume

Nom	Type	Description
backupPolicyId	string	ID de ressource de stratégie de sauvegarde
backupVaultId	string	ID de ressource du coffre de sauvegarde
policyEnforced	boolean	Stratégie appliquée

volumePatch

Ressource de correctif de volume

Nom	Type	Valeur par défaut	Description
id	string		ID de ressource
location	string		Emplacement des ressources
name	string		Nom de la ressource
properties.coolAccess	boolean		Spécifie si l’accès froid (hiérarchisation) est activé pour le volume.
properties.coolAccessRetrievalPolicy	coolAccessRetrievalPolicy		coolAccessRetrievalPolicy détermine le comportement de récupération des données du niveau froid au stockage standard en fonction du modèle de lecture pour les volumes activés pour l’accès froid. Les valeurs possibles pour ce champ sont les suivantes : les données sont extraites du niveau froid au stockage standard sur les lectures aléatoires. Cette stratégie est la valeur par défaut. OnRead : toutes les lectures de données pilotées par le client sont extraites du niveau froid au stockage standard sur les lectures séquentielles et aléatoires. Jamais - Aucune donnée pilotée par le client n’est extraite du niveau froid au stockage standard.
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.dataProtection	volumePatchProperties.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 KiB. Si isDefaultQuotaEnabled est défini, la valeur minimale de 4 Kib s’applique.
properties.defaultUserQuotaInKiBs	integer	0	Quota d’utilisateur par défaut pour le volume en KiB. Si isDefaultQuotaEnabled est défini, la valeur minimale de 4 KiB s’applique.
properties.exportPolicy	volumePatchProperties.ExportPolicy		exportPolicy Ensemble de règles de stratégie d’exportation
properties.isDefaultQuotaEnabled	boolean	False	Spécifie si le quota par défaut est activé pour le volume.
properties.protocolTypes	string[]		protocolTypes Ensemble de types de protocole, NFSv3 par défaut, CIFS pour le protocole SMB
properties.serviceLevel	ServiceLevel	Premium	serviceLevel Niveau de service du système de fichiers
properties.smbAccessBasedEnumeration	smbAccessBasedEnumeration		smbAccessBasedEnumeration Active la propriété de partage d’énumération basée sur l’accès pour les partages SMB. Applicable uniquement pour le volume SMB/DualProtocol
properties.smbNonBrowsable	smbNonBrowsable		smbNonBrowsable Active la propriété non extensible pour les partages SMB. Applicable uniquement pour le volume SMB/DualProtocol
properties.snapshotDirectoryVisible	boolean		Si cette option est activée (true), le volume contient un répertoire d’instantanés en lecture seule qui fournit l’accès à chacun des instantanés du volume.
properties.throughputMibps	number		Débit maximal en Mio/s pouvant être atteint par ce volume et il est accepté comme entrée uniquement pour le volume qosType manuel
properties.unixPermissions	string		Autorisations UNIX pour le volume NFS acceptés au format octal 4 chiffres. Le premier chiffre sélectionne l’ID utilisateur (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 qui ne se sont pas dans le groupe. 0755 : donne des autorisations de lecture/écriture/d’exécution au propriétaire et en lecture/exécution pour le groupe et d’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 les alertes. Pour les volumes réguliers, les valeurs valides sont comprises entre 50GiB et 100TiB. Pour les volumes volumineux, les valeurs valides sont comprises entre 100TiB et 500TiB, et de 2400GiB à 2400TiB. Valeurs exprimées en octets sous forme de multiples de 1 Gio.
tags	object		Balises de ressource
type	string		Type de ressource

volumePatch.volumePatchProperties.DataProtection

DataProtection

Nom	Type	Description
backup	volumeBackupProperties	Sauvegarde Propriétés de sauvegarde
snapshot	volumeSnapshotProperties	Instantané Propriétés d’instantané.

volumePatch.volumePatchProperties.ExportPolicy

exportPolicy

Nom	Type	Description
rules	exportPolicyRule[]	Règle de stratégie d’exportation Règle de stratégie d’exportation

volumePatchProperties.DataProtection

DataProtection

Nom	Type	Description
backup	volumeBackupProperties	Sauvegarde Propriétés de sauvegarde
snapshot	volumeSnapshotProperties	Instantané Propriétés d’instantané.

volumePatchProperties.ExportPolicy

exportPolicy

Nom	Type	Description
rules	exportPolicyRule[]	Règle de stratégie d’exportation Règle de stratégie d’exportation

volumeRelocationProperties

Propriétés de réadressage de volume

Nom	Type	Description
readyToBeFinalized	boolean	A terminé la réinstallation et est prêt à être nettoyé
relocationRequested	boolean	Le déplacement a été demandé pour ce volume

volumeSnapshotProperties

Propriétés d’instantané de volume

Nom	Type	Description
snapshotPolicyId	string	ResourceId de stratégie d’instantané

VolumeStorageToNetworkProximity

Stockage à proximité du réseau

Nom	Type	Description
AcrossT2	string	Stockage Standard AcrossT2 vers la connectivité réseau.
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.

Partager via

Volumes - Update

Paramètres URI

Corps de la demande

Réponses

Sécurité

azure_auth

Étendues

Exemples

Volumes_Update

Exemple de requête

Exemple de réponse

Définitions

avsDataStore

ChownMode

coolAccessRetrievalPolicy

createdByType

DataProtection

enableSubvolumes

EncryptionKeySource

EndpointType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExportPolicy

exportPolicyRule

fileAccessLogs

mountTargetProperties

NetworkFeatures

placementKeyValuePairs

remotePath

replicationObject

ReplicationSchedule

SecurityStyle

ServiceLevel

smbAccessBasedEnumeration

smbNonBrowsable

systemData

volume

volumeBackupProperties

volumePatch

volumePatch.volumePatchProperties.DataProtection

volumePatch.volumePatchProperties.ExportPolicy

volumePatchProperties.DataProtection

volumePatchProperties.ExportPolicy

volumeRelocationProperties

volumeSnapshotProperties

VolumeStorageToNetworkProximity

Ressources supplémentaires