Register/update details on supported software (PUT /v1.0/software_support)

Registers details (instance ID, software ID, support ID) on a supported software, or updates a support ID that has already been registered.

A change prohibition period has been set internally for registered support IDs. This refers to the period during which it is not possible to change a support ID from supported (spt_24h, spt_daytime) to not supported (nosupport) or limited support (spt_limited).

This API determines whether changes to the support ID are allowed, based on the items below. If support ID cannot currently be changed, the 400 Bad Request error message will be returned.
  1. Datetime (UTC) of execution of this API
  2. Datetime (UTC) of the software registration (this information is returned by GET /v1.0/software_support in the UpdateDate field)
  3. Change prohibition period
Formula: (1) - (2) >= (3)

Request headers

X-Auth-Token

Specify the authentication token.

Data type Cardinality
String 1..1

Content-Type

Specify "Application/xml".

Data type Cardinality
String 1..1

Request elements

SupportSoftwares

Details on all supported software (root element)

Data type Cardinality Parent element Child element
String 1..1 None SupportSoftware

SupportSoftware

Details on a retrieved supported software

Data type Cardinality Parent element Child element
String 1..n SupportSoftwares InstanceID

SoftwareID

SupportID

InstanceID

Instance ID

Data type Cardinality Parent element Child element
String 1..1 SupportSoftware None

SoftwareID

Software ID

Refer to the "SoftwareID and SupportID values" table below for details on the valid values.

Data type Cardinality Parent element Child element
String 1..1 SupportSoftware None

SupportID

Support ID

Refer to the "SoftwareID and SupportID values" table below for details on the valid values.

Data type Cardinality Parent element Child element
String 1..1 String 1..1

When changing support, it is necessary to specify the following values for SoftwareID and SupportID.

Table 1. SoftwareID and SupportID values
SoftwareID SupportID Initial setting Remarks
W2k8R2SE nosupport B Windows Server 2008 SE R2 SP1 64-bit Japanese version (no support for OS delivery service/virtual server import service)
spt_daytime   Windows Server 2008 SE R2 SP1 64-bit Japanese version daytime support (support for OS delivery service/virtual server import service)
spt_24h   Windows Server 2008 SE R2 SP1 64-bit Japanese version 24-hour support (support for OS delivery service/virtual server import service)
W2k8R2EE nosupport B Windows Server 2008 EE R2 SP1 64-bit Japanese version (no support for OS delivery service/virtual server import service)
spt_daytime   Windows Server 2008 EE R2 SP1 64-bit Japanese version daytime support (support for OS delivery service/virtual server import service)
spt_24h   Windows Server 2008 EE R2 SP1 64-bit Japanese version 24-hour support (support for OS delivery service/virtual server import service)
W2k12R2SE nosupport B Windows Server 2012 SE R2 64-bit Japanese version (no support for OS delivery service/virtual server import service)
spt_daytime   Windows Server 2012 SE 64-bit Japanese version daytime support (support for OS delivery service/virtual server import service)
spt_24h   Windows Server 2012 SE R2 64-bit Japanese version 24-hour support (support for OS delivery service/virtual server import service)
W2k12SE nosupport B Windows Server 2012 SE 64-bit Japanese version (no support for OS delivery service/virtual server import service)
spt_daytime   Windows Server 2012 SE 64-bit Japanese version daytime support (support for OS delivery service/virtual server import service)
spt_24h   Windows Server 2012 SE 64-bit Japanese version 24-hour support (support for OS delivery service/virtual server import service)
W2k16SE nosupport B Windows Server 2016 SE 64-bit Japanese version (no support for OS delivery service)
spt_daytime   Windows Server 2016 SE 64-bit Japanese version daytime support (support for OS delivery service)
spt_24h   Windows Server 2016 SE 64-bit Japanese version 24-hour support (support for OS delivery service)
RHEL spt_daytime   Red Hat Enterprise Linux x.x 64-bit English version daytime support (support for OS delivery service) *Common to all versions and levels
spt_24h   Red Hat Enterprise Linux x.x 64-bit English version 24-hour support (support for OS delivery service) *Common to all versions and levels
spt_limited B Red Hat Enterprise Linux x.x 64-bit English version (support limited to OS delivery service) *Common to all versions and levels
RHEL spt_daytime B Red Hat Enterprise Linux x.x 64-bit English version daytime support (support for virtual server import service) *Common to all versions and levels
spt_24h   Red Hat Enterprise Linux x.x 64-bit English version 24-hour support (support for virtual server import service) *Common to all versions and levels
MSSQL2K8SE nosupport B SQL Server 2008 SE 64-bit Japanese version (no support for software delivery service)
spt_daytime   SQL Server 2008 SE 64-bit Japanese version daytime support (support for software delivery service)
spt_24h   SQL Server 2008 SE 64-bit Japanese version 24-hour support (support for software delivery service)
MSSQL2K8R2SE nosupport B SQL Server 2008 R2 SE 64-bit Japanese version (no support for software delivery service)
spt_daytime   SQL Server 2008 R2 SE 64-bit Japanese version daytime support (support for software delivery service)
spt_24h   SQL Server 2008 R2 SE 64-bit Japanese version 24-hour support (support for software delivery service)
MSSQL2K14SE nosupport B SQL Server 2014 SE 64-bit Japanese version (no support for software delivery service)
spt_daytime   SQL Server 2014 SE 64-bit Japanese version daytime support (support for software delivery service)
spt_24h   SQL Server 2014 SE 64-bit Japanese version 24-hour support (support for software delivery service)
MSSQL2K14EE nosupport B SQL Server 2014 EE 64-bit Japanese version (no support for software delivery service)
spt_24h   SQL Server 2014 EE 64-bit Japanese version 24-hour support (support for software delivery service)

