Volumes - Get

Opisywanie woluminu
Pobieranie szczegółów określonego woluminu

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

Parametry identyfikatora URI

Name In Required Type Description
accountName
path True
  • string

Nazwa konta usługi NetApp

poolName
path True
  • string

Nazwa puli pojemności

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

resourceGroupName
path True
  • string

Nazwa grupy zasobów.

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

subscriptionId
path True
  • string

Poświadczenia subskrypcji, które jednoznacznie identyfikują subskrypcję platformy Microsoft Azure. Identyfikator subskrypcji stanowi część identyfikatora URI dla każdego wywołania usługi.

volumeName
path True
  • string

Nazwa woluminu

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

api-version
query True
  • string

Wersja interfejsu API do użycia na potrzeby tej operacji.

Odpowiedzi

Name Type Description
200 OK

OK

Other Status Codes

Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory

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

Scopes

Name Description
user_impersonation personifikacja konta użytkownika

Przykłady

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

Definicje

avsDataStore

avsDataStore

ChownMode

Ten parametr określa, kto ma uprawnienia do zmiany własności pliku. ograniczone — tylko użytkownik główny może zmienić własność pliku. unrestricted — użytkownicy niebędący użytkownikami głównymi mogą zmieniać własność plików, których są właścicielami.

DataProtection

Ochrona danych

enableSubvolumes

Flaga wskazująca, czy operacje podvolume są włączone na woluminie

EndpointType

Wskazuje, czy wolumin lokalny jest źródłem, czy miejscem docelowym replikacji woluminu

ExportPolicy

exportPolicy

exportPolicyRule

Reguła zasad eksportu woluminów

mountTargetProperties

Właściwości obiektu docelowego instalacji

NetworkFeatures

Funkcje sieciowe

placementKeyValuePairs

Parametry specyficzne dla aplikacji dotyczące umieszczania woluminów w grupie woluminów

replicationObject

Właściwości replikacji

ReplicationSchedule

Zaplanuj

SecurityStyle

Styl zabezpieczeń woluminu, domyślny unix, domyślnie ntfs dla dwóch protokołów lub CIFS

ServiceLevel

serviceLevel

volume

Zasób woluminu

volumeBackupProperties

Właściwości kopii zapasowej woluminu

volumeSnapshotProperties

Właściwości migawki woluminu

VolumeStorageToNetworkProximity

Zbliżenie magazynu do sieci

avsDataStore

avsDataStore

Name Type Description
Disabled
  • string

avsDataStore jest wyłączona

Enabled
  • string

avsDataStore jest włączona

ChownMode

Ten parametr określa, kto ma uprawnienia do zmiany własności pliku. ograniczone — tylko użytkownik główny może zmienić własność pliku. unrestricted — użytkownicy niebędący użytkownikami głównymi mogą zmieniać własność plików, których są właścicielami.

Name Type Description
Restricted
  • string
Unrestricted
  • string

DataProtection

Ochrona danych

Name Type Description
backup

Backup
Właściwości kopii zapasowej

replication

Replikacja
Właściwości replikacji

snapshot

Snapshot
Właściwości migawki.

enableSubvolumes

Flaga wskazująca, czy operacje podvolume są włączone na woluminie

Name Type Description
Disabled
  • string

podwolumy nie są włączone

Enabled
  • string

podwolułki są włączone

EndpointType

Wskazuje, czy wolumin lokalny jest źródłem, czy miejscem docelowym replikacji woluminu

Name Type Description
dst
  • string
src
  • string

ExportPolicy

exportPolicy

Name Type Description
rules

Eksportowanie reguły zasad
Eksportowanie reguły zasad

exportPolicyRule

Reguła zasad eksportu woluminów

Name Type Default Value Description
allowedClients
  • string

Specyfikacja ruchu przychodzącego klienta jako ciąg rozdzielony przecinkami z adresami CIDR IPv4, adresami hostów IPv4 i nazwami hostów

chownMode Restricted

Ten parametr określa, kto ma uprawnienia do zmiany własności pliku. ograniczone — tylko użytkownik główny może zmienić własność pliku. unrestricted — użytkownicy niebędący użytkownikami głównymi mogą zmieniać własność plików, których są właścicielami.

