Volumes - Create Or Update

Servicio:

Azure NetApp Files

Versión de la API:

2024-07-01

Crear o actualizar un volumen
Crear o actualizar el volumen especificado dentro del grupo de capacidad

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
accountName	path	True	string	Nombre de la cuenta de NetApp Patrón de Regex: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,127}$
poolName	path	True	string	Nombre del grupo de capacidad Patrón de Regex: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,63}$
resourceGroupName	path	True	string	Nombre del grupo de recursos. El nombre no distingue mayúsculas de minúsculas.
subscriptionId	path	True	string uuid	Identificador de la suscripción de destino. El valor debe ser un UUID.
volumeName	path	True	string	Nombre del volumen Patrón de Regex: ^[a-zA-Z][a-zA-Z0-9\-_]{0,63}$
api-version	query	True	string	Versión de la API que se va a usar para esta operación.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
location	True	string	Ubicación geográfica donde reside el recurso
properties.creationToken	True	string	Ruta de acceso de archivo o token de creación Ruta de acceso de archivo única para el volumen. Se usa al crear destinos de montaje
properties.subnetId	True	string	URI de recursos de Azure para una subred delegada. Debe tener la delegación Microsoft.NetApp/volumes
properties.usageThreshold	True	integer	usageThreshold Cuota de almacenamiento máxima permitida para un sistema de archivos en bytes. Se trata de una cuota temporal que se usa solo para las alertas. En el caso de los volúmenes normales, los valores válidos están en el intervalo 50GiB a 100TiB. Para volúmenes grandes, los valores válidos están en el intervalo 100TiB a 500TiB y, de forma excepcional, de a 2400GiB a 2400TiB. Valores expresados en bytes como múltiplos de 1 GiB.
properties.avsDataStore		avsDataStore	avsDataStore Especifica si el volumen está habilitado para el almacén de datos de Azure VMware Solution (AVS).
properties.backupId		string	Id. de copia de seguridad Identificador de recurso usado para identificar la copia de seguridad.
properties.capacityPoolResourceId		string	Identificador de recurso de grupo usado en el caso de crear un volumen a través del grupo de volúmenes
properties.coolAccess		boolean	Especifica si el acceso esporádico (por niveles) está habilitado para el volumen.
properties.coolAccessRetrievalPolicy		coolAccessRetrievalPolicy	coolAccessRetrievalPolicy determina el comportamiento de recuperación de datos del nivel de acceso esporádico al almacenamiento estándar en función del patrón de lectura para volúmenes habilitados para acceso esporádico. Los valores posibles para este campo son: Valor predeterminado: los datos se extraerán del nivel de acceso esporádico al almacenamiento estándar en lecturas aleatorias. Esta directiva es la predeterminada. OnRead: todas las lecturas de datos controladas por el cliente se extraen del nivel de acceso esporádico al almacenamiento estándar en lecturas secuenciales y aleatorias. Nunca: no se extrae ningún dato controlado por el cliente del nivel de acceso esporádico al almacenamiento estándar.
properties.coolnessPeriod		integer	Especifica el número de días después de los cuales se organizarán en capas los datos a los que los clientes no acceden.
properties.dataProtection		DataProtection	DataProtection Los volúmenes de tipo DataProtection incluyen un objeto que contiene detalles de la replicación.
properties.defaultGroupQuotaInKiBs		integer	Cuota de grupo predeterminada para el volumen en KiB. Si se establece isDefaultQuotaEnabled, se aplica el valor mínimo de 4 KiB.
properties.defaultUserQuotaInKiBs		integer	Cuota de usuario predeterminada para el volumen en KiB. Si se establece isDefaultQuotaEnabled, el valor mínimo de 4 KiB aplica .
properties.deleteBaseSnapshot		boolean	Si está habilitada (true), la instantánea desde la que se creó el volumen se eliminará automáticamente una vez finalizada la operación de creación del volumen. El valor predeterminado es false
properties.enableSubvolumes		enableSubvolumes	Marca que indica si las operaciones de subvolumen están habilitadas en el volumen
properties.encryptionKeySource		EncryptionKeySource	Origen de la clave usada para cifrar los datos en el volumen. Aplicable si la cuenta de NetApp tiene encryption.keySource = "Microsoft.KeyVault". Los valores posibles (que no distinguen mayúsculas de minúsculas) son: "Microsoft.NetApp, Microsoft.KeyVault"
properties.exportPolicy		ExportPolicy	exportPolicy Conjunto de reglas de directiva de exportación
properties.isDefaultQuotaEnabled		boolean	Especifica si la cuota predeterminada está habilitada para el volumen.
properties.isLargeVolume		boolean	Es un volumen grande Especifica si el volumen es un volumen grande o un volumen regular.
properties.isRestoring		boolean	Restaurar
properties.kerberosEnabled		boolean	Describir si un volumen es KerberosEnabled. Para usar con swagger versión 2020-05-01 o posterior
properties.keyVaultPrivateEndpointResourceId		string	Identificador de recurso del punto de conexión privado para KeyVault. Debe residir en la misma red virtual que el volumen. Solo es aplicable si encryptionKeySource = "Microsoft.KeyVault".
properties.ldapEnabled		boolean	Especifica si LDAP está habilitado o no para un volumen NFS determinado.
properties.networkFeatures		NetworkFeatures	Características de red Valor original del tipo de características de red disponible para el volumen en el momento en que se creó.
properties.placementRules		placementKeyValuePairs[]	Reglas de selección de ubicación de volumen Reglas de selección de ubicación específicas de la aplicación para el volumen determinado
properties.protocolTypes		string[]	protocolTypes Conjunto de tipos de protocolo, NFSv3 predeterminado, CIFS para el protocolo SMB
properties.proximityPlacementGroup		string	Grupo de selección de ubicación de proximidad asociado al volumen
properties.securityStyle		SecurityStyle	El estilo de seguridad del volumen, unix predeterminado, tiene como valor predeterminado ntfs para el protocolo dual o el protocolo CIFS.
properties.serviceLevel		ServiceLevel	serviceLevel Nivel de servicio del sistema de archivos
properties.smbAccessBasedEnumeration		smbAccessBasedEnumeration	smbAccessBasedEnumeration Habilita la propiedad de recurso compartido de enumeración basada en acceso para recursos compartidos de SMB. Solo se aplica al volumen SMB/DualProtocol
properties.smbContinuouslyAvailable		boolean	Habilita la propiedad de recurso compartido disponible continuamente para el volumen smb. Solo se aplica al volumen SMB
properties.smbEncryption		boolean	Habilita el cifrado para los datos smb3 en curso. Solo se aplica al volumen SMB/DualProtocol. Para usarse con swagger versión 2020-08-01 o posterior
properties.smbNonBrowsable		smbNonBrowsable	smbNonBrowsable Habilita la propiedad no explorable para recursos compartidos de SMB. Solo se aplica al volumen SMB/DualProtocol
properties.snapshotDirectoryVisible		boolean	Si está habilitado (true), el volumen contendrá un directorio de instantáneas de solo lectura que proporciona acceso a cada una de las instantáneas del volumen (el valor predeterminado es true).
properties.snapshotId		string	Id. de instantánea Identificador de recurso usado para identificar la instantánea.
properties.throughputMibps		number	Rendimiento máximo en MiB/s que puede lograr este volumen y se aceptará como entrada solo para el volumen qosType manual.
properties.unixPermissions		string	Permisos de UNIX para el volumen NFS aceptado en formato octal de 4 dígitos. El primer dígito selecciona los atributos set user ID(4), set group ID (2) y sticky (1). El segundo dígito selecciona el permiso para el propietario del archivo: lectura (4), escritura (2) y ejecución (1). En tercer lugar, selecciona permisos para otros usuarios del mismo grupo. el cuarto para otros usuarios que no están en el grupo. 0755: concede permisos de lectura, escritura y ejecución para propietario y lectura y ejecución para agrupar y otros usuarios.
properties.volumeSpecName		string	Nombre de especificación de volumen es la designación o identificador específicos de la aplicación para el volumen determinado de un grupo de volúmenes, por ejemplo, datos, registro
properties.volumeType		string	Qué tipo de volumen es este. Para los volúmenes de destino en Replicación entre regiones, establezca el tipo en DataProtection.
tags		object	Etiquetas de recursos.
zones		string[]	Zona de disponibilidad

