Register or Update Support Software Details#

ソフトウェアサポート商品の詳細情報(インスタンスID、ソフトウェアID、サポートID)を新規登録、または登録済みのサポートIDを更新します。

なお、登録済みのサポートIDは内部で変更禁止期間が設定されています。変更禁止期間とは、サポート有り(spt_24h, spt_daytime)からサポート無し(nosupport)、限定サポート(spt_limited)へサポートIDが変更できない期間を示します。

本API実行時、サポートIDの変更可否の判断はその変更禁止期間を含む以下の3つの情報および処理式が用いられ、処理式の条件に当てはまる場合、つまりサポートIDが変更不可の場合は400 Bad Request、エラーメッセージに変更禁止期間の情報が返却されます。

  1. 本APIを実行した日付(UTC)
  2. 本APIを実行する前、つまりソフトウェアサポート商品の詳細情報を以前に登録したときの日付(UTC) (GET /v1.0/software_supportのレスポンス結果(UpdateDate)を示します)
  3. 変更禁止期間

処理式: (1) - (2) ≧ (3)

APIエンドポイント#

リージョン APIエンドポイント
西日本リージョン3の場合 https://software.jp-west-3.cloud.global.fujitsu.com
東日本リージョン3の場合 https://software.jp-east-3.cloud.global.fujitsu.com

HTTPメソッドとURI#

PUT

/v1.0/software_support

HTTPステータスコード#

正常時:200

エラー時:400,401,404,500

リクエストパラメータの説明#

名前 In Type デフォルト値
/必須指定
Description
X-Auth-Token header string 必須 認証のトークン
Content-Type header string 必須 「application/xml」を指定します。
SupportSoftwares body string 必須 全体のソフトウェアサポート商品の詳細情報(ルート要素)
SupportSoftware body string 必須 ソフトウェアサポート商品に紐付く詳細情報
InstanceID body string 必須 インスタンスID
SoftwareID body string 必須 ソフトウェアID
SoftwareIDに指定する値は、「SoftwareIDとSupportIDの値」を参照してください。
SupportID body string 必須 SupportIDに指定する値は、「SoftwareIDとSupportIDの値」を参照してください。 

SoftwareIDとSupportIDの値#

サポート変更を行う場合、SoftwareIDとSupportIDの値は以下を指定する必要があります。

