Die deutsche Sprachversion wurde als Serviceleistung für Sie durch maschinelle Übersetzung erstellt. Bei eventuellen Unstimmigkeiten hat die englische Sprachversion Vorrang.

UmfyVolume

10/01/2024 Beitragende

PDFs

Sie können die Methode verwenden ModifyVolume, um Einstellungen für ein vorhandenes Volume zu ändern. Sie können Änderungen an einem Volume gleichzeitig vornehmen, und sofortige Änderungen finden statt.

Wenn Sie beim Ändern eines Volume keine QoS-Werte angeben, bleiben diese unverändert vor der Änderung. Sie können die standardmäßigen QoS-Werte für ein neu erstelltes Volume abrufen, indem Sie die Methode ausführen GetDefaultQoS.

Wenn Sie die Größe eines Volumes erhöhen müssen, das repliziert wird, gehen Sie folgendermaßen vor, um Replizierungsfehler zu vermeiden:

Erhöhen Sie die Größe des Volumes mit replizierungTarget-Zugriff.
Erhöhen Sie die Größe des Quell- oder Volume mit ReadWrite-Zugriff.

Stellen Sie sicher, dass sowohl die Ziel- als auch die Quell-Volumes dieselbe Größe haben.

Wenn Sie den Zugriffsstatus in gesperrt oder ReplikationTarget ändern, werden alle vorhandenen iSCSI-Verbindungen beendet.

Parameter

Diese Methode verfügt über die folgenden Eingabeparameter:

Name Beschreibung Typ Standardwert Erforderlich

Name	Beschreibung	Typ	Standardwert	Erforderlich
VolumeID	Die VolumeID des zu ändernden Volumes	Ganzzahl	Keine	Ja.
Datenzugriff	Zugriff für das Volume zulässig. Mögliche Werte: `readOnly`: Nur Lesevorgänge sind erlaubt. `readWrite`: Lesen und Schreiben sind erlaubt. `locked`: Es sind keine Lese- oder Schreibvorgänge erlaubt. Wenn nicht angegeben, ändert sich der Zugriffswert nicht. `replicationTarget`: Identifizieren Sie ein Volume als Zielvolumen für einen gepaarten Volumensatz. Wenn das Volume nicht gekoppelt ist, ist der Zugriffsstatus gesperrt. Wenn kein Wert angegeben wird, ändert sich der Zugriffswert nicht. `snapMirrorTarget`: Identifizieren eines Volumes als Zielvolume für die SnapMirror-Replikation.	Zeichenfolge	Keine	Nein
AccountID	Die AccountID, der das Volumen neu zugeordnet wird. Wenn keine angegeben wird, wird der vorherige Kontoname verwendet.	Ganzzahl	Keine	Nein
AssoziateWithQoSPolicy	Verknüpfen Sie das Volume mit der angegebenen QoS-Richtlinie. Mögliche Werte: `true`: Verknüpfen Sie das Volume mit der QoS-Richtlinie, die im QoSPolicyID-Parameter angegeben ist. `false`: Verknüpfen Sie das Volume nicht mit der QoS Policy, die im QoSPolicyID-Parameter angegeben ist. Wenn „false“, wird eine vorhandene Richtlinienzuordnung entfernt, unabhängig davon, ob Sie im Parameter QoSPolicy eine QoS-Richtlinie angeben.	boolesch	Keine	Nein
Merkmale	Liste von Name-Wert-Paaren im JSON-Objektformat.	JSON Objekt	Keine	Nein
CreateTime	Eine ISO 8601-Datumszeichenfolge, die als Erstellungsdatum des neuen Volumes festgelegt werden soll. Erforderlich, wenn setCreateTime auf true gesetzt ist.	ISO 8601-Zeichenfolge	Keine	Nein
AbleSnapMirrorReplication	Legt fest, ob das Volume für die Replizierung mit SnapMirror Endpunkten verwendet werden kann. Mögliche Werte: `true` `false`	boolesch	Falsch	Nein
FifoGröße	Gibt die maximale Anzahl von FIFO-Snapshots an, die vom Volume unterstützt werden. Beachten Sie, dass FIFO- und nicht-FIFO-Snapshots beide denselben Pool verfügbarer Snapshot-Steckplätze auf einem Volume nutzen. Verwenden Sie diese Option, um den FIFO-Snapshot-Verbrauch der verfügbaren Snapshot-Steckplätze zu begrenzen. Beachten Sie, dass Sie diesen Wert nicht so ändern können, dass er kleiner als die aktuelle FIFO-Snapshot-Anzahl ist.	Ganzzahl	Keine	Nein
Min50 Größe	Gibt die Anzahl der Snapshot-Steckplätze an, die nur für FIFO-Snapshots (First in First out) reserviert sind. Da FIFO- und nicht-FIFO-Snapshots sich den gleichen Pool teilen, reduziert der minFifoSize-Parameter die Gesamtzahl der möglichen Non-FIFO-Schnappschüsse um die gleiche Menge. Beachten Sie, dass Sie diesen Wert nicht ändern können, damit er mit der aktuellen Anzahl nicht-FIFO-Snapshots in Konflikt steht.	Ganzzahl	Keine	Nein
Modus	Volume-Replizierungsmodus Mögliche Werte: `asynch`: Wartet, bis das System bestätigt, dass Daten auf der Quelle gespeichert werden, bevor es auf das Ziel geschrieben wird. `sync`: Wartet nicht auf die Bestätigung der Datenübertragung von der Quelle, um die Daten an das Ziel zu schreiben.	Zeichenfolge	Keine	Nein
qos	Die neue Quality of Service-Einstellungen für dieses Volume. Wenn nicht angegeben, werden die QoS-Einstellungen nicht geändert. Mögliche Werte: `minIOPS` `maxIOPS` `burstIOPS`	QoS	Keine	Nein
QosPolicyID	Die ID für die Richtlinie, deren QoS-Einstellungen auf die angegebenen Volumes angewendet werden sollten. Dieser Parameter schließen sich gegenseitig mit dem qos-Parameter aus.	Ganzzahl	Keine	Nein
SetCreateTime	Setzen Sie auf true, um das aufgezeichnete Datum der Volume-Erstellung zu ändern.	boolesch	Keine	Nein
Summengröße	Die neue Größe des Volumes in Byte. 1000000000 entspricht 1 GB. Die Größe wird auf den nächsten Megabyte aufgerundet. Mit diesem Parameter kann nur die Größe eines Volumes erhöht werden.	Ganzzahl	Keine	Nein

