This page describes the API impacts planned as part of the 3DS OUTSCALE offering refinements. These impacts consist in changes in the syntax and behavior of the APIs.

Week 32/33 of 2019

1. RunInstances (EC2-Compliant API)

If you request an Amazon type, the Amazon type is converted in the background to the equivalent TINA type associated with a performance flag, according to the VM Types and Corresponding TINA Types table. However, the type returned by the call remains an Amazon type. See examples 1 and 2.

If you request a TINA type:

  • You can use the tinavW.cXrYpZ format, where W is the processor generation, X the number of vCores, Y the amount of memory, and Z the performance flag (1 for "highest", 2 for "high", 3 for "medium"). See example 3.
  • You can use the tinavW.cXrY format (with no performance flag specified). In this case, the "high" performance flag is applied (instead of "highest" previously). See example 4.
  • It will no longer be possible to use the tina.cXrY format (with no processor generation specified). See example 5.

Some examples:


Type requestedType applied + performance flagType returned by RunInstances (and DescribeInstances)
Example 1c4.largetinav4.c2r4 + "highest"c4.large
Example 2m4.2xlargetinav4.c8r33 + "high"m4.2xlarge
Example 3tinav4.c2r4p1tinav4.c2r4 + "highest"tinav4.c2r4p1
Example 4tinav4.c2r4tinav4.c2r4 + "high"tinav4.c2r4p2
Example 5

tina.c2r4

(Error)(Error)


2. CreateVms (3DS OUTSCALE API)

The CreateVms method of the 3DS OUTSCALE API will contain a new optional parameter, "Performance", which can be set to "highest", "high" or "medium" (default value: "high").

If you request an Amazon type (see examples 1 and 2):

  • The Amazon type is converted in the background to the equivalent TINA type associated with a performance flag, according to the VM Types and Corresponding TINA Types table. However, the type returned by the call remains an Amazon type. See examples 1 and 2.
  • In this case, the "Performance" parameter is ignored in the request so as to take into account the correspondence table only.

If you request a TINA type:

  • You can use the tinavW.cXrY format, where W is the processor generation, X the number of vCores, Y the amount of memory. In this case, the "Performance" parameter is applied (value that you specify or default value). See examples 3 and 4.
  • You can use the tinavW.cXrYpZ format, where Z is the performance flag (1 for "highest", 2 for "high", 3 for "medium"). In this case, the "Performance" parameter is ignored. See examples 5 and 6.
  • It will no longer be possible to use the tina.cXrY format (with no processor generation specified). See example 7.

Some examples:


Type requested + "Performance" parameterType applied + performance flagType returned by CreateVms (and ReadVms) + "Performance" flag
Example 1c4.large + (not specified)tinav4.c2r4 + "highest"c4.large + "highest"
Example 2c4.large + "medium"tinav4.c2r4 + "highest"

c4.large + "highest"

Example 3tinav4.c2r2 + (not specified)tinav4.c2r2 + "high"tinav4.c2r2 + "high"
Example 4tinav4.c2r2 + "highest"tinav4.c2r2 + "highest"tinav4.c2r2 + "highest"
Example 5tinav4.c2r4p1 + (not specified)tinav4.c2r4 + "highest"tinav4.c2r4 + "highest"
Example 6tinav4.c2r4p1 + "medium" tinav4.c2r4 + "highest" tinav4.c2r4 + "highest"
Example 7tina.c2r4(Error)(Error)


3. StartInstances (EC2-compliant API) or StartVms (3DS OUTSCALE API)

When StartInstances or StartVms is called on an Amazon-type VM, the Amazon type is converted to the equivalent TINA type according to the same rules as RunInstances. See example 1.

When StartInstances or StartVms is called on a TINA-type VM (see examples 2 and 3):

  • If the type contains no processor generation, the processor generation 5 is added.
  • If the type contains no performance flag, the "high" performance flag is added.

Some examples:


Type of the VM in the "stopped" stateType applied + performance flag after StartInstances or StartVms
Example 1c4.4xlarge

tinav4.c16r31 + "highest"

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

4. ModifyInstanceAttribute (EC2-compliant API) or UpdateVm (3DS OUTSCALE API)

When ModifyInstanceAttribute is called to convert the VM type to an Amazon type, the same rules as RunInstances are applied to convert the requested type to the equivalent TINA type.

Likewise, when UpdateVm is called, the same rules as CreateVm are applied on the VmType and Performance parameters.