Volumes - Get

Descreva um volume
Obtenha os detalhes do volume especificado

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

Parâmetros do URI

Name In Required Type Description
accountName
path True
  • string

O nome da conta NetApp

poolName
path True
  • string

O nome da piscina de capacidade

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

resourceGroupName
path True
  • string

O nome do grupo de recursos.

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

subscriptionId
path True
  • string

Credenciais de subscrição que identificam exclusivamente a subscrição do Microsoft Azure. O ID de subscrição faz parte do URI para cada chamada de serviço.

volumeName
path True
  • string

O nome do volume

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

api-version
query True
  • string

A versão API a ser utilizada para esta operação.

Respostas

Name Type Description
200 OK

OK

Other Status Codes

Resposta de erro descrevendo por que a operação falhou.

Segurança

azure_auth

Azure Ative Directory OAuth2 Flow

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

Scopes

Name Description
user_impersonation personificar a sua conta de utilizador

Exemplos

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

Definições

avsDataStore

avsDataStore

ChownMode

Este parâmetro especifica quem está autorizado a alterar a propriedade de um ficheiro. restrito - Só o utilizador de raiz pode alterar a propriedade do ficheiro. sem restrições - Os utilizadores não-enraizados podem alterar a propriedade dos ficheiros que possuem.

DataProtection

Proteção de Dados

enableSubvolumes

Bandeira indicando se as operações de subvolume estão ativadas no volume

EndpointType

Indica se o volume local é a fonte ou destino para a Replicação do Volume

ExportPolicy

exportaçãoPolícia

exportPolicyRule

Regra da Política de Exportação de Volume

mountTargetProperties

Monte propriedades-alvo

NetworkFeatures

Funcionalidades de rede

placementKeyValuePairs

Parâmetros específicos da aplicação para a colocação de volumes no grupo de volume

replicationObject

Propriedades de replicação

ReplicationSchedule

Agenda

SecurityStyle

O estilo de segurança do volume, unix padrão, predefinidos para ntfs para protocolo duplo ou protocolo CIFS

ServiceLevel

serviçoLevel

volume

Recurso de volume

volumeBackupProperties

Propriedades de backup de volume

volumeSnapshotProperties

Propriedades snapshot de volume

VolumeStorageToNetworkProximity

Armazenamento para proximidade de rede

avsDataStore

avsDataStore

Name Type Description
Disabled
  • string

avsDataStore está desativado

Enabled
  • string

avsDataStore está ativado

ChownMode

Este parâmetro especifica quem está autorizado a alterar a propriedade de um ficheiro. restrito - Só o utilizador de raiz pode alterar a propriedade do ficheiro. sem restrições - Os utilizadores não-enraizados podem alterar a propriedade dos ficheiros que possuem.

Name Type Description
Restricted
  • string
Unrestricted
  • string

DataProtection

Proteção de Dados

Name Type Description
backup

Backup
Propriedades de backup

replication

Replicação
Propriedades de replicação

snapshot

Instantâneo
Propriedades instantâneas.

enableSubvolumes

Bandeira indicando se as operações de subvolume estão ativadas no volume

Name Type Description
Disabled
  • string

subvolumes não estão habilitados

Enabled
  • string

subvolumes estão ativados

EndpointType

Indica se o volume local é a fonte ou destino para a Replicação do Volume

Name Type Description
dst
  • string
src
  • string

ExportPolicy

exportaçãoPolícia

Name Type Description
rules

Regra da política de exportação
Regra da política de exportação

exportPolicyRule

Regra da Política de Exportação de Volume

Name Type Default Value Description
allowedClients
  • string

Especificação de entrada de cliente como vírgula separada cadeia com CIDRs IPv4, endereços de anfitrião IPv4 e nomes de anfitrião

chownMode Restricted

Este parâmetro especifica quem está autorizado a alterar a propriedade de um ficheiro. restrito - Só o utilizador de raiz pode alterar a propriedade do ficheiro. sem restrições - Os utilizadores não-enraizados podem alterar a propriedade dos ficheiros que possuem.

cifs
  • boolean

Permite o protocolo CIFS

hasRootAccess
  • boolean
True

Tem acesso à raiz ao volume

kerberos5ReadOnly
  • boolean
False

Kerberos5 Leia apenas o acesso. Para ser usado com versão swagger 2020-05-01 ou mais tarde

kerberos5ReadWrite
  • boolean
False

Kerberos5 Leia e escreva acesso. Para ser usado com versão swagger 2020-05-01 ou mais tarde

kerberos5iReadOnly
  • boolean
False

Kerberos5i Leia apenas o acesso. Para ser usado com versão swagger 2020-05-01 ou mais tarde

kerberos5iReadWrite
  • boolean
False

Kerberos5i Leia e escreva acesso. Para ser usado com versão swagger 2020-05-01 ou mais tarde

kerberos5pReadOnly
  • boolean
False

Kerberos5p Leia apenas o acesso. Para ser usado com versão swagger 2020-05-01 ou mais tarde

kerberos5pReadWrite
  • boolean