cifs
  • boolean

Zezwala na protokół CIFS

hasRootAccess
  • boolean
True

Ma dostęp do woluminu głównego

kerberos5ReadOnly
  • boolean
False

Dostęp tylko do odczytu protokołu Kerberos5. Aby używać programu Swagger w wersji 2020-05-01 lub nowszej

kerberos5ReadWrite
  • boolean
False

Dostęp do odczytu i zapisu protokołu Kerberos5. Aby używać programu Swagger w wersji 2020-05-01 lub nowszej

kerberos5iReadOnly
  • boolean
False

Dostęp tylko do odczytu protokołu Kerberos5i. Aby używać programu Swagger w wersji 2020-05-01 lub nowszej

kerberos5iReadWrite
  • boolean
False

Dostęp do odczytu i zapisu protokołu Kerberos5i. Aby używać programu Swagger w wersji 2020-05-01 lub nowszej

kerberos5pReadOnly
  • boolean
False

Dostęp tylko do odczytu protokołu Kerberos5p. Aby używać programu Swagger w wersji 2020-05-01 lub nowszej

kerberos5pReadWrite
  • boolean
False

Dostęp do odczytu i zapisu protokołu Kerberos5p. Aby używać programu Swagger w wersji 2020-05-01 lub nowszej

nfsv3
  • boolean

Zezwala na protokół NFSv3. Włącz tylko dla woluminów typu NFSv3

nfsv41
  • boolean

Zezwala na protokół NFSv4.1. Włącz tylko dla woluminów typu NFSv4.1

ruleIndex
  • integer

Indeks zamówienia

unixReadOnly
  • boolean

Dostęp tylko do odczytu

unixReadWrite
  • boolean

Dostęp do odczytu i zapisu

mountTargetProperties

Właściwości obiektu docelowego instalacji

Name Type Description
fileSystemId
  • string

fileSystemId
Identyfikator UUID w wersji 4 używany do identyfikowania obiektu MountTarget

ipAddress
  • string

Ipaddress
Adres IPv4 obiektu docelowego instalacji

mountTargetId
  • string

mountTargetId
Identyfikator UUID w wersji 4 używany do identyfikowania obiektu MountTarget

smbServerFqdn
  • string

smbServerFQDN
W pełni kwalifikowana nazwa domeny serwera SMB, nazwa FQDN

NetworkFeatures

Funkcje sieciowe

Name Type Description
Basic
  • string

Podstawowa funkcja sieci.

Standard
  • string

Standardowa funkcja sieci.

placementKeyValuePairs

Parametry specyficzne dla aplikacji dotyczące umieszczania woluminów w grupie woluminów

Name Type Description
key
  • string

Klucz dla parametru specyficznego dla aplikacji dla umieszczania woluminów w grupie woluminów

value
  • string

Wartość parametru specyficznego dla aplikacji dla umieszczania woluminów w grupie woluminów

replicationObject

Właściwości replikacji

Name Type Description
endpointType

Wskazuje, czy wolumin lokalny jest źródłem, czy miejscem docelowym replikacji woluminu

remoteVolumeRegion
  • string

Region zdalny dla drugiego końca replikacji woluminu.

remoteVolumeResourceId
  • string

Identyfikator zasobu woluminu zdalnego.

replicationId
  • string

Id

replicationSchedule

Zaplanuj

ReplicationSchedule

Zaplanuj

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

SecurityStyle

Styl zabezpieczeń woluminu, domyślny unix, domyślnie ntfs dla dwóch protokołów lub CIFS

Name Type Description
ntfs
  • string
unix
  • string

ServiceLevel

serviceLevel

Name Type Description
Premium
  • string

Poziom usług w warstwie Premium

Standard
  • string

Poziom usługi w warstwie Standardowa

StandardZRS
  • string

Poziom usługi magazynu strefowo nadmiarowego

Ultra
  • string

Poziom usług w warstwie Ultra

volume

Zasób woluminu

Name Type Default Value Description
etag
  • string

Unikatowy ciąg tylko do odczytu, który zmienia się za każdym razem, gdy zasób jest aktualizowany.

id
  • string

W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex — /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location
  • string

