目次

Search

  1. はじめに
  2. Informatica Intelligent Cloud Services REST API
  3. プラットフォームREST APIバージョン2リソース
  4. プラットフォームREST APIバージョン3リソース
  5. データ統合 REST API
  6. 一括取り込みファイルREST API
  7. 一括取り込みストリーミングREST API
  8. Model Serve REST API
  9. RunAJobユーティリティ
  10. ParamSetCliユーティリティ
  11. REST APIコード
  12. REST APIリソースクイックリファレンス

REST APIリファレンス

REST APIリファレンス

セッションID

セッションID

REST APIを使用して
Informatica Intelligent Cloud Services
組織にログインすると、loginリソースはREST APIセッションIDを返します。このセッションIDは、セッション中、後続のほとんどのREST API要求に含めます。セッションIDは、30分間の非アクティブ状態の後で期限切れになります。ネットワークまたは予期しない遅延を考慮して、最大2分間の猶予期間が含まれる場合があります。
バージョン2とバージョン3のリソースには同じセッションIDを使用できます。例えば、バージョン2のloginリソースを使用してログインする場合、バージョン3リソースを使用する要求のログイン応答で返されたセッションIDを使用できます。
REST APIバージョン2リソースを使用する呼び出しを行うには、icSessionId属性を使用してヘッダーにセッションIDを含めます。REST APIバージョン3リソースを使用する呼び出しを行うには、INFA-SESSION-ID属性を使用してヘッダーにセッションIDを含めます。
次の例は、REST APIバージョン2呼び出しのヘッダーにicSessionIdを使用する方法を示しています。
GET https://app.informaticacloud.com/saas/api/v2/licenseInfo/org/<id> Content-Type: application/xml Accept: application/xml icSessionId: IV4wOrJmd6YUtmKa8t
次の例は、REST APIバージョン3呼び出しのヘッダーにINFA-SESSION-IDを使用する方法を示しています。
GET https://app.informaticacloud.com/saas/public/core/v3/license/org/{orgId} Content-Type: application/json Accept: application/json INFA-SESSION-ID: 9KA11tLGqxVcGeul8SQBK3
POST要求を送信すると、セッションIDのステータスを確認できます。次のURIを使用して要求を送信します。
/api/v2/user/validSessionId
要求に次の属性を含めます。
  • userName。
    Informatica Intelligent Cloud Services
    ユーザー名。
  • icToken。セッションID。
例えば、次の要求を使用できます。
POST https://app.informaticacloud.com/saas/api/v2/user/validSessionId Content-Type: application/json Accept: application/json { "@type": "validatedToken", "userName": "user@informatica.com", "icToken": "9KA11tLGqxVcGeul8SQBK3" }
応答では、セッションIDが有効かどうかと、セッションIDの有効期限までの時間(分単位)が返されます。例えば、次の応答を受信します。
{ "@type": "validatedToken", "timeUntilExpire": 29, "isValidToken": true }
セッションが1分未満で期限切れになると、timeUntilExpire値は「0」に変わります。セッションの有効期限が切れると、isValidTokenの値が「false」に変わります。認証失敗のリスクを回避するには、timeUntilExpire値が0に変わったときに再認証してください。