Snapshot Policies - List Volumes
Obter volumes para a política de snapshot
Obter volumes associados à política de snapshot
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/snapshotPolicies/{snapshotPolicyName}/volumes?api-version=2024-07-01
Parâmetros do URI
Name | Em | Necessário | Tipo | Description |
---|---|---|---|---|
account
|
path | True |
string |
O nome da conta NetApp Padrão Regex: |
resource
|
path | True |
string |
O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas. |
snapshot
|
path | True |
string |
O nome da política de instantâneo |
subscription
|
path | True |
string uuid |
A ID da assinatura de destino. O valor deve ser um UUID. |
api-version
|
query | True |
string |
A versão da API a ser usada para esta operação. |
Respostas
Name | Tipo | 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
Tipo:
oauth2
Fluxo:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Âmbitos
Name | Description |
---|---|
user_impersonation | personificar a sua conta de utilizador |
Exemplos
SnapshotPolicies_ListVolumes
Pedido de amostra
Resposta da amostra
{
"value": [
{
"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"
}
}
]
}
Definições
Name | Description |
---|---|
avs |
avsDataStore |
Chown |
Este parâmetro especifica quem está autorizado a alterar a propriedade de um arquivo. restricted - Somente o usuário root pode alterar a propriedade do arquivo. irrestrito - Usuários não-root podem alterar a propriedade dos arquivos que possuem. |
cool |
coolAccessRetrievalPolicy determina o comportamento de recuperação de dados da camada fria para o armazenamento padrão com base no padrão de leitura para volumes habilitados para acesso legal. Os valores possíveis para este campo são: Padrão - Os dados serão extraídos do nível legal para o armazenamento padrão em leituras aleatórias. Esta política é o padrão. OnRead - Toda a leitura de dados orientada pelo cliente é extraída do nível legal para o armazenamento padrão em leituras sequenciais e aleatórias. Nunca - Nenhum dado controlado pelo cliente é extraído do nível legal para o armazenamento padrão. |
created |
O tipo de identidade que criou o recurso. |
Data |
Proteção de dados |
enable |
Sinalizador que indica se as operações de subvolume estão habilitadas no volume |
Encryption |
Origem da chave usada para criptografar dados em volume. Aplicável se a conta NetApp tiver encryption.keySource = 'Microsoft.KeyVault'. Os valores possíveis (sem distinção entre 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 |
O erro de gerenciamento de recursos informações adicionais. |
Error |
O detalhe do erro. |
Error |
Resposta de erro |
Export |
exportPolicy |
export |
Regra de Política de Exportação de Volume |
file |
Sinalizador que indica se os logs de acesso ao arquivo estão habilitados para o volume, com base nas configurações de diagnóstico ativas presentes no volume. |
mount |
Propriedades de destino de montagem |
Network |
Recursos de rede |
placement |
Parâmetros específicos de aplicação para a colocação de volumes no grupo de volumes |
remote |
O caminho completo para um volume que deve ser migrado para ANF. Necessário para volumes de migração |
replication |
Propriedades de replicação |
Replication |
Horário |
Security |
O estilo de segurança do volume, padrão unix, padrão para ntfs para protocolo duplo ou protocolo CIFS |
Service |
Nível de serviço |
smb |
smbAccessBasedEnumeration |
smb |
smbNonNavegável |
snapshot |
Volumes associados à política de snapshot |
system |
Metadados referentes à criação e última modificação do recurso. |
volume |
Recurso de volume |
volume |
Propriedades de backup de volume |
volume |
Propriedades de realocação de volume |
volume |
Propriedades do instantâneo de volume |
Volume |
Armazenamento para 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 arquivo. restricted - Somente o usuário root pode alterar a propriedade do arquivo. irrestrito - Usuários não-root podem alterar a propriedade dos arquivos que possuem.
Name | Tipo | Description |
---|---|---|
Restricted |
string |
|
Unrestricted |
string |
coolAccessRetrievalPolicy
coolAccessRetrievalPolicy determina o comportamento de recuperação de dados da camada fria para o armazenamento padrão com base no padrão de leitura para volumes habilitados para acesso legal. Os valores possíveis para este campo são: Padrão - Os dados serão extraídos do nível legal para o armazenamento padrão em leituras aleatórias. Esta política é o padrão. OnRead - Toda a leitura de dados orientada pelo cliente é extraída do nível legal para o armazenamento padrão em leituras sequenciais e aleatórias. Nunca - Nenhum dado controlado pelo cliente é extraído do nível legal 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
Proteção de dados
Name | Tipo | Description |
---|---|---|
backup |
Backup |
|
replication |
Replicação |
|
snapshot |
Instantâneo |
|
volumeRelocation |
Realocação de volume |
enableSubvolumes
Sinalizador que indica se as operações de subvolume estão habilitadas no volume
Name | Tipo | Description |
---|---|---|
Disabled |
string |
Os subvolumes não estão habilitados |
Enabled |
string |
Os subvolumes estão habilitados |
EncryptionKeySource
Origem da chave usada para criptografar dados em volume. Aplicável se a conta NetApp tiver encryption.keySource = 'Microsoft.KeyVault'. Os valores possíveis (sem distinção entre maiúsculas e minúsculas) são: 'Microsoft.NetApp, Microsoft.KeyVault'
Name | Tipo | Description |
---|---|---|
Microsoft.KeyVault |
string |
Criptografia de chave gerenciada pelo cliente |
Microsoft.NetApp |
string |
Criptografia de chave gerenciada 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
O erro de gerenciamento de recursos informações adicionais.
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 |
O erro informações adicionais. |
|
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 de erro
Name | Tipo | Description |
---|---|---|
error |
O objeto de erro. |
ExportPolicy
exportPolicy
Name | Tipo | Description |
---|---|---|
rules |
Regra de política de exportação |
exportPolicyRule
Regra de Política de Exportação de Volume
Name | Tipo | Default value | Description |
---|---|---|---|
allowedClients |
string |
Especificação de entrada de cliente como cadeia de caracteres separada por vírgulas com CIDRs IPv4, endereços de host IPv4 e nomes de host |
|
chownMode | Restricted |
Este parâmetro especifica quem está autorizado a alterar a propriedade de um arquivo. restricted - Somente o usuário root pode alterar a propriedade do arquivo. irrestrito - Usuários não-root podem alterar a propriedade dos arquivos que possuem. |
|
cifs |
boolean |
Permite o protocolo CIFS |
|
hasRootAccess |
boolean |
True |
Tem acesso root ao volume |
kerberos5ReadOnly |
boolean |
False |
Kerberos5 Acesso somente leitura. Para ser usado com a versão swagger 2020-05-01 ou posterior |
kerberos5ReadWrite |
boolean |
False |
Kerberos5 Acesso de leitura e gravação. Para ser usado com a versão swagger 2020-05-01 ou posterior |
kerberos5iReadOnly |
boolean |
False |
Acesso somente leitura Kerberos5i. Para ser usado com a versão swagger 2020-05-01 ou posterior |
kerberos5iReadWrite |
boolean |
False |
Kerberos5i Acesso de leitura e gravação. Para ser usado com a versão swagger 2020-05-01 ou posterior |
kerberos5pReadOnly |
boolean |
False |
Acesso somente leitura Kerberos5p. Para ser usado com a versão swagger 2020-05-01 ou posterior |
kerberos5pReadWrite |
boolean |
False |
Kerberos5p Acesso de leitura e gravação. Para ser usado com a versão swagger 2020-05-01 ou posterior |
nfsv3 |
boolean |
Permite o protocolo NFSv3. Habilitar somente para volumes do tipo NFSv3 |
|
nfsv41 |
boolean |
Permite o protocolo NFSv4.1. Habilitar somente para volumes do tipo NFSv4.1 |
|
ruleIndex |
integer |
Índice de pedidos |
|
unixReadOnly |
boolean |
Acesso somente leitura |
|
unixReadWrite |
boolean |
Acesso de leitura e gravação |
fileAccessLogs
Sinalizador que indica se os logs de acesso ao arquivo estão habilitados para o volume, com base nas configurações de diagnóstico ativas presentes no volume.
Name | Tipo | Description |
---|---|---|
Disabled |
string |
fileAccessLogs não estão habilitados |
Enabled |
string |
fileAccessLogs estão habilitados |
mountTargetProperties
Propriedades de destino de montagem
Name | Tipo | Description |
---|---|---|
fileSystemId |
string |
fileSystemId |
ipAddress |
string |
Endereço IP |
mountTargetId |
string |
mountTargetId |
smbServerFqdn |
string |
smbServerFQDN |
NetworkFeatures
Recursos de rede
Name | Tipo | Description |
---|---|---|
Basic |
string |
Recursos básicos de rede. |
Basic_Standard |
string |
Atualização de recursos de rede básicos para padrão. |
Standard |
string |
Recursos de rede padrão. |
Standard_Basic |
string |
Atualização de recursos de rede Standard para Basic. |
placementKeyValuePairs
Parâmetros específicos de aplicação para a colocação de volumes no grupo de volumes
Name | Tipo | Description |
---|---|---|
key |
string |
Chave para um parâmetro específico do aplicativo para o posicionamento de volumes no grupo de volumes |
value |
string |
Valor para um parâmetro específico do aplicativo para o posicionamento de volumes no grupo de volumes |
remotePath
O caminho completo para um volume que deve ser migrado para ANF. Necessário para volumes de migração
Name | Tipo | Description |
---|---|---|
externalHostName |
string |
O caminho para um host ONTAP |
serverName |
string |
O nome de um servidor no host ONTAP |
volumeName |
string |
O nome de um volume no servidor |
replicationObject
Propriedades de replicação
Name | Tipo | Description |
---|---|---|
endpointType |
Indica se o volume local é a origem ou o destino da Replicação de Volume |
|
remotePath |
O caminho completo para um volume que deve ser migrado para ANF. Necessário para volumes de migração |
|
remoteVolumeRegion |
string |
A região remota para a outra extremidade da Replicação de Volume. |
remoteVolumeResourceId |
string |
A ID do recurso do volume remoto. Necessário para replicação entre regiões e entre zonas |
replicationId |
string |
Id |
replicationSchedule |
Horário |
ReplicationSchedule
Horário
Name | Tipo | Description |
---|---|---|
_10minutely |
string |
|
daily |
string |
|
hourly |
string |
SecurityStyle
O estilo de segurança do volume, padrão unix, padrão para ntfs para protocolo duplo ou protocolo CIFS
Name | Tipo | Description |
---|---|---|
ntfs |
string |
|
unix |
string |
ServiceLevel
Nível de serviço
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 redundante de zona |
Ultra |
string |
Nível de serviço ultra |
smbAccessBasedEnumeration
smbAccessBasedEnumeration
Name | Tipo | Description |
---|---|---|
Disabled |
string |
A configuração de compartilhamento smbAccessBasedEnumeration está desabilitada |
Enabled |
string |
A configuração de compartilhamento smbAccessBasedEnumeration está habilitada |
smbNonBrowsable
smbNonNavegável
Name | Tipo | Description |
---|---|---|
Disabled |
string |
A configuração de compartilhamento smbNonBrowsable está desabilitada |
Enabled |
string |
A configuração de compartilhamento smbNonBrowsable está habilitada |
snapshotPolicyVolumeList
Volumes associados à política de snapshot
Name | Tipo | Description |
---|---|---|
value |
volume[] |
Lista de volumes |
systemData
Metadados referentes à 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 | Default value | Description |
---|---|---|---|
etag |
string |
Uma cadeia de caracteres somente leitura exclusiva que muda sempre que o recurso é atualizado. |
|
id |
string |
ID de recurso totalmente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
|
location |
string |
A geolocalização onde o recurso vive |
|
name |
string |
O nome do recurso |
|
properties.actualThroughputMibps |
number |
Taxa de transferência real em MiB/s para volumes auto qosType calculados com base no tamanho e no nível de serviço |
|
properties.avsDataStore | Disabled |
avsDataStore |
|
properties.backupId |
string |
Backup ID |
|
properties.baremetalTenantId |
string |
ID do locatário baremetal |
|
properties.capacityPoolResourceId |
string |
ID do recurso do pool usado no caso de criar um volume através do grupo de volumes |
|
properties.cloneProgress |
integer |
Quando um volume estiver sendo restaurado a partir do instantâneo de outro volume, mostrará a porcentagem de conclusão desse processo de clonagem. Quando esse valor está vazio/nulo, não há nenhum processo de clonagem acontecendo atualmente neste volume. Esse valor será atualizado a cada 5 minutos durante a clonagem. |
|
properties.coolAccess |
boolean |
False |
Especifica se o Acesso Fresco (hierarquização) está habilitado para o volume. |
properties.coolAccessRetrievalPolicy |
coolAccessRetrievalPolicy determina o comportamento de recuperação de dados da camada fria para o armazenamento padrão com base no padrão de leitura para volumes habilitados para acesso legal. Os valores possíveis para este campo são: Padrão - Os dados serão extraídos do nível legal para o armazenamento padrão em leituras aleatórias. Esta política é o padrão. OnRead - Toda a leitura de dados orientada pelo cliente é extraída do nível legal para o armazenamento padrão em leituras sequenciais e aleatórias. Nunca - Nenhum dado controlado pelo cliente é extraído do nível legal para o armazenamento padrão. |
||
properties.coolnessPeriod |
integer |
Especifica o número de dias após os quais os dados que não são acessados pelos clientes serão hierarquizados. |
|
properties.creationToken |
string |
Token de criação ou caminho do arquivo |
|
properties.dataProtection |
Proteção de dados |
||
properties.dataStoreResourceId |
string[] |
dataStoreResourceId |
|
properties.defaultGroupQuotaInKiBs |
integer |
0 |
Cota de grupo padrão para volume em KiBs. Se isDefaultQuotaEnabled estiver definido, aplica-se o valor mínimo de 4 KiBs. |
properties.defaultUserQuotaInKiBs |
integer |
0 |
Cota de usuário padrão para volume em KiBs. Se isDefaultQuotaEnabled estiver definido, aplica-se o valor mínimo de 4 KiBs. |
properties.deleteBaseSnapshot |
boolean |
Se ativado (true), o instantâneo a partir do qual o volume foi criado será automaticamente excluído após a conclusão da operação de criação de volume. O padrão é false |
|
properties.effectiveNetworkFeatures | Basic |
Recursos de rede |
|
properties.enableSubvolumes | Disabled |
Sinalizador que indica se as operações de subvolume estão habilitadas no volume |
|
properties.encrypted |
boolean |
Especifica se o volume é criptografado ou não. Disponível apenas em volumes criados ou atualizados após 2022-01-01. |
|
properties.encryptionKeySource | Microsoft.NetApp |
Origem da chave usada para criptografar dados em volume. Aplicável se a conta NetApp tiver encryption.keySource = 'Microsoft.KeyVault'. Os valores possíveis (sem distinção entre maiúsculas e minúsculas) são: 'Microsoft.NetApp, Microsoft.KeyVault' |
|
properties.exportPolicy |
exportPolicy |
||
properties.fileAccessLogs | Disabled |
Sinalizador que indica se os logs de acesso ao arquivo estão habilitados para o volume, com base nas configurações de diagnóstico ativas presentes no volume. |
|
properties.fileSystemId |
string |
ID do sistema de arquivos |
|
properties.isDefaultQuotaEnabled |
boolean |
False |
Especifica se a cota padrão está habilitada para o volume. |
properties.isLargeVolume |
boolean |
False |
É grande volume |
properties.isRestoring |
boolean |
Restaurando |
|
properties.kerberosEnabled |
boolean |
False |
Descreva se um volume é KerberosEnabled. Para ser usado com a versão swagger 2020-05-01 ou posterior |
properties.keyVaultPrivateEndpointResourceId |
string |
O ID de recurso do ponto de extremidade privado para KeyVault. Ele deve residir na mesma VNET que o volume. Aplicável apenas se encryptionKeySource = 'Microsoft.KeyVault'. |
|
properties.ldapEnabled |
boolean |
False |
Especifica se o LDAP está habilitado ou não para um determinado volume NFS. |
properties.maximumNumberOfFiles |
integer |
Número máximo de ficheiros permitidos. Precisa de uma solicitação de serviço para ser alterado. Só é permitida a alteração se a quota de volume for superior a 4TiB. |
|
properties.mountTargets |
mountTargets [en] |
||
properties.networkFeatures | Basic |
Recursos de rede |
|
properties.networkSiblingSetId |
string |
ID do conjunto de irmãos da rede |
|
properties.originatingResourceId |
string |
ID do recurso de origem |
|
properties.placementRules |
Regras de posicionamento de volume |
||
properties.protocolTypes |
string[] |
protocolTypes |
|
properties.provisionedAvailabilityZone |
string |
Zona de disponibilidade provisionada |
|
properties.provisioningState |
string |
Gerenciamento do ciclo de vida do Azure |
|
properties.proximityPlacementGroup |
string |
Grupo de posicionamento de proximidade associado ao volume |
|
properties.securityStyle | unix |
O estilo de segurança do volume, padrão unix, padrão para ntfs para protocolo duplo ou protocolo CIFS |
|
properties.serviceLevel | Premium |
Nível de serviço |
|
properties.smbAccessBasedEnumeration |
smbAccessBasedEnumeration |
||
properties.smbContinuouslyAvailable |
boolean |
False |
Permite a propriedade de compartilhamento continuamente disponível para o volume smb. Aplicável apenas ao volume SMB |
properties.smbEncryption |
boolean |
False |
Permite a criptografia para dados smb3 em voo. Aplicável apenas para o volume SMB/DualProtocol. Para ser usado com a versão swagger 2020-08-01 ou posterior |
properties.smbNonBrowsable |
smbNonNavegável |
||
properties.snapshotDirectoryVisible |
boolean |
True |
Se ativado (true), o volume conterá um diretório de instantâneo somente leitura que fornece acesso a cada um dos instantâneos do volume (o padrão é true). |
properties.snapshotId |
string |
ID do instantâneo |
|
properties.storageToNetworkProximity |
Armazenamento para proximidade de rede |
||
properties.subnetId |
string |
O URI de Recursos do Azure para uma sub-rede delegada. Deve ter a delegação Microsoft.NetApp/volumes |
|
properties.t2Network |
string |
Informação da rede T2 |
|
properties.throughputMibps |
number |
Taxa de transferência máxima em MiB/s que pode ser alcançada por este volume e isso será aceito como entrada apenas para o volume qosType manual |
|
properties.unixPermissions |
string |
Permissões UNIX para volume NFS aceito no formato octal de 4 dígitos. O primeiro dígito seleciona os atributos set user ID(4), set group ID (2) e sticky (1). O segundo dígito seleciona a permissão para o proprietário do arquivo: ler (4), escrever (2) e executar (1). Terceiro seleciona permissões para outros usuários no mesmo grupo. o quarto para outros usuários que não fazem parte do grupo. 0755 - Dá permissões de leitura/gravação/execução para o proprietário e leitura/execução para o grupo e outros usuários. |
|
properties.usageThreshold |
integer |
0 |
usageThreshold |
properties.volumeGroupName |
string |
Nome do Grupo de Volumes |
|
properties.volumeSpecName |
string |
Nome da especificação do volume é a designação ou identificador específico do aplicativo para o volume específico em um grupo de volumes para, por exemplo, dados, log |
|
properties.volumeType |
string |
Que tipo de volume é esse. Para volumes de destino na Replicação entre Regiões, defina o tipo como DataProtection |
|
systemData |
Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy. |
||
tags |
object |
Tags de recursos. |
|
type |
string |
O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts" |
|
zones |
string[] |
Zona de disponibilidade |
volumeBackupProperties
Propriedades de backup de volume
Name | Tipo | Description |
---|---|---|
backupPolicyId |
string |
ID do recurso da política de backup |
backupVaultId |
string |
ID do recurso do cofre de backup |
policyEnforced |
boolean |
Política aplicada |
volumeRelocationProperties
Propriedades de realocação de volume
Name | Tipo | Description |
---|---|---|
readyToBeFinalized |
boolean |
Tem realocação concluída e está pronto para ser limpo |
relocationRequested |
boolean |
Foi solicitada a recolocação para este volume |
volumeSnapshotProperties
Propriedades do instantâneo de volume
Name | Tipo | Description |
---|---|---|
snapshotPolicyId |
string |
Snapshot Policy ResourceId |
VolumeStorageToNetworkProximity
Armazenamento para proximidade de rede
Name | Tipo | Description |
---|---|---|
AcrossT2 |
string |
Armazenamento AcrossT2 padrão para conectividade de rede. |
Default |
string |
Armazenamento básico para conectividade de rede. |
T1 |
string |
Armazenamento T1 padrão para conectividade de rede. |
T2 |
string |
Armazenamento T2 padrão para conectividade de rede. |