REST APIリファレンス

前へ次へ

sessionId。REST API呼び出しのヘッダーに含まれる、REST APIセッションID。セッションIDは、30分間の非アクティブ状態の後で期限切れになります。セッションIDの期限が切れた後に、再度ログインしてREST APIでの操作を続行します。

セッションステータスの詳細取得については、セッションIDを参照してください。

baseApiUrl。ログインを除くすべてのバージョン3のリソースURIで使用するベースURL。例えば、次のようになります。

<baseApiUrl>/public/core/v3/lookup

チームでは、開発用の組織とテスト用の組織など、複数の組織を使用している場合があります。ログインに使用するユーザー資格情報によって、アクセスする組織が決定されます。

POST要求

ログインするには、次のURLを使用します。

https://<cloud provider>-<region>.informaticacloud.com/saas/public/core/v3/login

クラウドプロバイダとリージョンの値は、組織が使用するPOD（デプロイメントのポイント）の名前に対応します。次の表に、POD名と、ログインURLで使用する、それに対応するクラウドプロバイダとリージョンを示します。

POD名	クラウドプロバイダ - リージョン
USW1	dm-us
USE2	dm-us
USW3	dm-us
USE4	dm-us
USW5	dm-us
USE6	dm-us
USW1-1	dm1-us
USW3-1	dm1-us
USW1-2	dm2-us
CAC1	dm-na
APSE1	dm-ap
APSE2	dm1-apse
APNE1	dm1-ap
APAUC1	dm1-apau
EMW1	dm-em
EMC1	dm1-em
UK1	dm-uk

例えば、組織でAPNE1 PODを使用している場合は、次のURLを使用します。

https://dm1-ap.informaticacloud.com/saas/public/core/v3/login

組織が使用しているPODの名前がわからない場合は、組織の管理者またはInformaticaグローバルカスタマサポートにお問い合わせください。

POD名、対応するクラウドプロバイダ、およびリージョンの詳細については、ナレッジベースの「Product Availability Matrix (PAM) for Informatica Intelligent Cloud Services」を参照してください。

ログインオブジェクトの次のフィールドを使用します。

フィールド	タイプ	必須	説明
username	String	○	ログインする組織の Informatica Intelligent Cloud Services のユーザー名。最大長は255文字です。
password	String	○	Informatica Intelligent Cloud Services のパスワード。最大長は255文字です。

POST応答

要求が正常に実行された場合はユーザー情報を返します。エラーが発生した場合にエラーオブジェクトを返します。

このセッション中は、後続の要求の応答で返されるベースURLとセッションIDを使用します。

正常に実行された要求は次のオブジェクトを返します。

フィールド	タイプ	説明
製品	コレクション	登録されたInformatica製品。
name	String	製品名。
baseApiUrl	String	製品オブジェクトに返されます。製品のBase API URL。REST API要求に使用します。
userInfo	コレクション	ユーザー情報。
sessionId	String	userInfoオブジェクトに返されます。現在のセッションのREST APIセッションID。最も正確なREST API要求ヘッダーに使用します。
id	String	userInfoオブジェクトに返されます。ユーザーID。
name	String	ユーザー名。
parentOrgId	String	親組織の組織ID。
orgId	String	userInfoオブジェクトに返されます。ユーザーが属する組織のID。 22文字。
orgName	String	userInfoオブジェクトに返されます。組織名。
groups	コレクション	ユーザーのユーザーグループ情報。
status	String	ユーザーのステータス。次のいずれかの値を返します。アクティブ非アクティブ

POSTの例

所属する

Informatica Intelligent Cloud Services

組織にログインするには、次の要求を使用できます。

POST https://dm-us.informaticacloud.com/saas/public/core/v3/login 
Content-Type: application/json
Accept: application/json

{
    "username": "user@informatica.com",
    "password": "mypassword"
}

正常に実行された場合、次の例に示すように、応答には、後続の呼び出しに使用するためにbaseApiUrlおよびsessionIdの値を含む製品とuserInfoオブジェクトが含まれます。

{
 	"products": [
 		{
 			"name": "Integration Cloud",
 			"baseApiUrl": "https://usw3.dm-us.informaticacloud.com/saas"
 		}
 	],
 	"userInfo": {
 		"sessionId": "9KA11tLGqxVcGeul8SQBK3",
 		"id": "9L1GFroXSDHe2IIg7QhBaT",
 		"name": "user",
 		"parentOrgId": "52ZSTB0IDK6dXxaEQLUaQu",
 		"orgId": "0cuQSDTq5sikvN7x8r1xm1",
 		"orgName": "MyOrg_INFA",
 		"groups": {},
 		"status": "Active"
 	}
}

例として上記の応答のセッションIDとベースURLの値を使用し、GET要求を送信してライセンス情報を取得するには、次の要求を使用します。

GET https://usw3.dm-us.informaticacloud.com/saas/public/core/v3/license/org/0cuQSDTq5sikvN7x8r1xm1
Content-Type: application/json
Accept: application/json
INFA-SESSION-ID: 9KA11tLGqxVcGeul8SQBK3

プラットフォームREST APIバージョン3リソース

ガイドをダウンロード

ページをウォッチ

フィードバックを送信

コミュニティ

Knowledge Base

Success Portal