VolumeID

Die VolumeID des zu ändernden Volumes

Ganzzahl

Keine

Ja.

Datenzugriff

Zugriff für das Volume zulässig. Mögliche Werte:

readOnly: Nur Lesevorgänge sind erlaubt.
readWrite: Lesen und Schreiben sind erlaubt.
locked: Es sind keine Lese- oder Schreibvorgänge erlaubt. Wenn nicht angegeben, ändert sich der Zugriffswert nicht.
replicationTarget: Identifizieren Sie ein Volume als Zielvolumen für einen gepaarten Volumensatz. Wenn das Volume nicht gekoppelt ist, ist der Zugriffsstatus gesperrt. Wenn kein Wert angegeben wird, ändert sich der Zugriffswert nicht.
snapMirrorTarget: Identifizieren eines Volumes als Zielvolume für die SnapMirror-Replikation.

Zeichenfolge

Keine

Nein

AccountID

Die AccountID, der das Volumen neu zugeordnet wird. Wenn keine angegeben wird, wird der vorherige Kontoname verwendet.

Ganzzahl

Keine

Nein

AssoziateWithQoSPolicy

Verknüpfen Sie das Volume mit der angegebenen QoS-Richtlinie. Mögliche Werte:

true: Verknüpfen Sie das Volume mit der QoS-Richtlinie, die im QoSPolicyID-Parameter angegeben ist.
false: Verknüpfen Sie das Volume nicht mit der QoS Policy, die im QoSPolicyID-Parameter angegeben ist. Wenn „false“, wird eine vorhandene Richtlinienzuordnung entfernt, unabhängig davon, ob Sie im Parameter QoSPolicy eine QoS-Richtlinie angeben.

boolesch

Keine

Nein

Merkmale

Liste von Name-Wert-Paaren im JSON-Objektformat.

JSON Objekt

Keine

Nein

CreateTime

Eine ISO 8601-Datumszeichenfolge, die als Erstellungsdatum des neuen Volumes festgelegt werden soll. Erforderlich, wenn setCreateTime auf true gesetzt ist.

ISO 8601-Zeichenfolge

Keine

Nein

AbleSnapMirrorReplication

Legt fest, ob das Volume für die Replizierung mit SnapMirror Endpunkten verwendet werden kann. Mögliche Werte:

true
false

boolesch

Falsch

Nein

FifoGröße

Gibt die maximale Anzahl von FIFO-Snapshots an, die vom Volume unterstützt werden. Beachten Sie, dass FIFO- und nicht-FIFO-Snapshots beide denselben Pool verfügbarer Snapshot-Steckplätze auf einem Volume nutzen. Verwenden Sie diese Option, um den FIFO-Snapshot-Verbrauch der verfügbaren Snapshot-Steckplätze zu begrenzen. Beachten Sie, dass Sie diesen Wert nicht so ändern können, dass er kleiner als die aktuelle FIFO-Snapshot-Anzahl ist.