Respuestas

Nombre	Tipo	Description
200 OK	volume	Aceptar: volumen actualizado
201 Created	volume	Volumen creado
202 Accepted		Aceptado- Crear solicitud aceptada; la operación se completará de forma asincrónica
Other Status Codes	ErrorResponse	Respuesta de error que describe por qué se produjo un error en la operación.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

Volumes_CreateOrUpdate

Solicitud de ejemplo

HTTP

PUT 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

{
  "location": "eastus",
  "properties": {
    "creationToken": "my-unique-file-path",
    "serviceLevel": "Premium",
    "subnetId": "/subscriptions/9760acf5-4638-11e7-9bdb-020073ca7778/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/testvnet3/subnets/testsubnet3",
    "usageThreshold": 107374182400
  }
}

Java

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

/**
 * Samples for Volumes CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/netapp/resource-manager/Microsoft.NetApp/stable/2024-07-01/examples/Volumes_CreateOrUpdate.json
     */
    /**
     * Sample code: Volumes_CreateOrUpdate.
     * 
     * @param manager Entry point to NetAppFilesManager.
     */
    public static void volumesCreateOrUpdate(com.azure.resourcemanager.netapp.NetAppFilesManager manager) {
        manager.volumes().define("volume1").withRegion("eastus").withExistingCapacityPool("myRG", "account1", "pool1")
            .withCreationToken("my-unique-file-path").withUsageThreshold(107374182400L)
            .withSubnetId(
                "/subscriptions/9760acf5-4638-11e7-9bdb-020073ca7778/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/testvnet3/subnets/testsubnet3")
            .withServiceLevel(ServiceLevel.PREMIUM).create();
    }
}

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

