3DS OUTSCALE Offering Refinements (API Behavior)

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 Instance 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 requested Type applied + performance flag Type returned by RunInstances (and DescribeInstances)

Example 1

c4.large

tinav4.c2r4 + "highest"

c4.large

Example 2

m4.2xlarge

tinav4.c8r33 + "high"

m4.2xlarge

Example 3

tinav4.c2r4p1

tinav4.c2r4 + "highest"

tinav4.c2r4p1

Example 4

tinav4.c2r4

tinav4.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 Instance 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" parameter Type applied + performance flag Type returned by CreateVms (and ReadVms) + "Performance" flag

Example 1

c4.large + (not specified)

tinav4.c2r4 + "highest"

c4.large + "highest"

Example 2

c4.large + "medium"

tinav4.c2r4 + "highest"

c4.large + "highest"

Example 3

tinav4.c2r2 + (not specified)

tinav4.c2r2 + "high"

tinav4.c2r2 + "high"

Example 4

tinav4.c2r2 + "highest"

tinav4.c2r2 + "highest"

tinav4.c2r2 + "highest"

Example 5

tinav4.c2r4p1 + (not specified)

tinav4.c2r4 + "highest"

tinav4.c2r4 + "highest"

Example 6

tinav4.c2r4p1 + "medium"

tinav4.c2r4 + "highest"

tinav4.c2r4 + "highest"

Example 7

tina.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" state Type applied + performance flag after StartInstances or StartVms

Example 1

c4.4xlarge

tinav4.c16r31 + "highest"

Example 2

tina.c2r4

tinav5.c2r4 + "high"

Example 3

tinav4.c4r8

tinav4.c4r8 + "high"

4. ModifyInstanceAttribute (EC2-compliant API) or UpdateVm (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.