SoftwareID SupportID 初期設定 補足
W2k8R2SE nosupport Windows Server 2008 SE R2 SP1 64bit 日本語版 (OS提供サービス/仮想サーバインポートサービス サポートなし)
W2k8R2EE nosupport Windows Server 2008 EE R2 SP1 64bit 日本語版 (OS提供サービス/仮想サーバインポートサービス サポートなし)
W2k12R2SE nosupport Windows Server 2012 SE R2 64bit 日本語版 (OS提供サービス/仮想サーバインポートサービス サポートなし)
spt_daytime Windows Server 2012 SE 64bit 日本語版 平日サポート(OS提供サービス/仮想サーバインポートサービス サポートあり)
spt_24h Windows Server 2012 SE R2 64bit 日本語版 24Hサポート(OS提供サービス/仮想サーバインポートサービス サポートあり)
W2k12SE nosupport Windows Server 2012 SE 64bit 日本語版 (OS提供サービス/仮想サーバインポートサービス サポートなし)
spt_daytime Windows Server 2012 SE 64bit 日本語版 平日サポート(OS提供サービス/仮想サーバインポートサービス サポートあり)
spt_24h Windows Server 2012 SE 64bit 日本語版 24Hサポート(OS提供サービス/仮想サーバインポートサービス サポートあり)
W2k16SE nosupport Windows Server 2016 SE 64bit 日本語版 (OS提供サービス サポートなし)
spt_daytime Windows Server 2016 SE 64bit 日本語版 平日サポート(OS提供サービス サポートあり)
spt_24h Windows Server 2016 SE 64bit 日本語版 24Hサポート(OS提供サービス サポートあり)
W2k19SE nosupport Windows Server 2019 SE 64bit 日本語版 (OS提供サービス サポートなし)
spt_daytime Windows Server 2019 SE 64bit 日本語版 平日サポート(OS提供サービス サポートあり)
spt_24h Windows Server 2019 SE 64bit 日本語版 24Hサポート(OS提供サービス サポートあり)
RHEL spt_daytime Red Hat Enterprise Linux x.x 64bit 英語版 平日サポート(OS提供サービス サポートあり)
※全バージョン/レベル共通
spt_24h Red Hat Enterprise Linux x.x 64bit 英語版 24Hサポート(OS提供サービス サポートあり)
※全バージョン/レベル共通
spt_limited Red Hat Enterprise Linux x.x 64bit 英語版 (OS提供サービス 限定サポート)
※全バージョン/レベル共通
spt_els_daytime Red Hat Enterprise Linux 6.x 64bit 英語版 ELS 平日サポート(OS提供サービス サポートあり) (*1)
spt_els_24h Red Hat Enterprise Linux 6.x 64bit 英語版 ELS 24Hサポート(OS提供サービス サポートあり) (*1)
RHEL spt_daytime Red Hat Enterprise Linux x.x 64bit 英語版 平日サポート(仮想サーバインポートサービス サポートあり)
※全バージョン/レベル共通
spt_24h Red Hat Enterprise Linux x.x 64bit 英語版 24Hサポート(仮想サーバインポートサービス サポートあり)
※全バージョン/レベル共通
MSSQL2K8SE nosupport SQL Server 2008 SE 64bit 日本語版(ソフトウェア提供サービスサポートなし)
MSSQL2K8R2SE nosupport SQL Server 2008 R2 SE 64bit 日本語版(ソフトウェア提供サービスサポートなし)
MSSQL2K14SE nosupport SQL Server 2014 SE 64bit 日本語版(ソフトウェア提供サービス サポートなし)
spt_daytime SQL Server 2014 SE 64bit 日本語版 平日サポート(ソフトウェア提供サービス サポートあり)
spt_24h SQL Server 2014 SE 64bit 日本語版 24Hサポート(ソフトウェア提供サービス サポートあり)
MSSQL2K14EE nosupport SQL Server 2014 EE 64bit 日本語版(ソフトウェア提供サービス サポートなし)
spt_24h SQL Server 2014 EE 64bit 日本語版 24Hサポート(ソフトウェア提供サービス サポートあり)
MSSQL2K16SE nosupport SQL Server 2016 SE 64bit 日本語版(ソフトウェア提供サービスサポートなし)
spt_daytime SQL Server 2016 SE 64bit 日本語版 平日サポート(ソフトウェア提供サービスサポートあり)
spt_24h SQL Server 2016 SE 64bit 日本語版 24Hサポート(ソフトウェア提供サービスサポートあり)
MSSQL2K19SE nosupport SQL Server 2019 SE 64bit 日本語版(ソフトウェア提供サービスサポートなし)
spt_daytime SQL Server 2019 SE 64bit 日本語版 平日サポート(ソフトウェア提供サービスサポートあり)
spt_24h SQL Server 2019 SE 64bit 日本語版 24Hサポート(ソフトウェア提供サービスサポートあり)

*1)RHEL 6 ELSサポート商品へのサポート切替えについて制限があります。詳細は、「RHEL 6 ELS サービスガイド」を参照してください。

レスポンスボディ(正常系)の説明#

名前 Type Description
Content-Type string オブジェクトのMIME typeの種類
SupportSoftwares string 全体のソフトウェアサポート商品の詳細情報(ルート要素)
SupportSoftware string 1ソフトウェアサポート商品に紐付く詳細情報
※タグが表示されない条件は以下のとおりです。
対象のSupportSoftware配下でソフトウェアのサポート情報がひとつも存在しない場合
TenantID string プロジェクトID
※SupportSoftwareタグが表示されない場合、本タグも表示されません。
RegionID string リージョンID
ソフトウェア商品の詳細情報の登録/更新が行われたリージョンIDが表示されます。
InstanceID string インスタンスID
ImageID string イメージID
インスタンスIDに紐付いているイメージIDが表示されます。
SoftwareID string ソフトウェアID
SupportID string サポートID
UpdateDate string 変更日
ソフトウェア商品の詳細情報の登録、またはサポート無し(nosupport)、限定サポート(spt_limited)からサポート有り(spt_24h, spt_daytime)へ変更したときの変更後の日付(UTC)が表示されます。

リクエスト例#

PUT
/v1.0/software_support
X-Auth-Token:MIIZuwYJKoZIhvcNAQc・・・(認証トークンIDは省略)
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>

レスポンス例#

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>