REST APIリファレンス

前へ次へ

loginSf

このリソースを使用して、Salesforce資格証明を使用して

Informatica Intelligent Cloud Services

組織にログインします。

ログイン応答には、後続のREST API呼び出しに含める必要のあるセッションIDとベースURLを含めます。

loginSfリソースを使用してログインする前に、

Informatica Intelligent Cloud Services

ユーザーアカウントをアクティブ化する必要があります。

Salesforce Web Services APIを使用してSalesforceセッションIDを生成し、SalesforceサーバーのURLを取得します。詳細については、Salesforceの

Web Services API開発者ガイド

を参照してください。

このlogoutリソースを使用して、セッションを終了します。

POST要求

Salesforce資格証明を使用してログインするには、次のURLを使用します。

https://<cloud provider>-<region>.informaticacloud.com/ma/api/v2/user/loginSf

クラウドプロバイダとリージョンの値のリストについては、ログインを参照してください。

loginSfオブジェクトの次の属性を使用します。

フィールド	タイプ	必須	説明
sfSessionId	String	○	SalesforceセッションID。SalesforceセッションIDの生成の詳細は、Salesforceの Web Services API開発者ガイドを参照してください。
sfServerUrl	String	○	SalesforceサーバーURL。 Salesforce APIログインリソースの応答からSalesforceサーバーURLを取得します。

POST応答

要求が成功すると、ユーザーオブジェクトを返します。エラーが発生した場合にエラーオブジェクトを返します。

応答には、後続のREST API呼び出しのヘッダーに含める必要のある次の情報が含まれます。

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

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

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

<serverUrl>/api/v2/job

ユーザーオブジェクトには次の属性が含まれます。

フィールド	タイプ	説明
id	String	ユーザーID。
orgId	String	ユーザーが属する組織のID。 22文字。従来のInformatica Cloudで作成された組織では、6文字の組織IDである可能性があります。
orgUuid	String	組織の一意のID。
name	String	Informatica Intelligent Cloud Services のユーザー名。
description	String	ユーザーの説明。
createTime	String	ユーザーアカウントの作成日時。
updateTime	String	ユーザーアカウントの最終作成日時。
createdBy	String	ユーザーアカウントを作成した Informatica Intelligent Cloud Services ユーザー。
updatedBy	String	ユーザーアカウントを最後に更新した Informatica Intelligent Cloud Services ユーザー。
sfUsername	String	Salesforceのユーザー名。ユーザーがSalesforceによって認証されるように設定されている場合に含まれます。
password	String	Salesforceのユーザーパスワード。ユーザーがSalesforceによって認証されるように設定されている場合に含まれます。
firstName	String	ユーザーアカウントの名。
lastName	String	ユーザーアカウントの姓。
title	String	ユーザーの役職。
phone	String	ユーザーの電話番号。
securityQuestion	String	セキュリティの質問。次のいずれかのコードを返します。 SPOUSE_MEETING_CITY FIRST_JOB_CITY CHILDHOOD_FRIEND MOTHER_MAIDEN_NAME PET_NAME CHILDHOOD_NICKNAME CUSTOM_QUESTION:"<question>"
securityAnswer	String	セキュリティの質問に対する答え。
roles		ユーザーに割り当てられた各ロールのロールオブジェクトを含むオブジェクト。
name	String	ロールオブジェクトに含まれます。ロール名。次のいずれかのコードを返します。サービスコンシューマ Designer Admin
description	String	ロールオブジェクトに含まれます。ロールの説明。
emails	String	ユーザーがアカウントパスワードを変更する際に通知される電子メールアドレス。
timezone	String	ユーザーのタイムゾーン。タイムゾーンは夏時間を使用します。詳細については、タイムゾーンのコードを参照してください。
serverUrl	String	ユーザーが属する組織の Informatica Intelligent Cloud Services のURL。最も正確なバージョン2 REST APIのリソースURIのベースとしてserverUrlを使用します。
spiUrl	String	このフィールドは適用されなくなり、非推奨になりました。
uuId	String	ユーザーの一意のID。
icSessionId	String	バージョン2 REST APIセッションの Informatica Intelligent Cloud Services セッションID。最も正確なバージョン2 REST API要求ヘッダーで使用します。
forceChangePassword	Boolean	初回ログイン後、ユーザーがパスワードをリセットする必要があるかどうかを決定します。次の値が含まれます。 True。ユーザーはパスワードをリセットする必要があります。 False。ユーザーはパスワードをリセットする必要がありません。

POSTの例

所属する

Informatica Intelligent Cloud Services

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

POST https://dm-us.informaticacloud.com/ma/api/v2/user/loginSf
Content-Type: application/json
Accept: application/json

{
"@type": "loginSf",
"sfSessionId": "00Df40000000coF!ARYAQDO2SvoD3eRXOrNaiOb9a3Pp",
"sfServerUrl": "https://c.na41.visual.force.com/services/Soap/u/27.0/00Df40000000coF"
}

応答では、後続の呼び出しで使用するserverUrlおよびicSessionIdの値が含まれるユーザーオブジェクトが返されます。次に例を示します。

{    
    "id": "0101TQ03000000000007",    
    "orgId": "0101TQ",    
    "orgUuid": "3FNFLs1uHe2IIgTs8tRjSJ",    
    "name": "John@infa.com",    
    "description": "",    
    "createTime": "2018-02-16T00:20:07.000Z",    
    "updateTime": "2018-07-17T22:45:50.000Z",    
    "createdBy": "System built-in user",    
    "updatedBy": "John@infa.com",    
    "sfUsername": "JohnR",    
    "firstName": "John",    
    "lastName": "Randall",    
    "title": "IICS Admin",    
    "password": "**********",    
    "phone": "123-456-7899",    
    "emails": "John@infa.com",    
    "timezone": null,    
    "serverUrl": "https://na4.dm-us.informaticacloud.com/saas",    
    "icSessionId": "1Ckv5VDHe2IICHi2hq04EF",    
    "securityQuestion": "In what city were you born?",    
    "securityAnswer": "********",    
    "uuid": "a51jk7TB0IDcnWLwJdLaW2",    
    "forceChangePassword": false,    
    "roles": [        
        {            
            "name": "Admin",            
            "description": "Role for performing administrative tasks for an organization. Has full access to all licensed services."        
        },        
        {            
            "name": "Data Preview",            
            "description": "Role to preview data"
        },
        {
            "name": "Designer",
            "description": "Role for creating assets, tasks, and processes. Can configure connections, schedules, and runtime environments. Has access to the Application Integration Console."
        }
    ],    
}

上記のような応答を例として使用し、GET要求を送信してSecure Agent情報を取得するには、次の要求を使用できます。

GET https://na4.dm-us.informaticacloud.com/saas/api/v2/agent
Content-Type: application/json
Accept: application/json
icSessionId: 1Ckv5VDHe2IICHi2hq04EF

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

ガイドをダウンロード

ページをウォッチ

フィードバックを送信

コミュニティ

Knowledge Base

Success Portal