Python

from azure.identity import DefaultAzureCredential

from azure.mgmt.netapp import NetAppManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-netapp
# USAGE
    python volumes_create_or_update.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = NetAppManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
    )

    response = client.volumes.begin_create_or_update(
        resource_group_name="myRG",
        account_name="account1",
        pool_name="pool1",
        volume_name="volume1",
        body={
            "location": "eastus",
            "properties": {
                "creationToken": "my-unique-file-path",
                "serviceLevel": "Premium",
                "subnetId": "/subscriptions/9760acf5-4638-11e7-9bdb-020073ca7778/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/testvnet3/subnets/testsubnet3",
                "usageThreshold": 107374182400,
            },
        },
    ).result()
    print(response)


# x-ms-original-file: specification/netapp/resource-manager/Microsoft.NetApp/stable/2024-07-01/examples/Volumes_CreateOrUpdate.json
if __name__ == "__main__":
    main()

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

Go

package armnetapp_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"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_CreateOrUpdate.json
func ExampleVolumesClient_BeginCreateOrUpdate() {
	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().BeginCreateOrUpdate(ctx, "myRG", "account1", "pool1", "volume1", armnetapp.Volume{
		Location: to.Ptr("eastus"),
		Properties: &armnetapp.VolumeProperties{
			CreationToken:  to.Ptr("my-unique-file-path"),
			ServiceLevel:   to.Ptr(armnetapp.ServiceLevelPremium),
			SubnetID:       to.Ptr("/subscriptions/9760acf5-4638-11e7-9bdb-020073ca7778/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/testvnet3/subnets/testsubnet3"),
			UsageThreshold: to.Ptr[int64](107374182400),
		},
	}, 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/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1/volumes/volume1"),
	// 	Location: to.Ptr("eastus"),
	// 	Properties: &armnetapp.VolumeProperties{
	// 		CreationToken: to.Ptr("some-amazing-filepath"),
	// 		EncryptionKeySource: to.Ptr(armnetapp.EncryptionKeySourceMicrosoftNetApp),
	// 		FileSystemID: to.Ptr("9760acf5-4638-11e7-9bdb-020073ca7778"),
	// 		ProvisioningState: to.Ptr("Succeeded"),
	// 		ServiceLevel: to.Ptr(armnetapp.ServiceLevelPremium),
	// 		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

JavaScript

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

/**
 * This sample demonstrates how to Create or update the specified volume within the capacity pool
 *
 * @summary Create or update the specified volume within the capacity pool
 * x-ms-original-file: specification/netapp/resource-manager/Microsoft.NetApp/stable/2024-07-01/examples/Volumes_CreateOrUpdate.json
 */
async function volumesCreateOrUpdate() {
  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 = {
    creationToken: "my-unique-file-path",
    location: "eastus",
    serviceLevel: "Premium",
    subnetId:
      "/subscriptions/9760acf5-4638-11e7-9bdb-020073ca7778/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/testvnet3/subnets/testsubnet3",
    usageThreshold: 107374182400,
  };
  const credential = new DefaultAzureCredential();
  const client = new NetAppManagementClient(credential, subscriptionId);
  const result = await client.volumes.beginCreateOrUpdateAndWait(
    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

dotnet

using Azure;
using Azure.ResourceManager;
using System;
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_CreateOrUpdate.json
// this example is just showing the usage of "Volumes_CreateOrUpdate" 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 CapacityPoolResource created on azure
// for more information of creating CapacityPoolResource, please refer to the document of CapacityPoolResource
string subscriptionId = "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9";
string resourceGroupName = "myRG";
string accountName = "account1";
string poolName = "pool1";
ResourceIdentifier capacityPoolResourceId = CapacityPoolResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, accountName, poolName);
CapacityPoolResource capacityPool = client.GetCapacityPoolResource(capacityPoolResourceId);

// get the collection of this NetAppVolumeResource
NetAppVolumeCollection collection = capacityPool.GetNetAppVolumes();

// invoke the operation
string volumeName = "volume1";
NetAppVolumeData data = new NetAppVolumeData(new AzureLocation("eastus"), "my-unique-file-path", 107374182400L, new ResourceIdentifier("/subscriptions/9760acf5-4638-11e7-9bdb-020073ca7778/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/testvnet3/subnets/testsubnet3"))
{
    ServiceLevel = NetAppFileServiceLevel.Premium,
};
ArmOperation<NetAppVolumeResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, volumeName, data);
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

Respuesta de muestra

status code:

200

{
  "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1/volumes/volume1",
  "location": "eastus",
  "name": "account1/pool1/volume1",
  "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",
    "encryptionKeySource": "Microsoft.NetApp"
  },
  "type": "Microsoft.NetApp/netAppAccounts/capacityPools/volumes"
}

status code:

201

{
  "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1/volumes/volume1",
  "location": "eastus",
  "name": "account1/pool1/volume1",
  "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",
    "encryptionKeySource": "Microsoft.NetApp"
  },
  "type": "Microsoft.NetApp/netAppAccounts/capacityPools/volumes"
}

