La version française est une traduction automatique. La version anglaise prévaut sur la française en cas de divergence.

CreateVolume

10/01/2024 Contributeurs

Vous pouvez utiliser CreateVolume la méthode pour créer un nouveau volume vide sur le cluster. Dès que le volume est créé, la connexion du volume est disponible via iSCSI.

Les volumes créés sans valeurs QoS spécifiées utilisent les valeurs par défaut. Vous pouvez afficher les valeurs par défaut d'un volume à l'aide de la GetDefaultQoS méthode.

Paramètres

Cette méthode présente les paramètres d'entrée suivants :

Nom Description Type Valeur par défaut Obligatoire

Nom	Description	Type	Valeur par défaut	Obligatoire
`access`	Mode d'accès du volume. Si ce paramètre est inclus, la seule valeur prise en charge est `snapMirrorTarget`.	chaîne	Aucune	Non
`accountID`	L'ID du compte qui détient ce volume.	entier	Aucune	Oui
`associateWithQoSPolicy`	Associez le volume à la règle de QoS spécifiée. Valeurs possibles : `true`: Associez le volume à la politique QoS spécifiée dans le paramètre QoSPolicyID. `false`: N'associez pas le volume à la politique QoS spécifiée dans le paramètre QoSPolicyID. Lorsque la valeur est FALSE, toute association de règles existante est supprimée, que vous spécifiiez ou non une stratégie QoS dans le paramètre QoSPolicy.	booléen	vrai	Non
`attributes`	Liste des paires nom-valeur au format d'objet JSON. La taille totale de l'attribut doit être inférieure à 1 000 B ou 1 Ko, avec les caractères de formatage JSON.	Objet JSON	Aucune	Non
`enable512e`	Activer l'émulation de secteur à 512 octets. Valeurs possibles : `true`: Le volume fournit une émulation de secteur de 512 octets. `false`: l'émulation 512e n'est pas activée.	booléen	Aucune	Oui
`enableSnapMirrorReplication`	Détermine si le volume peut être utilisé pour la réplication avec les terminaux SnapMirror. Valeurs possibles : `true` `false`	booléen	faux	Non
`fifoSize`	Spécifie le nombre maximal de snapshots de premier entré en premier sorti (FIFO) pris en charge par le volume. Notez que les instantanés FIFO et non FIFO utilisent tous les deux le même pool d'emplacements de snapshot disponibles sur un volume. Utilisez cette option pour limiter la consommation de snapshot FIFO des emplacements de snapshot disponibles. Si elle est omise, la valeur par défaut est 24.	entier	24	Non
`minFifoSize`	Spécifie le nombre minimum de logements de snapshot de premier entré, premier sorti (FIFO) réservés par le volume. Cela garantit que si vous utilisez à la fois des instantanés FIFO et des instantanés non FIFO sur un volume que les instantanés non FIFO ne consomment pas de trop nombreux emplacements FIFO par inadvertance. Il garantit également qu'au moins ces nombreux instantanés FIFO sont toujours disponibles. Étant donné que les snapshots FIFO et non FIFO partagent le même pool, le système réduit le `minFifoSize` nombre total de snapshots non FIFO possibles de la même quantité. Si elle est omise, la valeur par défaut est 0.	entier	0	Non
`name`	Nom du groupe d'accès au volume (peut être spécifié par l'utilisateur). Non obligatoire pour être unique, mais recommandé. Doit comporter entre 1 et 64 caractères.	chaîne	Aucune	Oui
`qos`	La qualité initiale des paramètres de service pour ce volume. Les valeurs par défaut sont utilisées si aucune n'est spécifiée. Valeurs possibles : `minIOPS` `maxIOPS` `burstIOPS`	Objet QoS	Aucune	Non
`qosPolicyID`	ID de la politique dont les paramètres QoS doivent être appliqués aux volumes spécifiés Ce paramètre s'excluent mutuellement avec le `qos` paramètre.	entier	Aucune	Non
`totalSize`	Taille totale du volume, en octets. La taille est arrondie au mégaoctet le plus proche.	entier	Aucune	Oui

access

Mode d'accès du volume. Si ce paramètre est inclus, la seule valeur prise en charge est snapMirrorTarget.

chaîne

Aucune

Non

accountID

L'ID du compte qui détient ce volume.

entier

Aucune

Oui

associateWithQoSPolicy

Associez le volume à la règle de QoS spécifiée. Valeurs possibles :

true: Associez le volume à la politique QoS spécifiée dans le paramètre QoSPolicyID.
false: N'associez pas le volume à la politique QoS spécifiée dans le paramètre QoSPolicyID. Lorsque la valeur est FALSE, toute association de règles existante est supprimée, que vous spécifiiez ou non une stratégie QoS dans le paramètre QoSPolicy.

booléen

vrai

Non

attributes

Liste des paires nom-valeur au format d'objet JSON. La taille totale de l'attribut doit être inférieure à 1 000 B ou 1 Ko, avec les caractères de formatage JSON.

Objet JSON

Aucune

Non

enable512e

Activer l'émulation de secteur à 512 octets. Valeurs possibles :

true: Le volume fournit une émulation de secteur de 512 octets.
false: l'émulation 512e n'est pas activée.

