Show Support Software Details#

すべてのソフトウェアサポート商品の詳細情報を取得します。

📒注: 仮想サーバ作成後、ソフトウェアサポート商品の詳細情報を取得できるようになるまでに最大1時間かかります。ソフトウェアサポート商品の詳細情報を取得できない場合は、時間をおいて再実行してください。

APIエンドポイント#

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

HTTPメソッドとURI#

GET

/v1.0/software_support

HTTPステータスコード#

正常時:200

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

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

名前 In Type デフォルト値
/必須指定
Description
X-Auth-Token header string 必須 認証のトークン
TenantID query string 任意 プロジェクトID
なお、ユーザーが表示可能なプロジェクトIDはユーザーが属するプロジェクトID(認証トークンに含まれるプロジェクトID)です。そのため、ユーザーが属さないプロジェクトIDを指定した場合はエラーが返却されます。
省略した場合は、ユーザーが属するプロジェクトIDが対象です。
InstanceID query string 任意 インスタンスID
省略した場合は、すべてのインスタンスIDが対象です。
SoftwareID query string 任意 ソフトウェアID
省略した場合は、すべてのSoftwareIDが対象です。
なお、SoftwareIDはInstanceIDが指定された場合に必要となるため、InstanceID省略、かつSoftwareID指定の場合、リクエスト異常のエラーになります。
SupportID query string 任意 サポートID
省略した場合はすべてのSupportIDが対象です。
なお、SupportIDはSoftwareIDが指定された場合に必要となるため、SoftwareID省略、かつSupportID指定の場合、リクエスト異常のエラーになります。

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

名前 Type Description
Content-Type string オブジェクトのMIME typeの種類
SupportSoftwares string 全体のソフトウェアサポート商品の詳細情報を示します(ルート要素)
SupportSoftware string 1ソフトウェアサポート商品に紐付く詳細情報を示します。
※タグが表示されない条件は以下のとおりです。
対象のSupportSoftware配下でソフトウェアのサポート情報がひとつも存在しない場合
TenantID string プロジェクトID
※SupportSoftwareタグが表示されない場合、本タグも表示されません。
InstanceID string インスタンスID
※SupportSoftwareタグが表示されない場合、本タグも表示されません。
ImageID string イメージID
※SupportSoftwareタグが表示されない場合、本タグも表示されません。
SoftwareID string ソフトウェアID
※SupportSoftwareタグが表示されない場合、本タグも表示されません。
SupportID string サポートID
※SupportSoftwareタグが表示されない場合、本タグも表示されません。
UpdateDate string 変更日
※SupportSoftwareタグが表示されない場合、本タグも表示されません。

リクエスト例#

GET
/v1.0/software_support?TenantID=tenant1&InstanceID=instance1
X-Auth-Token:MIIZuwYJKoZIhvcNAQc・・・(認証トークンIDは省略)

レスポンス例#

ソフトウェアのサポート情報が存在する場合

HTTP/1.1 200 OK
Date: Sun,31 Aug 2014 00:00:00 GMT
Content-Length: 5000
Content-Type: application/xml

<?xml version="1.0" encoding="UTF-8"?>
<SupportSoftwares>
 <SupportSoftware>
   <TenantID>tenant1</TenantID>
   <InstanceID>instance1</InstanceID>
   <ImageID>image1</ImageID>
   <SoftwareID>RHEL</SoftwareID>
<SupportID>nosupport</SupportID>
   <UpdateDate>2014.8.31</UpdateDate>
 </SupportSoftware>
<SupportSoftware>
   <TenantID>tenant1</TenantID>
   <InstanceID>instance1</InstanceID>
   <ImageID>RHEL</ImageID>
   <SoftwareID>sq2012</SoftwareID>
<SupportID>spt_24h</SupportID>
   <UpdateDate>2014.8.31</UpdateDate>
 </SupportSoftware>
<SupportSoftware>
   <TenantID>tenant1</TenantID>
   <InstanceID>instance1</InstanceID>
   <ImageID>RHEL</ImageID>
   <SoftwareID>sq2012</SoftwareID>
<SupportID>spt_daytime</SupportID>
   <UpdateDate>2014.8.31</UpdateDate>
 </SupportSoftware>
</SupportSoftwares>

ソフトウェアのサポート情報がひとつも存在しない場合

HTTP/1.1 200 OK
Date: Sun,31 Aug 2014 00:00:00 GMT
Content-Length: 5000
Content-Type: application/xml

<?xml version="1.0" encoding="UTF-8"?>
<SupportSoftwares/>