status code:

202

Definiciones

Nombre	Description
avsDataStore	avsDataStore
ChownMode	Este parámetro especifica quién está autorizado para cambiar la propiedad de un archivo. restringido: solo el usuario raíz puede cambiar la propiedad del archivo. sin restricciones: los usuarios no raíz pueden cambiar la propiedad de los archivos que poseen.
coolAccessRetrievalPolicy	coolAccessRetrievalPolicy determina el comportamiento de recuperación de datos del nivel de acceso esporádico al almacenamiento estándar en función del patrón de lectura para volúmenes habilitados para acceso esporádico. Los valores posibles para este campo son: Valor predeterminado: los datos se extraerán del nivel de acceso esporádico al almacenamiento estándar en lecturas aleatorias. Esta directiva es la predeterminada. OnRead: todas las lecturas de datos controladas por el cliente se extraen del nivel de acceso esporádico al almacenamiento estándar en lecturas secuenciales y aleatorias. Nunca: no se extrae ningún dato controlado por el cliente del nivel de acceso esporádico al almacenamiento estándar.
createdByType	Tipo de identidad que creó el recurso.
DataProtection	DataProtection
enableSubvolumes	Marca que indica si las operaciones de subvolumen están habilitadas en el volumen
EncryptionKeySource	Origen de la clave usada para cifrar los datos en el volumen. Aplicable si la cuenta de NetApp tiene encryption.keySource = "Microsoft.KeyVault". Los valores posibles (que no distinguen mayúsculas de minúsculas) son: "Microsoft.NetApp, Microsoft.KeyVault"
EndpointType	Indica si el volumen local es el origen o el destino de la replicación de volúmenes.
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta de error
ExportPolicy	exportPolicy
exportPolicyRule	Regla de directiva de exportación de volúmenes
fileAccessLogs	Marca que indica si los registros de acceso a archivos están habilitados para el volumen, en función de la configuración de diagnóstico activa presente en el volumen.
mountTargetProperties	Propiedades de destino de montaje
NetworkFeatures	Características de red
placementKeyValuePairs	Parámetros específicos de la aplicación para la colocación de volúmenes en el grupo de volúmenes
remotePath	Ruta de acceso completa a un volumen que se va a migrar a ANF. Necesario para volúmenes de migración
replicationObject	Propiedades de replicación
ReplicationSchedule	Horario
SecurityStyle	El estilo de seguridad del volumen, unix predeterminado, tiene como valor predeterminado ntfs para el protocolo dual o el protocolo CIFS.
ServiceLevel	serviceLevel
smbAccessBasedEnumeration	smbAccessBasedEnumeration
smbNonBrowsable	smbNonBrowsable
systemData	Metadatos relativos a la creación y última modificación del recurso.
volume	Recurso de volumen
volumeBackupProperties	Propiedades de copia de seguridad de volumen
volumeRelocationProperties	Propiedades de reubicación de volumen
volumeSnapshotProperties	Propiedades de instantáneas de volumen
VolumeStorageToNetworkProximity	Proximidad de almacenamiento a red

avsDataStore

avsDataStore

Nombre	Tipo	Description
Disabled	string	avsDataStore está deshabilitado
Enabled	string	avsDataStore está habilitado

ChownMode

Este parámetro especifica quién está autorizado para cambiar la propiedad de un archivo. restringido: solo el usuario raíz puede cambiar la propiedad del archivo. sin restricciones: los usuarios no raíz pueden cambiar la propiedad de los archivos que poseen.

Nombre	Tipo	Description
Restricted	string
Unrestricted	string

coolAccessRetrievalPolicy

coolAccessRetrievalPolicy determina el comportamiento de recuperación de datos del nivel de acceso esporádico al almacenamiento estándar en función del patrón de lectura para volúmenes habilitados para acceso esporádico. Los valores posibles para este campo son: Valor predeterminado: los datos se extraerán del nivel de acceso esporádico al almacenamiento estándar en lecturas aleatorias. Esta directiva es la predeterminada. OnRead: todas las lecturas de datos controladas por el cliente se extraen del nivel de acceso esporádico al almacenamiento estándar en lecturas secuenciales y aleatorias. Nunca: no se extrae ningún dato controlado por el cliente del nivel de acceso esporádico al almacenamiento estándar.

Nombre	Tipo	Description
Default	string
Never	string
OnRead	string

