Show Support Software Details#

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

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/>