False

Kerberos5p Leia e escreva acesso. Para ser usado com versão swagger 2020-05-01 ou mais tarde

nfsv3
  • boolean

Permite o protocolo NFSv3. Ativar apenas para volumes do tipo NFSv3

nfsv41
  • boolean

Permite o protocolo NFSv4.1. Ativar apenas para volumes do tipo NFSv4.1

ruleIndex
  • integer

Índice de encomendas

unixReadOnly
  • boolean

Acesso só de leitura

unixReadWrite
  • boolean

Ler e escrever acesso

mountTargetProperties

Monte propriedades-alvo

Name Type Description
fileSystemId
  • string

fileSystemId
UUID v4 usado para identificar o MountTarget

ipAddress
  • string

ipAddress
O endereço IPv4 do alvo de montagem

mountTargetId
  • string

mountTargetId
UUID v4 usado para identificar o MountTarget

smbServerFqdn
  • string

smbServerFQDN
O nome de domínio totalmente qualificado do servidor SMB, FQDN

NetworkFeatures

Funcionalidades de rede

Name Type Description
Basic
  • string

Funcionalidade básica de rede.

Standard
  • string

Recurso de rede padrão.

placementKeyValuePairs

Parâmetros específicos da aplicação para a colocação de volumes no grupo de volume

Name Type Description
key
  • string

Chave para um parâmetro específico de aplicação para a colocação de volumes no grupo de volume

value
  • string

Valor para um parâmetro específico de aplicação para a colocação de volumes no grupo de volume

replicationObject

Propriedades de replicação

Name Type Description
endpointType

Indica se o volume local é a fonte ou destino para a Replicação do Volume

remoteVolumeRegion
  • string

A região remota para a outra extremidade da replicação do volume.

remoteVolumeResourceId
  • string

A identificação de recursos do volume remoto.

replicationId
  • string

Id

replicationSchedule

Agenda

ReplicationSchedule

Agenda

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

SecurityStyle

O estilo de segurança do volume, unix padrão, predefinidos para ntfs para protocolo duplo ou protocolo CIFS

Name Type Description
ntfs
  • string
unix
  • string

ServiceLevel

serviçoLevel

Name Type Description
Premium
  • string

Nível de serviço premium

Standard
  • string

Nível de serviço padrão

StandardZRS
  • string

Nível de serviço de armazenamento redundante zona

Ultra
  • string

Nível de serviço ultra

volume

Recurso de volume

Name Type Default Value Description
etag
  • string

Uma cadeia única de leitura que muda sempre que o recurso é atualizado.

id
  • string

ID de recursos totalmente qualificado para o recurso. Ex - /subscrições/{subscriçãoD}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location
  • string

A geolocalização onde o recurso vive

name
  • string

O nome do recurso

properties.avsDataStore Disabled

avsDataStore
Especifica se o volume está ativado para Azure VMware Solution (AVS) datastore

properties.backupId
  • string

ID da cópia de segurança
UUID v4 ou identificador de recursos usado para identificar o backup.

properties.baremetalTenantId
  • string

ID do inquilino baremetal
Identificador único do inquilino Baremetal.

properties.capacityPoolResourceId
  • string

Pool Resource Id usado em caso de criação de um volume através do grupo de volume

properties.cloneProgress
  • integer

Quando um volume estiver a ser restaurado a partir do instantâneo de outro volume, mostrará a conclusão percentual deste processo de clonagem. Quando este valor é vazio/nulo não existe atualmente nenhum processo de clonagem neste volume. Este valor atualizará a cada 5 minutos durante a clonagem.

properties.coolAccess
  • boolean
False

Especifica se o Acesso Cool (tiering) está ativado para o volume.

properties.coolnessPeriod
  • integer

Especifica o número de dias após os quais os dados que não são acedidos pelos clientes serão hierárquicos.

properties.creationToken
  • string

Criação Token ou Caminho de Arquivo
Um caminho de arquivo único para o volume. Usado na criação de alvos de montagem

properties.dataProtection

Proteção de Dados
Os volumes do tipo dataProtection incluem um objeto que contém detalhes da replicação

properties.defaultGroupQuotaInKiBs
  • integer
0

Quota de grupo padrão para volume em KiBs. Se for definido o IsEfaultQuotaEnabled, aplica-se o valor mínimo de 4 KiBs.

properties.defaultUserQuotaInKiBs
  • integer
0

Quota de utilizador padrão para volume em KiBs. Se for definido o IsEfaultQuotaEnabled, aplica-se o valor mínimo de 4 KiBs .

properties.enableSubvolumes Disabled

Bandeira indicando se as operações de subvolume estão ativadas no volume

properties.encryptionKeySource
  • string

Fonte chave de encriptação. Os valores possíveis são: 'Microsoft.NetApp'

properties.exportPolicy

exportaçãoPolícia
Conjunto de regras de política de exportação

properties.fileSystemId
  • string

FileSystem ID
Identificador exclusivo do Sistema de Ficheiros.