createdByType

Tipo de identidad que creó el recurso.

Nombre	Tipo	Description
Application	string
Key	string
ManagedIdentity	string
User	string

DataProtection

DataProtection

Nombre	Tipo	Description
backup	volumeBackupProperties	Copia de seguridad Propiedades de copia de seguridad
replication	replicationObject	Replicación Propiedades de replicación
snapshot	volumeSnapshotProperties	Instantánea Propiedades de instantánea.
volumeRelocation	volumeRelocationProperties	VolumeRelocation Propiedades VolumeRelocation

enableSubvolumes

Marca que indica si las operaciones de subvolumen están habilitadas en el volumen

Nombre	Tipo	Description
Disabled	string	Las subvolumes no están habilitadas
Enabled	string	Las subvolumes están habilitadas

EncryptionKeySource

Origen de la clave usada para cifrar los datos en el volumen. Aplicable si la cuenta de NetApp tiene encryption.keySource = "Microsoft.KeyVault". Los valores posibles (que no distinguen mayúsculas de minúsculas) son: "Microsoft.NetApp, Microsoft.KeyVault"

Nombre	Tipo	Description
Microsoft.KeyVault	string	Cifrado de claves administradas por el cliente
Microsoft.NetApp	string	Cifrado de claves administradas por Microsoft

EndpointType

Indica si el volumen local es el origen o el destino de la replicación de volúmenes.

Nombre	Tipo	Description
dst	string
src	string

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre	Tipo	Description
info	object	Información adicional.
type	string	Tipo de información adicional.

ErrorDetail

Detalle del error.

Nombre	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
details	ErrorDetail[]	Detalles del error.
message	string	Mensaje de error.
target	string	Destino del error.

ErrorResponse

Respuesta de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

ExportPolicy

exportPolicy

Nombre	Tipo	Description
rules	exportPolicyRule[]	Exportar regla de directiva Exportar regla de directiva

exportPolicyRule

Regla de directiva de exportación de volúmenes

Nombre	Tipo	Valor predeterminado	Description
allowedClients	string		Especificación de entrada de cliente como cadena separada por comas con CIDR IPv4, direcciones de host IPv4 y nombres de host
chownMode	ChownMode	Restricted	Este parámetro especifica quién está autorizado para cambiar la propiedad de un archivo. restringido: solo el usuario raíz puede cambiar la propiedad del archivo. sin restricciones: los usuarios no raíz pueden cambiar la propiedad de los archivos que poseen.
cifs	boolean		Permite el protocolo CIFS
hasRootAccess	boolean	True	Tiene acceso raíz al volumen
kerberos5ReadOnly	boolean	False	Acceso de solo lectura de Kerberos5. Para usar con swagger versión 2020-05-01 o posterior
kerberos5ReadWrite	boolean	False	Acceso de lectura y escritura de Kerberos5. Para usar con swagger versión 2020-05-01 o posterior
kerberos5iReadOnly	boolean	False	Acceso de solo lectura de Kerberos5i. Para usar con swagger versión 2020-05-01 o posterior
kerberos5iReadWrite	boolean	False	Acceso de lectura y escritura de Kerberos5i. Para usar con swagger versión 2020-05-01 o posterior
kerberos5pReadOnly	boolean	False	Acceso de solo lectura de Kerberos5p. Para usar con swagger versión 2020-05-01 o posterior
kerberos5pReadWrite	boolean	False	Acceso de lectura y escritura de Kerberos5p. Para usar con swagger versión 2020-05-01 o posterior
nfsv3	boolean		Permite el protocolo NFSv3. Habilitar solo para volúmenes de tipo NFSv3
nfsv41	boolean		Permite el protocolo NFSv4.1. Habilitar solo para volúmenes de tipo NFSv4.1
ruleIndex	integer		Índice de pedido
unixReadOnly	boolean		Acceso de solo lectura
unixReadWrite	boolean		Acceso de lectura y escritura

fileAccessLogs

Marca que indica si los registros de acceso a archivos están habilitados para el volumen, en función de la configuración de diagnóstico activa presente en el volumen.

Nombre	Tipo	Description
Disabled	string	fileAccessLogs no están habilitados
Enabled	string	fileAccessLogs están habilitados

mountTargetProperties

Propiedades de destino de montaje

Nombre	Tipo	Description
fileSystemId	string	fileSystemId UUID v4 usado para identificar MountTarget
ipAddress	string	ipAddress Dirección IPv4 del destino de montaje
mountTargetId	string	mountTargetId UUID v4 usado para identificar MountTarget
smbServerFqdn	string	smbServerFQDN Nombre de dominio completo del servidor SMB, FQDN

NetworkFeatures

Características de red

Nombre	Tipo	Description
Basic	string	Características básicas de red.
Basic_Standard	string	Actualización de las características de red Básica a Estándar.
Standard	string	Características de red estándar.
Standard_Basic	string	Actualización de las características de red estándar a básica.