booléen

Aucune

Oui

enableSnapMirrorReplication

Détermine si le volume peut être utilisé pour la réplication avec les terminaux SnapMirror. Valeurs possibles :

true
false

booléen

faux

Non

fifoSize

Spécifie le nombre maximal de snapshots de premier entré en premier sorti (FIFO) pris en charge par le volume. Notez que les instantanés FIFO et non FIFO utilisent tous les deux le même pool d'emplacements de snapshot disponibles sur un volume. Utilisez cette option pour limiter la consommation de snapshot FIFO des emplacements de snapshot disponibles. Si elle est omise, la valeur par défaut est 24.

entier

Non

minFifoSize

Spécifie le nombre minimum de logements de snapshot de premier entré, premier sorti (FIFO) réservés par le volume. Cela garantit que si vous utilisez à la fois des instantanés FIFO et des instantanés non FIFO sur un volume que les instantanés non FIFO ne consomment pas de trop nombreux emplacements FIFO par inadvertance. Il garantit également qu'au moins ces nombreux instantanés FIFO sont toujours disponibles. Étant donné que les snapshots FIFO et non FIFO partagent le même pool, le système réduit le minFifoSize nombre total de snapshots non FIFO possibles de la même quantité. Si elle est omise, la valeur par défaut est 0.

entier

Non

name

Nom du groupe d'accès au volume (peut être spécifié par l'utilisateur). Non obligatoire pour être unique, mais recommandé. Doit comporter entre 1 et 64 caractères.

chaîne

Aucune

Oui

qos

La qualité initiale des paramètres de service pour ce volume. Les valeurs par défaut sont utilisées si aucune n'est spécifiée. Valeurs possibles :

minIOPS
maxIOPS
burstIOPS

Objet QoS

Aucune

Non

qosPolicyID

ID de la politique dont les paramètres QoS doivent être appliqués aux volumes spécifiés Ce paramètre s'excluent mutuellement avec le qos paramètre.

entier

Aucune

Non

totalSize

Taille totale du volume, en octets. La taille est arrondie au mégaoctet le plus proche.

entier

Aucune

Oui

Valeurs de retour

Cette méthode a les valeurs de retour suivantes :

Nom

Description

Type

volumétrie

Objet contenant des informations relatives au nouveau volume.

volumétrie

ID de volume

ID « Volume » du volume récemment créé.

entier

d'adoption

La courbe est un ensemble de paires clé-valeur. Les clés sont les tailles d'E/S en octets. Les valeurs représentent le coût d'exécution d'une IOPS à une taille d'E/S spécifique. La courbe est calculée par rapport à une opération de 4096 octets définie à 100 IOPS.

Objet JSON

Exemple de demande

Les demandes pour cette méthode sont similaires à l'exemple suivant :

{
   "method": "CreateVolume",
   "params": {
      "name": "mysqldata",
      "accountID": 1,
      "totalSize": 107374182400,
      "enable512e": false,
      "attributes": {
         "name1": "value1",
         "name2": "value2",
         "name3": "value3"
      },
      "qos": {
         "minIOPS": 50,
         "maxIOPS": 500,
         "burstIOPS": 1500,
         "burstTime": 60
      }
   },
   "id": 1
}

Exemple de réponse

Cette méthode renvoie une réponse similaire à l'exemple suivant :

{
    "id": 1,
    "result": {
        "curve": {
            "4096": 100,
            "8192": 160,
            "16384": 270,
            "32768": 500,
            "65536": 1000,
            "131072": 1950,
            "262144": 3900,
            "524288": 7600,
            "1048576": 15000
        },
        "volume": {
            "access": "readWrite",
            "accountID": 1,
            "attributes": {
                "name1": "value1",
                "name2": "value2",
                "name3": "value3"
            },
            "blockSize": 4096,
            "createTime": "2016-03-31T22:20:22Z",
            "deleteTime": "",
            "enable512e": false,
            "iqn": "iqn.2010-01.com.solidfire:mysqldata.677",
            "name": "mysqldata",
            "purgeTime": "",
            "qos": {
                "burstIOPS": 1500,
                "burstTime": 60,
                "curve": {
                    "4096": 100,
                    "8192": 160,
                    "16384": 270,
                    "32768": 500,
                    "65536": 1000,
                    "131072": 1950,
                    "262144": 3900,
                    "524288": 7600,
                    "1048576": 15000
                },
                "maxIOPS": 500,
                "minIOPS": 50
            },
            "scsiEUIDeviceID": "6a796179000002a5f47acc0100000000",
            "scsiNAADeviceID": "6f47acc1000000006a796179000002a5",
            "sliceCount": 0,
            "status": "active",
            "totalSize": 107374182400,
            "virtualVolumeID": null,
            "volumeAccessGroups": [],
            "volumeID": 677,
            "volumePairs": []
        },
        "volumeID": 677
    }
}

Nouveau depuis la version

9,6

Trouvez plus d'informations

GetDefaultQoS

CreateVolume

Creating your file...

Paramètres

Valeurs de retour

Exemple de demande

Exemple de réponse

Nouveau depuis la version

Trouvez plus d'informations