Lokalizacja geograficzna, w której znajduje się zasób

name
  • string

Nazwa zasobu

properties.avsDataStore Disabled

avsDataStore
Określa, czy wolumin jest włączony na potrzeby magazynu danych Azure VMware Solution (AVS)

properties.backupId
  • string

Identyfikator kopii zapasowej
Identyfikator UUID w wersji 4 lub identyfikator zasobu używany do identyfikowania kopii zapasowej.

properties.baremetalTenantId
  • string

Identyfikator dzierżawy Baremetal
Unikatowy identyfikator dzierżawy baremetalu.

properties.capacityPoolResourceId
  • string

Identyfikator zasobu puli używany w przypadku tworzenia woluminu za pośrednictwem grupy woluminów

properties.cloneProgress
  • integer

Po przywróceniu woluminu z migawki innego woluminu zostanie wyświetlony procent ukończenia tego procesu klonowania. Jeśli ta wartość jest pusta/null, na tym woluminie nie ma obecnie żadnego procesu klonowania. Ta wartość będzie aktualizowana co 5 minut podczas klonowania.

properties.coolAccess
  • boolean
False

Określa, czy dla woluminu jest włączony dostęp chłodny (warstwowanie).

properties.coolnessPeriod
  • integer

Określa liczbę dni, po których dane, do których nie mają dostępu klienci, będą warstwowe.

properties.creationToken
  • string

Tworzenie tokenu lub ścieżki pliku
Unikatowa ścieżka pliku dla woluminu. Używane podczas tworzenia obiektów docelowych instalacji

properties.dataProtection

Ochrona danych
Woluminy typu DataProtection obejmują obiekt zawierający szczegóły replikacji

properties.defaultGroupQuotaInKiBs
  • integer
0

Domyślny limit przydziału grupy dla woluminu w kibs. Jeśli parametr isDefaultQuotaEnabled jest ustawiony, ma zastosowanie minimalna wartość 4 KiBs.

properties.defaultUserQuotaInKiBs
  • integer
0

Domyślny limit przydziału użytkownika dla woluminu w kibs. Jeśli parametr isDefaultQuotaEnabled jest ustawiony, ma zastosowanie minimalna wartość 4 kb.

properties.enableSubvolumes Disabled

Flaga wskazująca, czy operacje podvolume są włączone na woluminie

properties.encryptionKeySource
  • string

Źródło klucza szyfrowania. Możliwe wartości to: "Microsoft.NetApp"

properties.exportPolicy

exportPolicy
Zestaw reguł zasad eksportu

properties.fileSystemId
  • string

Identyfikator systemu plików
Unikatowy identyfikator systemu plików.

properties.isDefaultQuotaEnabled
  • boolean
False

Określa, czy dla woluminu jest włączony domyślny limit przydziału.

properties.isRestoring
  • boolean

Przywracanie

properties.kerberosEnabled
  • boolean
False

Opisz, czy wolumin jest KerberosEnabled. Aby używać programu Swagger w wersji 2020-05-01 lub nowszej

properties.ldapEnabled
  • boolean
False

Określa, czy protokół LDAP jest włączony, czy nie dla danego woluminu NFS.

properties.maximumNumberOfFiles
  • integer

Maksymalna dozwolona liczba plików. Wymaga żądania obsługi w celu zmiany. Można zmienić tylko wtedy, gdy limit przydziału woluminu przekracza wartość 4TiB.

properties.mountTargets

mountTargets
Lista obiektów docelowych instalacji

properties.networkFeatures Basic

Funkcje sieciowe
Podstawowa sieć lub funkcje standardowe dostępne dla woluminu.

properties.networkSiblingSetId
  • string

Identyfikator zestawu elementów równorzędnych sieci
Identyfikator zestawu elementów równorzędnych sieci dla grupy woluminów współużytkowania zasobów sieciowych.

properties.placementRules

Reguły umieszczania woluminów
Reguły umieszczania specyficzne dla aplikacji dla określonego woluminu

properties.protocolTypes
  • string[]

protocolTypes
Zestaw typów protokołów, domyślny NFSv3, CIFS dla protokołu SMB

properties.provisioningState
  • string

Zarządzanie cyklem życia platformy Azure