placementKeyValuePairs

Parámetros específicos de la aplicación para la colocación de volúmenes en el grupo de volúmenes

Nombre	Tipo	Description
key	string	Clave para un parámetro específico de la aplicación para la colocación de volúmenes en el grupo de volúmenes
value	string	Valor de un parámetro específico de la aplicación para la colocación de volúmenes en el grupo de volúmenes

remotePath

Ruta de acceso completa a un volumen que se va a migrar a ANF. Necesario para volúmenes de migración

Nombre	Tipo	Description
externalHostName	string	Ruta de acceso a un host ONTAP
serverName	string	Nombre de un servidor en el host ONTAP
volumeName	string	Nombre de un volumen en el servidor

replicationObject

Propiedades de replicación

Nombre	Tipo	Description
endpointType	EndpointType	Indica si el volumen local es el origen o el destino de la replicación de volúmenes.
remotePath	remotePath	Ruta de acceso completa a un volumen que se va a migrar a ANF. Necesario para volúmenes de migración
remoteVolumeRegion	string	Región remota para el otro extremo de la replicación de volúmenes.
remoteVolumeResourceId	string	Identificador de recurso del volumen remoto. Necesario para la replicación entre regiones y zonas cruzadas
replicationId	string	Identificación
replicationSchedule	ReplicationSchedule	Horario

ReplicationSchedule

Horario

Nombre	Tipo	Description
_10minutely	string
daily	string
hourly	string

SecurityStyle

El estilo de seguridad del volumen, unix predeterminado, tiene como valor predeterminado ntfs para el protocolo dual o el protocolo CIFS.

Nombre	Tipo	Description
ntfs	string
unix	string

ServiceLevel

serviceLevel

Nombre	Tipo	Description
Premium	string	Nivel de servicio Premium
Standard	string	Nivel de servicio estándar
StandardZRS	string	Nivel de servicio de almacenamiento con redundancia de zona
Ultra	string	Nivel de servicio Ultra

smbAccessBasedEnumeration

smbAccessBasedEnumeration

Nombre	Tipo	Description
Disabled	string	La configuración del recurso compartido smbAccessBasedEnumeration está deshabilitada
Enabled	string	La configuración del recurso compartido smbAccessBasedEnumeration está habilitada

smbNonBrowsable

smbNonBrowsable

Nombre	Tipo	Description
Disabled	string	La configuración de recurso compartido smbNonBrowsable está deshabilitada
Enabled	string	La configuración de recurso compartido smbNonBrowsable está habilitada

systemData

Metadatos relativos a la creación y última modificación del recurso.

Nombre	Tipo	Description
createdAt	string	Marca de tiempo de creación de recursos (UTC).
createdBy	string	Identidad que creó el recurso.
createdByType	createdByType	Tipo de identidad que creó el recurso.
lastModifiedAt	string	Marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy	string	Identidad que modificó por última vez el recurso.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.

volume

Recurso de volumen