MSSQL2K16SE

nosupport

B SQL Server 2016 SE 64-bit Japanese version (no support for software delivery service)

spt_daytime

  SQL Server 2016 SE 64-bit Japanese version daytime support (support for software delivery service)

spt_24h

  SQL Server 2016 SE 64-bit Japanese version 24-hour support (support for software delivery service)

Request parameters

None

Response headers

Content-Type

Returns "Application/xml".

Data type Cardinality
String 1..1

Response elements

SupportSoftwares

Details on all supported software (root element)

Data type Cardinality Parent element Child element
String 1..1 None SupportSoftware

SupportSoftware

Details on a retrieved supported software

Data type Cardinality Parent element Child element
String 1..n SupportSoftwares TenantID

RegionID

InstanceID

Image ID

SoftwareID

SupportID

UpdateDate

TenantID

Project ID

The project ID to which the user belongs.

Data type Cardinality Parent element Child element
String 1..1 SupportSoftware None

RegionID

Region ID

The region ID for which details on the software was registered/updated.

Data type Cardinality Parent element Child element
String 1..1 SupportSoftware None

InstanceID

Instance ID

Data type Cardinality Parent element Child element
String 1..1 SupportSoftware None

Image ID

Image ID

The image ID linked to the instance ID.

Data type Cardinality Parent element Child element
String 1..1 SupportSoftware None

SoftwareID

Software ID

Data type Cardinality Parent element Child element
String 1..1 SupportSoftware None

SupportID

Support ID

Data type Cardinality Parent element Child element
String 1..1 SupportSoftware None

UpdateDate

Update date

The datetime (UTC) of registration of details on the software or of the change from not supported (nosupport) or limited support (spt_limited) to supported (spt_24h, spt_daytime).

Data type Cardinality Parent element Child element
String 1..1 SupportSoftware None

Example of request


PUT
/v1.0/software_support
X-Auth-Token:MIIZuwYJKoZIhvcNAQc . . .
Content-Type: application/xml

<SupportSoftwares>
 <SupportSoftware>
   <InstanceID>instance1</InstanceID>
   <SoftwareID>ws2012</SoftwareID>
   <SupportID>nosupport</SupportID>
 </SupportSoftware>
<SupportSoftware>
   <InstanceID>instance1</InstanceID>
   <SoftwareID>sq2012</SoftwareID>
   <SupportID>spt_24h</SupportID>
 </SupportSoftware>
</SupportSoftwares>
     

Example of response


HTTP/1.1 200 OK
Date: Fri, 11 Sep 2015 05:27:35 GMT
Content-Length: 5000
Content-Type: application/xml

<?xml version="1.0" encoding="UTF-8"?>
<SupportSoftwares>
 <SupportSoftware>
   <TenantID>tenant1</TenantID>
   <RegionID>jp-east-1</RegionID>
   <InstanceID>instance1</InstanceID>
   <ImageID>image1</ImageID>
   <SoftwareID>ws2012</SoftwareID>
<SupportID>nosupport</SupportID>
   <UpdateDate>2015-09-11</UpdateDate>
 </SupportSoftware>
<SupportSoftware>
   <TenantID>tenant1</TenantID>
   <RegionID>jp-east-1</RegionID>
   <InstanceID>instance1</InstanceID>
   <ImageID>image1</ImageID>
   <SoftwareID>sq2012</SoftwareID>
<SupportID>spt_24h</SupportID>
   <UpdateDate>2015-09-11</UpdateDate>
 </SupportSoftware>
</SupportSoftwares>