properties.proximityPlacementGroup
  • string

Grupa umieszczania w pobliżu skojarzona z woluminem

properties.securityStyle unix

Styl zabezpieczeń woluminu, domyślny unix, domyślnie ntfs dla protokołu podwójnego lub protokołu CIFS

properties.serviceLevel Premium

serviceLevel
Poziom usługi systemu plików

properties.smbContinuouslyAvailable
  • boolean
False

Włącza stale dostępną właściwość udziału dla woluminu smb. Dotyczy tylko woluminu SMB

properties.smbEncryption
  • boolean
False

Umożliwia szyfrowanie danych smb3 w locie. Dotyczy tylko woluminu SMB/DualProtocol. Do użycia z programem Swagger w wersji 2020-08-01 lub nowszej

properties.snapshotDirectoryVisible
  • boolean
True

W przypadku włączenia (true) wolumin będzie zawierać katalog migawek tylko do odczytu, który zapewnia dostęp do każdej migawki woluminu (wartość domyślna to true).

properties.snapshotId
  • string

Identyfikator migawki
Identyfikator UUID w wersji 4 lub identyfikator zasobu używany do identyfikowania migawki.

properties.storageToNetworkProximity

Zbliżenie magazynu do sieci
Udostępnia informacje o sąsiedztwie sieci dla woluminu.

properties.subnetId
  • string

Identyfikator URI zasobu platformy Azure dla delegowanej podsieci. Musi mieć delegowanie Microsoft.NetApp/woluminy

properties.t2Network
  • string

Informacje o sieci T2

properties.throughputMibps
  • number

Maksymalna przepływność w usłudze Mibps, które można osiągnąć przez ten wolumin i zostanie zaakceptowana jako dane wejściowe tylko dla woluminu qosType ręcznego

properties.unixPermissions
  • string
0770

Uprawnienia systemu UNIX dla woluminu NFS zaakceptowane w formacie ósemkowym 4-cyfrowym. Pierwsza cyfra wybiera ustawione atrybuty identyfikatora użytkownika (4), ustawia identyfikator grupy (2) i sticky (1). Druga cyfra wybiera uprawnienie właściciela pliku: odczyt (4), zapis (2) i wykonanie (1). Trzeci wybiera uprawnienia dla innych użytkowników w tej samej grupie. czwarty dla innych użytkowników, którzy nie należą do grupy. 0755 — daje uprawnienia do odczytu/zapisu/wykonywania dla właściciela i odczytu/wykonywania w grupie i innych użytkownikach.

properties.usageThreshold
  • integer
0

usageThreshold
Maksymalny limit przydziału magazynu dozwolony dla systemu plików w bajtach. Jest to przydział nietrwały używany tylko do zgłaszania alertów. Minimalny rozmiar to 100 GiB. Górny limit wynosi 100TiB. Określone w bajtach.

properties.volumeGroupName
  • string

Nazwa grupy woluminów

properties.volumeSpecName
  • string

Nazwa specyfikacji woluminu to specyficzne dla aplikacji oznaczenie lub identyfikator określonego woluminu w grupie woluminów, na przykład dane, dziennik

properties.volumeType
  • string

Jaki jest typ woluminu. W przypadku woluminów docelowych w replikacji między regionami ustaw typ na DataProtection

tags
  • object

Tagi zasobów.

type
  • string

Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

volumeBackupProperties

Właściwości kopii zapasowej woluminu

Name Type Description
backupEnabled
  • boolean

Włączono tworzenie kopii zapasowych

backupPolicyId
  • string

Identyfikator zasobu zasad kopii zapasowych

policyEnforced
  • boolean

Wymuszane zasady

vaultId
  • string

Identyfikator zasobu magazynu

volumeSnapshotProperties

Właściwości migawki woluminu

Name Type Description
snapshotPolicyId
  • string

Identyfikator resourceid zasad migawek

VolumeStorageToNetworkProximity

Zbliżenie magazynu do sieci

Name Type Description
Default
  • string

Podstawowa pamięć masowa z łącznością sieciową.

T1
  • string

Standardowa pamięć masowa T1 z łącznością sieciową.

T2
  • string

Standardowa pamięć masowa T2 z łącznością sieciową.