Cette page décrit les impacts API prévus dans le cadre de l'évolution de l'offre 3DS OUTSCALE. Ces impacts consistent en des changements dans la syntaxe et le comportement des API.

Semaine 32/33 de 2019

1. RunInstances (API compatible EC2)

Si vous demandez un type Amazon, le type Amazon est converti en arrière-plan en type TINA équivalent associé à un indicateur de performance, suivant le tableau de Correspondances entre types de VM. Néanmoins, le type renvoyé par l'appel reste le type Amazon. Voir exemples 1 et 2.

Si vous demandez un type TINA :

  • Vous pouvez utiliser le format tinavW.cXrYpZ, où W est la génération de processeur, X le nombre de vCores, Y la quantité de mémoire, et Z l'indicateur de performance (1 pour "highest", 2 pour "high", 3 pour "medium"). Voir exemple 3.
  • Vous pouvez utiliser le format tinavW.cXrY (sans précision de l'indicateur de performance). Dans ce cas, l'indicateur de performance "high" est appliqué (au lieu de "highest" auparavant). Voir exemple 4.
  • Il ne sera plus possible d'utiliser le format tina.cXrY (sans précision de la génération de processeur). Voir exemple 5.

Quelques exemples :


Type demandéType appliqué + indicateur de performanceType renvoyé par RunInstances (et DescribeInstances)
Exemple 1c4.largetinav4.c2r4 + "highest"c4.large
Exemple 2m4.2xlargetinav4.c8r33 + "high"m4.2xlarge
Exemple 3tinav4.c2r4p1tinav4.c2r4 + "highest"tinav4.c2r4p1
Exemple 4tinav4.c2r4tinav4.c2r4 + "high"tinav4.c2r4p2
Exemple 5

tina.c2r4

(Erreur)(Erreur)


2. CreateVms (API 3DS OUTSCALE)

La méthode CreateVms de l'API 3DS OUTSCALE comportera un nouveau paramètre optionnel "Performance" pouvant être défini sur "highest", "high" ou "medium" (valeur par défaut : "high").

Si vous demandez un type Amazon (voir exemples 1 et 2) :

  • Le type Amazon est converti en arrière-plan en type TINA équivalent associé à un indicateur de performance, suivant le tableau de Correspondances entre types de VM. Néanmoins, le type renvoyé par l'appel reste le type Amazon. Voir exemples 1 et 2.
  • Dans ce cas, le paramètre "Performance" est ignoré dans la requête pour ne prendre en compte que le tableau de correspondance.

Si vous demandez un type TINA :

  • Vous pouvez utiliser le format tinavW.cXrY, où W est la génération de processeur, X le nombre de vCores, et Y la quantité de mémoire. Dans ce cas, le paramètre "Performance" est appliqué (valeur que vous spécifiez ou valeur par défaut). Voir exemples 3 et 4.
  • Vous pouvez utiliser le format tinavW.cXrYpZ, où Z est l'indicateur de performance (1 pour "highest", 2 pour "high", 3 pour "medium"). Dans ce cas, le paramètre "Performance" est ignoré. Voir exemples 5 et 6.
  • Il ne sera plus possible d'utiliser le format tina.cXrY (sans précision de la génération de processeur). Voir exemple 7.

Quelques exemples :


Type demandé + paramètre "Performance"Type appliqué + indicateur de performanceType renvoyé par CreateVms (et ReadVms) + paramètre "Performance"
Exemple 1c4.large + (non spécifié)tinav4.c2r4 + "highest"c4.large + "highest"
Exemple 2c4.large + "medium"tinav4.c2r4 + "highest"

c4.large + "highest"

Exemple 3tinav4.c2r2 + (non spécifié)tinav4.c2r2 + "high"tinav4.c2r2 + "high"
Exemple 4tinav4.c2r2 + "highest"tinav4.c2r2 + "highest"tinav4.c2r2 + "highest"
Exemple 5tinav4.c2r4p1 + (non spécifié)tinav4.c2r4 + "highest"tinav4.c2r4 + "highest"
Exemple 6tinav4.c2r4p1 + "medium" tinav4.c2r4 + "highest" tinav4.c2r4 + "highest"
Exemple 7tina.c2r4(Erreur)(Erreur)


3. StartInstances (API compatible EC2) ou StartVms (API 3DS OUTSCALE)

Lorsque StartInstances ou StartVms est appelé sur une VM de type Amazon, le type Amazon est converti en type TINA équivalent suivant les mêmes règles que RunInstances. Voir exemple 1.

Lorsque StartInstances ou StartVms est appelé sur une VM de type TINA (voir exemples 2 et 3) :

  • Si le type ne comporte pas de génération de processeur, la génération de processeur 5 est ajoutée.
  • Si le type ne comporte pas d'indicateur de performance, l'indicateur de performance "high" est ajouté.

Quelques exemples :


Type de la VM à l'état "stopped"Type appliqué + indicateur de performance après StartInstances ou StartVms
Exemple 1c4.4xlarge

tinav4.c16r31 + "highest"

Exemple 2tina.c2r4tinav5.c2r4 + "high"
Exemple 3tinav4.c4r8tinav4.c4r8 + "high"

4. ModifyInstanceAttribute (API compatible EC2) ou UpdateVm (API 3DS OUTSCALE)

Lorsque ModifyInstanceAttribute est appelé pour changer le type de VM vers un type Amazon, les mêmes règles que RunInstances sont appliquées pour convertir le type demandé en type TINA équivalent.

De même lorsque UpdateVm est appelé, les mêmes règles que CreateVm sont appliquées sur les paramètres VmType et Performance