properties.isDefaultQuotaEnabled
  • boolean
False

Especifica se o contingente predefinido está ativado para o volume.

properties.isRestoring
  • boolean

Restaurar

properties.kerberosEnabled
  • boolean
False

Descreva se um volume é KerberosEnabled. Para ser usado com versão swagger 2020-05-01 ou mais tarde

properties.ldapEnabled
  • boolean
False

Especifica se o LDAP está ativado ou não para um determinado volume NFS.

properties.maximumNumberOfFiles
  • integer

Número máximo de ficheiros permitidos. Precisa de um pedido de serviço para ser alterado. Só é permitido alterar se a quota de volume for superior a 4TiB.

properties.mountTargets

mountTargets
Lista de alvos de montagem

properties.networkFeatures Basic

Funcionalidades de rede
Rede básica ou funcionalidades Standard disponíveis para o volume.

properties.networkSiblingSetId
  • string

ID de conjunto de irmãos de rede
Conjunto de conjunto de irmãos de rede para o grupo de volumes que partilham recursos de networking.

properties.placementRules

Regras de colocação de volume
Regras específicas de colocação de aplicação para o volume específico

properties.protocolTypes
  • string[]

protocoloTipos
Conjunto de tipos de protocolo, NFSv3 predefinido, CIFS para protocolo SMB

properties.provisioningState
  • string

Gestão do ciclo de vida Azure

properties.proximityPlacementGroup
  • string

Grupo de colocação de proximidade associado ao volume

properties.securityStyle unix

O estilo de segurança do volume, unix padrão, predefinidos para ntfs para protocolo duplo ou protocolo CIFS

properties.serviceLevel Premium

serviçoLevel
O nível de serviço do sistema de ficheiros

properties.smbContinuouslyAvailable
  • boolean
False

Permite uma propriedade partilhada continuamente disponível para volume smb. Apenas aplicável ao volume SMB

properties.smbEncryption
  • boolean
False

Permite encriptação para dados smb3 de bordo. Apenas aplicável ao volume SMB/DualProtocol. Para ser usado com versão swagger 2020-08-01 ou mais tarde

properties.snapshotDirectoryVisible
  • boolean
True

Se ativado (verdadeiro) o volume conterá um diretório instantâneo apenas de leitura que permite aceder a cada uma das imagens do volume (padrão a verdade).

properties.snapshotId
  • string

ID instantâneo
UUID v4 ou identificador de recursos usado para identificar o Snapshot.

properties.storageToNetworkProximity

Armazenamento para proximidade de rede
Fornece armazenamento para informação de proximidade de rede para o volume.

properties.subnetId
  • string

O Azure Resource URI para uma sub-rede delegada. Deve ter a delegação Microsoft.NetApp/volumes

properties.t2Network
  • string

Informação da rede T2

properties.throughputMibps
  • number

Produção máxima em Mibps que pode ser alcançada por este volume e que será aceite como entrada apenas para o volume de qosType manual

properties.unixPermissions
  • string
0770

Permissões UNIX para volume NFS aceites em formato octal de 4 dígitos. O primeiro dígito seleciona o ID do utilizador definido(4), o ID do grupo de conjunto (2) e os atributos pegajosos (1). Segundo dígito seleciona permissão para o proprietário do ficheiro: ler (4), escrever (2) e executar (1). Em terceiro lugar seleciona permissões para outros utilizadores do mesmo grupo. o quarto para outros utilizadores que não estão no grupo. 0755 - dá permissões de leitura/escrita/execução ao proprietário e leia/execute para grupo e outros utilizadores.

properties.usageThreshold
  • integer
0

useThreshold
Quota máxima de armazenamento permitida para um sistema de ficheiros em bytes. Esta é uma quota suave usada apenas para alertar. O tamanho mínimo é de 100 GiB. O limite superior é de 100TiB. Especificado em bytes.

properties.volumeGroupName
  • string

Nome do grupo de volume

properties.volumeSpecName
  • string

O nome da especificação de volume é a designação específica da aplicação ou identificador para o volume específico de um grupo de volume para, por exemplo, dados, log

properties.volumeType
  • string

Que tipo de volume é este. Para volumes de destino na replicação da região transversal, desafie o tipo de DataProtection

tags
  • object

Etiquetas de recursos.

type
  • string

O tipo de recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

volumeBackupProperties

Propriedades de backup de volume

Name Type Description
backupEnabled
  • boolean

Backup Habilitado

backupPolicyId
  • string

ID de recursos de segurança

policyEnforced
  • boolean

Política aplicada

vaultId
  • string

ID de recursos de abóbada

volumeSnapshotProperties

Propriedades snapshot de volume

Name Type Description
snapshotPolicyId
  • string

Snapshot Policy ResourceId

VolumeStorageToNetworkProximity

Armazenamento para proximidade de rede

Name Type Description
Default
  • string

Armazenamento básico para conectividade de rede.

T1
  • string

Armazenamento padrão T1 para conectividade de rede.

T2
  • string

Armazenamento padrão T2 para conectividade de rede.