Nombre	Tipo	Valor predeterminado	Description
etag	string		Cadena de solo lectura única que cambia cada vez que se actualiza el recurso.
id	string		Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string		Ubicación geográfica donde reside el recurso
name	string		Nombre del recurso
properties.actualThroughputMibps	number		Rendimiento real en MiB/s para volúmenes qosType automáticos calculados en función del tamaño y serviceLevel
properties.avsDataStore	avsDataStore	Disabled	avsDataStore Especifica si el volumen está habilitado para el almacén de datos de Azure VMware Solution (AVS).
properties.backupId	string		Id. de copia de seguridad Identificador de recurso usado para identificar la copia de seguridad.
properties.baremetalTenantId	string		Id. de inquilino de Baremetal Identificador único de inquilino de Baremetal.
properties.capacityPoolResourceId	string		Identificador de recurso de grupo usado en el caso de crear un volumen a través del grupo de volúmenes
properties.cloneProgress	integer		Cuando se restaura un volumen desde la instantánea de otro volumen, se mostrará el porcentaje de finalización de este proceso de clonación. Cuando este valor está vacío o nulo, actualmente no hay ningún proceso de clonación que se produzca en este volumen. Este valor se actualizará cada 5 minutos durante la clonación.
properties.coolAccess	boolean	False	Especifica si el acceso esporádico (por niveles) está habilitado para el volumen.
properties.coolAccessRetrievalPolicy	coolAccessRetrievalPolicy		coolAccessRetrievalPolicy determina el comportamiento de recuperación de datos del nivel de acceso esporádico al almacenamiento estándar en función del patrón de lectura para volúmenes habilitados para acceso esporádico. Los valores posibles para este campo son: Valor predeterminado: los datos se extraerán del nivel de acceso esporádico al almacenamiento estándar en lecturas aleatorias. Esta directiva es la predeterminada. OnRead: todas las lecturas de datos controladas por el cliente se extraen del nivel de acceso esporádico al almacenamiento estándar en lecturas secuenciales y aleatorias. Nunca: no se extrae ningún dato controlado por el cliente del nivel de acceso esporádico al almacenamiento estándar.
properties.coolnessPeriod	integer		Especifica el número de días después de los cuales se organizarán en capas los datos a los que los clientes no acceden.
properties.creationToken	string		Ruta de acceso de archivo o token de creación Ruta de acceso de archivo única para el volumen. Se usa al crear destinos de montaje
properties.dataProtection	DataProtection		DataProtection Los volúmenes de tipo DataProtection incluyen un objeto que contiene detalles de la replicación.
properties.dataStoreResourceId	string[]		dataStoreResourceId Identificador único del recurso del almacén de datos
properties.defaultGroupQuotaInKiBs	integer	0	Cuota de grupo predeterminada para el volumen en KiB. Si se establece isDefaultQuotaEnabled, se aplica el valor mínimo de 4 KiB.
properties.defaultUserQuotaInKiBs	integer	0	Cuota de usuario predeterminada para el volumen en KiB. Si se establece isDefaultQuotaEnabled, el valor mínimo de 4 KiB aplica .
properties.deleteBaseSnapshot	boolean		Si está habilitada (true), la instantánea desde la que se creó el volumen se eliminará automáticamente una vez finalizada la operación de creación del volumen. El valor predeterminado es false
properties.effectiveNetworkFeatures	NetworkFeatures	Basic	Características de red El valor efectivo del tipo de características de red disponible para el volumen o el estado efectivo actual de la actualización.
properties.enableSubvolumes	enableSubvolumes	Disabled	Marca que indica si las operaciones de subvolumen están habilitadas en el volumen
properties.encrypted	boolean		Especifica si el volumen está cifrado o no. Solo está disponible en los volúmenes creados o actualizados después del 2022-01-01.
properties.encryptionKeySource	EncryptionKeySource	Microsoft.NetApp	Origen de la clave usada para cifrar los datos en el volumen. Aplicable si la cuenta de NetApp tiene encryption.keySource = "Microsoft.KeyVault". Los valores posibles (que no distinguen mayúsculas de minúsculas) son: "Microsoft.NetApp, Microsoft.KeyVault"
properties.exportPolicy	ExportPolicy		exportPolicy Conjunto de reglas de directiva de exportación
properties.fileAccessLogs	fileAccessLogs	Disabled	Marca que indica si los registros de acceso a archivos están habilitados para el volumen, en función de la configuración de diagnóstico activa presente en el volumen.
properties.fileSystemId	string		FileSystem ID Identificador único del sistema de archivos.
properties.isDefaultQuotaEnabled	boolean	False	Especifica si la cuota predeterminada está habilitada para el volumen.
properties.isLargeVolume	boolean	False	Es un volumen grande Especifica si el volumen es un volumen grande o un volumen regular.
properties.isRestoring	boolean		Restaurar
properties.kerberosEnabled	boolean	False	Describir si un volumen es KerberosEnabled. Para usar con swagger versión 2020-05-01 o posterior
properties.keyVaultPrivateEndpointResourceId	string		Identificador de recurso del punto de conexión privado para KeyVault. Debe residir en la misma red virtual que el volumen. Solo es aplicable si encryptionKeySource = "Microsoft.KeyVault".
properties.ldapEnabled	boolean	False	Especifica si LDAP está habilitado o no para un volumen NFS determinado.
properties.maximumNumberOfFiles	integer		Número máximo de archivos permitidos. Necesita una solicitud de servicio para cambiarla. Solo se permite cambiar si la cuota de volumen es superior a 4TiB.
properties.mountTargets	mountTargetProperties[]		mountTargets Lista de destinos de montaje
properties.networkFeatures	NetworkFeatures	Basic	Características de red Valor original del tipo de características de red disponible para el volumen en el momento en que se creó.
properties.networkSiblingSetId	string		Id. del conjunto del mismo nivel de red Identificador del conjunto del mismo nivel de red para el grupo de volúmenes que comparten recursos de red.
properties.originatingResourceId	string		Identificador de recurso de origen Identificador de la instantánea o copia de seguridad desde la que se restaura el volumen.
properties.placementRules	placementKeyValuePairs[]		Reglas de selección de ubicación de volumen Reglas de selección de ubicación específicas de la aplicación para el volumen determinado
properties.protocolTypes	string[]		protocolTypes Conjunto de tipos de protocolo, NFSv3 predeterminado, CIFS para el protocolo SMB
properties.provisionedAvailabilityZone	string		Zona de disponibilidad aprovisionada Zona de disponibilidad donde se aprovisiona el volumen. Esto hace referencia a la zona de disponibilidad lógica donde reside el volumen.
properties.provisioningState	string		Administración del ciclo de vida de Azure
properties.proximityPlacementGroup	string		Grupo de selección de ubicación de proximidad asociado al volumen
properties.securityStyle	SecurityStyle	unix	El estilo de seguridad del volumen, unix predeterminado, tiene como valor predeterminado ntfs para el protocolo dual o el protocolo CIFS.
properties.serviceLevel	ServiceLevel	Premium	serviceLevel Nivel de servicio del sistema de archivos
properties.smbAccessBasedEnumeration	smbAccessBasedEnumeration		smbAccessBasedEnumeration Habilita la propiedad de recurso compartido de enumeración basada en acceso para recursos compartidos de SMB. Solo se aplica al volumen SMB/DualProtocol
properties.smbContinuouslyAvailable	boolean	False	Habilita la propiedad de recurso compartido disponible continuamente para el volumen smb. Solo se aplica al volumen SMB
properties.smbEncryption	boolean	False	Habilita el cifrado para los datos smb3 en curso. Solo se aplica al volumen SMB/DualProtocol. Para usarse con swagger versión 2020-08-01 o posterior
properties.smbNonBrowsable	smbNonBrowsable		smbNonBrowsable Habilita la propiedad no explorable para recursos compartidos de SMB. Solo se aplica al volumen SMB/DualProtocol
properties.snapshotDirectoryVisible	boolean	True	Si está habilitado (true), el volumen contendrá un directorio de instantáneas de solo lectura que proporciona acceso a cada una de las instantáneas del volumen (el valor predeterminado es true).
properties.snapshotId	string		Id. de instantánea Identificador de recurso usado para identificar la instantánea.
properties.storageToNetworkProximity	VolumeStorageToNetworkProximity		Proximidad de almacenamiento a red Proporciona almacenamiento a la información de proximidad de red para el volumen.
properties.subnetId	string		URI de recursos de Azure para una subred delegada. Debe tener la delegación Microsoft.NetApp/volumes
properties.t2Network	string		Información de red T2
properties.throughputMibps	number		Rendimiento máximo en MiB/s que puede lograr este volumen y se aceptará como entrada solo para el volumen qosType manual.
properties.unixPermissions	string		Permisos de UNIX para el volumen NFS aceptado en formato octal de 4 dígitos. El primer dígito selecciona los atributos set user ID(4), set group ID (2) y sticky (1). El segundo dígito selecciona el permiso para el propietario del archivo: lectura (4), escritura (2) y ejecución (1). En tercer lugar, selecciona permisos para otros usuarios del mismo grupo. el cuarto para otros usuarios que no están en el grupo. 0755: concede permisos de lectura, escritura y ejecución para propietario y lectura y ejecución para agrupar y otros usuarios.
properties.usageThreshold	integer	0	usageThreshold Cuota de almacenamiento máxima permitida para un sistema de archivos en bytes. Se trata de una cuota temporal que se usa solo para las alertas. En el caso de los volúmenes normales, los valores válidos están en el intervalo 50GiB a 100TiB. Para volúmenes grandes, los valores válidos están en el intervalo 100TiB a 500TiB y, de forma excepcional, de a 2400GiB a 2400TiB. Valores expresados en bytes como múltiplos de 1 GiB.
properties.volumeGroupName	string		Nombre del grupo de volúmenes
properties.volumeSpecName	string		Nombre de especificación de volumen es la designación o identificador específicos de la aplicación para el volumen determinado de un grupo de volúmenes, por ejemplo, datos, registro
properties.volumeType	string		Qué tipo de volumen es este. Para los volúmenes de destino en Replicación entre regiones, establezca el tipo en DataProtection.
systemData	systemData		Metadatos de Azure Resource Manager que contienen información createdBy y modifiedBy.
tags	object		Etiquetas de recursos.
type	string		Tipo del recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"
zones	string[]		Zona de disponibilidad

volumeBackupProperties

Propiedades de copia de seguridad de volumen

Nombre	Tipo	Description
backupPolicyId	string	Identificador de recurso de directiva de copia de seguridad
backupVaultId	string	Identificador de recurso del almacén de Backup
policyEnforced	boolean	Directiva aplicada

volumeRelocationProperties

Propiedades de reubicación de volumen

Nombre	Tipo	Description
readyToBeFinalized	boolean	Ha finalizado la reubicación y está listo para ser limpiado
relocationRequested	boolean	Se ha solicitado reubicación para este volumen

volumeSnapshotProperties

Propiedades de instantáneas de volumen

Nombre	Tipo	Description
snapshotPolicyId	string	ResourceId de directiva de instantáneas

VolumeStorageToNetworkProximity

Proximidad de almacenamiento a red

Nombre	Tipo	Description
AcrossT2	string	Almacenamiento de AcrossT2 estándar en la conectividad de red.
Default	string	Almacenamiento básico para la conectividad de red.
T1	string	Almacenamiento T1 estándar en conectividad de red.
T2	string	Almacenamiento T2 estándar en conectividad de red.