Ganzzahl

Keine

Nein

Min50 Größe

Gibt die Anzahl der Snapshot-Steckplätze an, die nur für FIFO-Snapshots (First in First out) reserviert sind. Da FIFO- und nicht-FIFO-Snapshots sich den gleichen Pool teilen, reduziert der minFifoSize-Parameter die Gesamtzahl der möglichen Non-FIFO-Schnappschüsse um die gleiche Menge. Beachten Sie, dass Sie diesen Wert nicht ändern können, damit er mit der aktuellen Anzahl nicht-FIFO-Snapshots in Konflikt steht.

Ganzzahl

Keine

Nein

Modus

Volume-Replizierungsmodus Mögliche Werte:

asynch: Wartet, bis das System bestätigt, dass Daten auf der Quelle gespeichert werden, bevor es auf das Ziel geschrieben wird.
sync: Wartet nicht auf die Bestätigung der Datenübertragung von der Quelle, um die Daten an das Ziel zu schreiben.

Zeichenfolge

Keine

Nein

qos

Die neue Quality of Service-Einstellungen für dieses Volume. Wenn nicht angegeben, werden die QoS-Einstellungen nicht geändert. Mögliche Werte:

minIOPS
maxIOPS
burstIOPS

QoS

Keine

Nein

QosPolicyID

Die ID für die Richtlinie, deren QoS-Einstellungen auf die angegebenen Volumes angewendet werden sollten. Dieser Parameter schließen sich gegenseitig mit dem qos-Parameter aus.

Ganzzahl

Keine

Nein

SetCreateTime

Setzen Sie auf true, um das aufgezeichnete Datum der Volume-Erstellung zu ändern.

boolesch

Keine

Nein

Summengröße

Die neue Größe des Volumes in Byte. 1000000000 entspricht 1 GB. Die Größe wird auf den nächsten Megabyte aufgerundet. Mit diesem Parameter kann nur die Größe eines Volumes erhöht werden.

Ganzzahl

Keine

Nein

Rückgabewert

Diese Methode hat den folgenden Rückgabewert:

Name

Beschreibung

Typ

Datenmenge

Objekt mit Informationen zum neu geänderten Volume.

Datenmenge

Anforderungsbeispiel

Anforderungen für diese Methode sind ähnlich wie das folgende Beispiel:

{
  "method": "ModifyVolume",
  "params": {
     "volumeID": 5,
     "attributes": {
        "name1": "value1",
        "name2": "value2",
        "name3": "value3"
     },
     "qos": {
        "minIOPS": 60,
        "maxIOPS": 100,
        "burstIOPS": 150,
        "burstTime": 60
     },
      "access" :"readWrite"
     },
      "totalSize": 20000000000,
     "id": 1
}

Antwortbeispiel

Diese Methode gibt eine Antwort zurück, die dem folgenden Beispiel ähnelt:

{
  "id": 1,
  "result": {
      "volume": {
          "access": "readWrite",
          "accountID": 1,
          "attributes": {
              "name1": "value1",
              "name2": "value2",
              "name3": "value3"
          },
          "blockSize": 4096,
          "createTime": "2016-03-28T16:16:13Z",
          "deleteTime": "",
          "enable512e": true,
          "iqn": "iqn.2010-01.com.solidfire:jyay.1459181777648.5",
          "name": "1459181777648",
          "purgeTime": "",
          "qos": {
              "burstIOPS": 150,
              "burstTime": 60,
              "curve": {
                  "4096": 100,
                  "8192": 160,
                  "16384": 270,
                  "32768": 500,
                  "65536": 1000,
                  "131072": 1950,
                  "262144": 3900,
                  "524288": 7600,
                  "1048576": 15000
              },
              "maxIOPS": 100,
              "minIOPS": 60
          },
          "scsiEUIDeviceID": "6a79617900000005f47acc0100000000",
          "scsiNAADeviceID": "6f47acc1000000006a79617900000005",
          "sliceCount": 1,
          "status": "active",
          "totalSize": 1000341504,
          "virtualVolumeID": null,
          "volumeAccessGroups": [
              1
          ],
          "volumeID": 5,
          "volumePairs": []
      }
  }
}

Neu seit Version

9,6

Weitere Informationen

GetDefaultQoS

UmfyVolume

Creating your file...

Parameter

Rückgabewert

Anforderungsbeispiel

Antwortbeispiel

Neu seit Version

Weitere Informationen