Volumes - Get
Descrever um volume
Obter 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=2023-11-01
Parâmetros do URI
Name | Em | Necessário | Tipo | Description |
---|---|---|---|---|
account
|
path | True |
string |
O nome da conta NetApp Regex pattern: |
pool
|
path | True |
string |
O nome do conjunto de capacidade Regex pattern: |
resource
|
path | True |
string |
O nome do grupo de recursos. O nome não é sensível a maiúsculas e minúsculas. |
subscription
|
path | True |
string uuid |
O ID da subscrição de destino. O valor tem de ser um UUID. |
volume
|
path | True |
string |
O nome do volume Regex pattern: |
api-version
|
query | True |
string |
A versão da API a utilizar para esta operação. |
Respostas
Name | Tipo | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Resposta de erro que descreve a razão pela qual a operação falhou. |
Segurança
azure_auth
Fluxo OAuth2 do Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | representar 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=2023-11-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
Name | Description |
---|---|
avs |
avsDataStore |
Chown |
Este parâmetro especifica quem está autorizado a alterar a propriedade de um ficheiro. restrito – apenas o utilizador raiz pode alterar a propriedade do ficheiro. sem restrições – os utilizadores não raiz podem alterar a propriedade dos ficheiros que possuem. |
cool |
coolAccessRetrievalPolicy determina o comportamento de obtenção de dados da camada esporádica para o armazenamento padrão com base no padrão de leitura para volumes com acesso esporádico ativado. Os valores possíveis para este campo são: Predefinição – os dados serão extraídos da camada esporádica para o armazenamento padrão em leituras aleatórias. Esta política é a predefinição. OnRead – todos os dados orientados pelo cliente lidos são extraídos da camada esporádica para o armazenamento padrão em leituras sequenciais e aleatórias. Nunca – não são extraídos dados orientados pelo cliente do escalão esporádico para o armazenamento padrão. |
created |
O tipo de identidade que criou o recurso. |
Data |
DataProtection |
enable |
Sinalizador que indica se as operações de subvolume estão ativadas no volume |
Encryption |
Origem da chave utilizada para encriptar dados em volume. Aplicável se a conta NetApp tiver encryption.keySource = "Microsoft.KeyVault". Os valores possíveis (não sensíveis a maiúsculas e minúsculas) são: "Microsoft.NetApp, Microsoft.KeyVault" |
Endpoint |
Indica se o volume local é a origem ou o destino da Replicação de Volume |
Error |
Informações adicionais sobre o erro de gestão de recursos. |
Error |
O detalhe do erro. |
Error |
Resposta a erros |
Export |
exportPolicy |
export |
Regra de Política de Exportação de Volume |
file |
Sinalizador que indica se os registos de acesso a ficheiros estão ativados para o volume, com base nas definições de diagnóstico ativas presentes no volume. |
mount |
Montar propriedades de destino |
Network |
Funcionalidades de rede |
placement |
Parâmetros específicos da aplicação para a colocação de volumes no grupo de volumes |
replication |
Propriedades de replicação |
Replication |
Agenda |
Security |
O estilo de segurança do volume, unix predefinido, predefine ntfs para protocolo duplo ou protocolo CIFS |
Service |
serviceLevel |
smb |
smbAccessBasedEnumeration |
smb |
smbNonBrowsable |
system |
Metadados relativos à criação e última modificação do recurso. |
volume |
Recurso de volume |
volume |
Propriedades da Cópia de Segurança do Volume |
volume |
Propriedades de reposicionamento de volumes |
volume |
Propriedades do Instantâneo de Volume |
Volume |
Armazenamento em Proximidade de Rede |
avsDataStore
avsDataStore
Name | Tipo | 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 – apenas o utilizador raiz pode alterar a propriedade do ficheiro. sem restrições – os utilizadores não raiz podem alterar a propriedade dos ficheiros que possuem.
Name | Tipo | Description |
---|---|---|
Restricted |
string |
|
Unrestricted |
string |
coolAccessRetrievalPolicy
coolAccessRetrievalPolicy determina o comportamento de obtenção de dados da camada esporádica para o armazenamento padrão com base no padrão de leitura para volumes com acesso esporádico ativado. Os valores possíveis para este campo são: Predefinição – os dados serão extraídos da camada esporádica para o armazenamento padrão em leituras aleatórias. Esta política é a predefinição. OnRead – todos os dados orientados pelo cliente lidos são extraídos da camada esporádica para o armazenamento padrão em leituras sequenciais e aleatórias. Nunca – não são extraídos dados orientados pelo cliente do escalão esporádico para o armazenamento padrão.
Name | Tipo | Description |
---|---|---|
Default |
string |
|
Never |
string |
|
OnRead |
string |
createdByType
O tipo de identidade que criou o recurso.
Name | Tipo | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
DataProtection
DataProtection
Name | Tipo | Description |
---|---|---|
backup |
Backup |
|
replication |
Replicação |
|
snapshot |
Instantâneo |
|
volumeRelocation |
VolumeRelocation |
enableSubvolumes
Sinalizador que indica se as operações de subvolume estão ativadas no volume
Name | Tipo | Description |
---|---|---|
Disabled |
string |
os subvolumes não estão ativados |
Enabled |
string |
os subvolumes estão ativados |
EncryptionKeySource
Origem da chave utilizada para encriptar dados em volume. Aplicável se a conta NetApp tiver encryption.keySource = "Microsoft.KeyVault". Os valores possíveis (não sensíveis a maiúsculas e minúsculas) são: "Microsoft.NetApp, Microsoft.KeyVault"
Name | Tipo | Description |
---|---|---|
Microsoft.KeyVault |
string |
Encriptação de chaves gerida pelo cliente |
Microsoft.NetApp |
string |
Encriptação de chaves gerida pela Microsoft |
EndpointType
Indica se o volume local é a origem ou o destino da Replicação de Volume
Name | Tipo | Description |
---|---|---|
dst |
string |
|
src |
string |
ErrorAdditionalInfo
Informações adicionais sobre o erro de gestão de recursos.
Name | Tipo | Description |
---|---|---|
info |
object |
As informações adicionais. |
type |
string |
O tipo de informação adicional. |
ErrorDetail
O detalhe do erro.
Name | Tipo | Description |
---|---|---|
additionalInfo |
As informações adicionais do erro. |
|
code |
string |
O código de erro. |
details |
Os detalhes do erro. |
|
message |
string |
A mensagem de erro. |
target |
string |
O destino do erro. |
ErrorResponse
Resposta a erros
Name | Tipo | Description |
---|---|---|
error |
O objeto de erro. |
ExportPolicy
exportPolicy
Name | Tipo | Description |
---|---|---|
rules |
Exportar regra de política |
exportPolicyRule
Regra de Política de Exportação de Volume
Name | Tipo | Valor Predefinido | Description |
---|---|---|---|
allowedClients |
string |
Especificação de entrada do cliente como cadeia separada por vírgulas 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 – apenas o utilizador raiz pode alterar a propriedade do ficheiro. sem restrições – os utilizadores não raiz 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 Acesso só de leitura. Para ser utilizado com o swagger versão 2020-05-01 ou posterior |
kerberos5ReadWrite |
boolean |
False |
Acesso de leitura e escrita do Kerberos5. Para ser utilizado com o swagger versão 2020-05-01 ou posterior |
kerberos5iReadOnly |
boolean |
False |
Kerberos5i Acesso só de leitura. Para ser utilizado com o swagger versão 2020-05-01 ou posterior |
kerberos5iReadWrite |
boolean |
False |
Acesso de leitura e escrita kerberos5i. Para ser utilizado com o swagger versão 2020-05-01 ou posterior |
kerberos5pReadOnly |
boolean |
False |
Acesso só de leitura kerberos5p. Para ser utilizado com o swagger versão 2020-05-01 ou posterior |
kerberos5pReadWrite |
boolean |
False |
Acesso de leitura e escrita kerberos5p. Para ser utilizado com o swagger versão 2020-05-01 ou posterior |
nfsv3 |
boolean |
Permite o protocolo NFSv3. Ativar apenas para volumes de tipo NFSv3 |
|
nfsv41 |
boolean |
Permite o protocolo NFSv4.1. Ativar apenas para volumes de tipo NFSv4.1 |
|
ruleIndex |
integer |
Índice de encomendas |
|
unixReadOnly |
boolean |
Acesso só de leitura |
|
unixReadWrite |
boolean |
Acesso de leitura e escrita |
fileAccessLogs
Sinalizador que indica se os registos de acesso a ficheiros estão ativados para o volume, com base nas definições de diagnóstico ativas presentes no volume.
Name | Tipo | Description |
---|---|---|
Disabled |
string |
fileAccessLogs não estão ativados |
Enabled |
string |
fileAccessLogs estão ativados |
mountTargetProperties
Montar propriedades de destino
Name | Tipo | Description |
---|---|---|
fileSystemId |
string |
fileSystemId |
ipAddress |
string |
ipAddress |
mountTargetId |
string |
mountTargetId |
smbServerFqdn |
string |
smbServerFQDN |
NetworkFeatures
Funcionalidades de rede
Name | Tipo | Description |
---|---|---|
Basic |
string |
Funcionalidades de rede básicas. |
Basic_Standard |
string |
A atualizar das funcionalidades de rede Básica para Standard. |
Standard |
string |
Funcionalidades de rede padrão. |
Standard_Basic |
string |
A atualizar das funcionalidades de rede Padrão para Básico. |
placementKeyValuePairs
Parâmetros específicos da aplicação para a colocação de volumes no grupo de volumes
Name | Tipo | Description |
---|---|---|
key |
string |
Chave para um parâmetro específico da aplicação para a colocação de volumes no grupo de volumes |
value |
string |
Valor para um parâmetro específico da aplicação para a colocação de volumes no grupo de volumes |
replicationObject
Propriedades de replicação
Name | Tipo | Description |
---|---|---|
endpointType |
Indica se o volume local é a origem ou o destino da Replicação de Volume |
|
remoteVolumeRegion |
string |
A região remota para a outra extremidade da Replicação de Volume. |
remoteVolumeResourceId |
string |
O ID do recurso do volume remoto. |
replicationId |
string |
Id |
replicationSchedule |
Agenda |
ReplicationSchedule
Agenda
Name | Tipo | Description |
---|---|---|
_10minutely |
string |
|
daily |
string |
|
hourly |
string |
SecurityStyle
O estilo de segurança do volume, unix predefinido, predefine ntfs para protocolo duplo ou protocolo CIFS
Name | Tipo | Description |
---|---|---|
ntfs |
string |
|
unix |
string |
ServiceLevel
serviceLevel
Name | Tipo | 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 com redundância entre zonas |
Ultra |
string |
Nível de serviço ultra |
smbAccessBasedEnumeration
smbAccessBasedEnumeration
Name | Tipo | Description |
---|---|---|
Disabled |
string |
smbAccessBasedEnumeration share setting is disabled |
Enabled |
string |
smbAccessBasedEnumeration share setting is enabled |
smbNonBrowsable
smbNonBrowsable
Name | Tipo | Description |
---|---|---|
Disabled |
string |
a definição de partilha smbNonBrowsable está desativada |
Enabled |
string |
a definição de partilha smbNonBrowsable está ativada |
systemData
Metadados relativos à criação e última modificação do recurso.
Name | Tipo | Description |
---|---|---|
createdAt |
string |
O carimbo de data/hora da criação de recursos (UTC). |
createdBy |
string |
A identidade que criou o recurso. |
createdByType |
O tipo de identidade que criou o recurso. |
|
lastModifiedAt |
string |
O carimbo de data/hora da última modificação do recurso (UTC) |
lastModifiedBy |
string |
A identidade que modificou o recurso pela última vez. |
lastModifiedByType |
O tipo de identidade que modificou o recurso pela última vez. |
volume
Recurso de volume
Name | Tipo | Valor Predefinido | Description |
---|---|---|---|
etag |
string |
Uma cadeia só de leitura exclusiva que é alterada sempre que o recurso é atualizado. |
|
id |
string |
ID de recurso completamente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
|
location |
string |
A localização geográfica onde o recurso se encontra |
|
name |
string |
O nome do recurso |
|
properties.actualThroughputMibps |
number |
Débito real em MiB/s para volumes qosType automáticos calculados com base no tamanho e serviceLevel |
|
properties.avsDataStore | Disabled |
avsDataStore |
|
properties.backupId |
string |
ID da cópia de segurança |
|
properties.baremetalTenantId |
string |
ID de Inquilino Baremetal |
|
properties.capacityPoolResourceId |
string |
ID do Recurso de Conjunto utilizado no caso de criar um volume através do grupo de volumes |
|
properties.cloneProgress |
integer |
Quando um volume está a ser restaurado a partir do instantâneo de outro volume, será apresentada a percentagem de conclusão deste processo de clonagem. Quando este valor está vazio/nulo, não existe atualmente nenhum processo de clonagem neste volume. Este valor será atualizado a cada 5 minutos durante a clonagem. |
|
properties.coolAccess |
boolean |
False |
Especifica se o Acesso Esporádico (arrumo) está ativado para o volume. |
properties.coolAccessRetrievalPolicy |
coolAccessRetrievalPolicy determina o comportamento de obtenção de dados da camada esporádica para o armazenamento padrão com base no padrão de leitura para volumes com acesso esporádico ativado. Os valores possíveis para este campo são: Predefinição – os dados serão extraídos da camada esporádica para o armazenamento padrão em leituras aleatórias. Esta política é a predefinição. OnRead - Todos os dados orientados pelo cliente lidos são extraídos da camada esporádica para o armazenamento padrão em leituras sequenciais e aleatórias. Nunca – não são extraídos dados orientados pelo cliente da camada esporádica para o armazenamento standard. |
||
properties.coolnessPeriod |
integer |
Especifica o número de dias após o qual os dados que não são acedidos pelos clientes serão em camadas. |
|
properties.creationToken |
string |
Caminho de Ficheiro ou Token de Criação |
|
properties.dataProtection |
Proteção de Dados |
||
properties.dataStoreResourceId |
string[] |
dataStoreResourceId |
|
properties.defaultGroupQuotaInKiBs |
integer |
0 |
Quota de grupo predefinida para o volume em KiBs. Se isDefaultQuotaEnabled estiver definido, aplica-se o valor mínimo de 4 KiBs. |
properties.defaultUserQuotaInKiBs |
integer |
0 |
Quota de utilizador predefinida para o volume em KiBs. Se isDefaultQuotaEnabled estiver definido, o valor mínimo de 4 KiBs aplica-se. |
properties.deleteBaseSnapshot |
boolean |
Se estiver ativado (verdadeiro), o instantâneo a partir do que o volume foi criado será eliminado automaticamente após a conclusão da operação de criação do volume. Predefinições para falso |
|
properties.enableSubvolumes | Disabled |
Sinalizador que indica se as operações de subvolume estão ativadas no volume |
|
properties.encrypted |
boolean |
Especifica se o volume está encriptado ou não. Disponível apenas em volumes criados ou atualizados após 2022-01-01. |
|
properties.encryptionKeySource | Microsoft.NetApp |
Origem da chave utilizada para encriptar dados em volume. Aplicável se a conta NetApp tiver encryption.keySource = "Microsoft.KeyVault". Os valores possíveis (não sensíveis a maiúsculas e minúsculas) são: "Microsoft.NetApp, Microsoft.KeyVault" |
|
properties.exportPolicy |
exportPolicy |
||
properties.fileAccessLogs | Disabled |
Sinalizador que indica se os registos de acesso a ficheiros estão ativados para o volume, com base nas definições de diagnóstico ativas presentes no volume. |
|
properties.fileSystemId |
string |
ID do Sistema de Ficheiros |
|
properties.isDefaultQuotaEnabled |
boolean |
False |
Especifica se a quota predefinida está ativada para o volume. |
properties.isLargeVolume |
boolean |
False |
É Volume Grande |
properties.isRestoring |
boolean |
A restaurar |
|
properties.kerberosEnabled |
boolean |
False |
Descreva se um volume é KerberosEnabled. Para utilizar com o swagger versão 2020-05-01 ou posterior |
properties.keyVaultPrivateEndpointResourceId |
string |
O ID de recurso do ponto final privado do KeyVault. Tem de residir na mesma VNET que o volume. Aplicável apenas se encryptionKeySource = "Microsoft.KeyVault". |
|
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 permitido. 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 |
||
properties.networkFeatures | Basic |
Funcionalidades de rede |
|
properties.networkSiblingSetId |
string |
ID do Conjunto de Irmãos de Rede |
|
properties.originatingResourceId |
string |
ID de Recurso de Origem |
|
properties.placementRules |
Regras de colocação de volumes |
||
properties.protocolTypes |
string[] |
protocolTypes |
|
properties.provisionedAvailabilityZone |
string |
Zona de Disponibilidade Aprovisionada |
|
properties.provisioningState |
string |
Gestão do ciclo de vida do Azure |
|
properties.proximityPlacementGroup |
string |
Grupo de colocação por proximidade associado ao volume |
|
properties.securityStyle | unix |
O estilo de segurança do volume, unix predefinido, é predefinido para ntfs para protocolo duplo ou protocolo CIFS |
|
properties.serviceLevel | Premium |
serviceLevel |
|
properties.smbAccessBasedEnumeration |
smbAccessBasedEnumeration |
||
properties.smbContinuouslyAvailable |
boolean |
False |
Ativa a propriedade de partilha continuamente disponível para o volume smb. Aplicável apenas ao volume SMB |
properties.smbEncryption |
boolean |
False |
Ativa a encriptação para dados smb3 em fluxo. Aplicável apenas ao volume SMB/DualProtocol. Para ser utilizado com o swagger versão 2020-08-01 ou posterior |
properties.smbNonBrowsable |
smbNonBrowsable |
||
properties.snapshotDirectoryVisible |
boolean |
True |
Se estiver ativado (verdadeiro), o volume irá conter um diretório de instantâneo só de leitura que fornece acesso a cada um dos instantâneos do volume (predefinição, verdadeiro). |
properties.snapshotId |
string |
ID do Instantâneo |
|
properties.storageToNetworkProximity |
Armazenamento por Proximidade de Rede |
||
properties.subnetId |
string |
O URI do Recurso do Azure para uma sub-rede delegada. Tem de ter a delegação Microsoft.NetApp/volumes |
|
properties.t2Network |
string |
Informações de rede T2 |
|
properties.throughputMibps |
number |
Débito máximo em MiB/s que pode ser alcançado por este volume e que será aceite como entrada apenas para o volume qosType manual |
|
properties.unixPermissions |
string |
Permissões UNIX para o volume NFS aceites no formato octal de 4 dígitos. O primeiro dígito seleciona o ID de utilizador definido(4), definir os atributos ID de grupo (2) e sticky (1). O segundo dígito seleciona a permissão para o proprietário do ficheiro: ler (4), escrever (2) e executar (1). Terceiro seleciona permissões para outros utilizadores no 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 lê/executa para agrupar e outros utilizadores. |
|
properties.usageThreshold |
integer |
0 |
usageThreshold |
properties.volumeGroupName |
string |
Nome do Grupo de Volumes |
|
properties.volumeSpecName |
string |
O nome das especificações de volume é a designação ou identificador específico da aplicação para o volume específico num grupo de volumes, por exemplo, dados, registo |
|
properties.volumeType |
string |
Que tipo de volume é este. Para volumes de destino na Replicação Entre Regiões, defina o tipo como DataProtection |
|
systemData |
O Azure Resource Manager metadados que contêm informações createdBy e modifiedBy. |
||
tags |
object |
Etiquetas de recursos. |
|
type |
string |
O tipo de recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts" |
|
zones |
string[] |
Zona de Disponibilidade |
volumeBackupProperties
Propriedades da Cópia de Segurança do Volume
Name | Tipo | Description |
---|---|---|
backupPolicyId |
string |
ID do Recurso da Política de Cópia de Segurança |
backupVaultId |
string |
ID de Recurso do Cofre de Cópia de Segurança |
policyEnforced |
boolean |
Política Imposta |
volumeRelocationProperties
Propriedades de reposicionamento de volumes
Name | Tipo | Description |
---|---|---|
readyToBeFinalized |
boolean |
A relocalização foi concluída e está pronta para ser limpa |
relocationRequested |
boolean |
Foi pedida a relocalização para este volume |
volumeSnapshotProperties
Propriedades do Instantâneo de Volume
Name | Tipo | Description |
---|---|---|
snapshotPolicyId |
string |
ResourceId da Política de Instantâneo |
VolumeStorageToNetworkProximity
Armazenamento em Proximidade de Rede
Name | Tipo | Description |
---|---|---|
AcrossT2 |
string |
Armazenamento Standard AcrossT2 para conectividade de rede. |
Default |
string |
Armazenamento básico para conectividade de rede. |
T1 |
string |
Armazenamento T1 Standard para conectividade de rede. |
T2 |
string |
Armazenamento T2 Standard para conectividade de rede. |