アプリケーション接続の機密フィールド値の更新
更新リソースを使用して、アプリケーション接続の機密フィールドの値を更新できます。単一のアプリケーション接続または複数のアプリケーション接続のフィールドを更新できます。
更新リソースを使用してアプリケーション接続を更新するには、管理者、デプロイヤ、デザイナ、またはオペレータのロールが割り当てられている必要があります。
アセットをエクスポートする場合、パスワード、アクセスキー、シークレットキーなどの機密フィールドはエクスポートされません。アプリケーション接続をインポートした後、アプリケーション接続と、PostmanなどのRESTクライアントで入力データとして更新するフィールドを追加できます。入力データは、接続のグローバル識別子/グローバル一意識別子（GUID）と、更新される属性のキーと値のペアで構成されます。さらに、接続のコンシューマとプロデューサに属性を提供できます。コンシューマはイベントソースを指し、プロデューサはイベントターゲットを指します。GUIDの詳細については、データ統合ヘルプの「REST APIリファレンス」にある「ルックアップリソース」と「アセット検索リソース」を参照してください。
フィールド値を取得するには、次のURLを使用します。
<Informatica Intelligent Cloud Services URL>/active-bpel/asset/v1/update?assetType=AppConnection
注: REST APIを使用した後に、アプリケーション統合内で接続を再パブリッシュして、古いアプリケーション接続の問題を修正します。これにより、APIを介して行った最新の更新が接続に反映されるようにすることができます。
次のサンプルに示すように、入力データを追加できます。
PUT <baseApiUrl>/active-bpel/asset/v1/update?assetType=AppConnection
Content-Type: application/json
Accept: application/json
INFA-SESSION-ID: <Infa-Session-ID>
{
"connections": [
{
"guid": {
"$t": "guid1_value"
},
"attributes": [
{
"key": {
"$t": "Access Key"
},
"value": {
"$t": "accessKey1_value"
}
},
{
"key": {
"$t": "Secret Key"
},
"value": {
"$t": "secretKey1_value"
}
}
],
"authentication": {
"attributes": [
{
"key": {
"$t": "username"
},
"value": {
"$t": "user1@example.com"
}
},
{
"key": {
"$t": "password"
},
"value": {
"$t": "password1"
}
},
{
"key": {
"$t": "security"
},
"value": {
"$t": "TLS"
},
"encrypted": "false"
},
{
"key": {
"$t": "connectionTimeout"
},
"value": {
"$t": "3000"
},
"encrypted": "false"
}
]
},
"consumers": [
{
"name": {
"$t": "consumer1"
},
"attributes": [
{
"key": {
"$t": "attribute1"
},
"value": {
"$t": "value1"
}
}
]
}
],
"producers": [
{
"name": {
"$t": "producer1"
},
"attributes": [
{
"key": {
"$t": "attribute1"
},
"value": {
"$t": "value1"
}
}
]
}
]
},
{
"guid": {
"$t": "guid2_value"
},
"attributes": [
{
"key": {
"$t": "Password"
},
"value": {
"$t": "password2"
}
}
],
"authentication": {
"attributes": [
{
"key": {
"$t": "username"
},
"value": {
"$t": "user2@example.com"
}
},
{
"key": {
"$t": "password"
},
"value": {
"$t": "password2"
}
},
{
"key": {
"$t": "security"
},
"value": {
"$t": "SSL"
},
"encrypted": "false"
},
{
"key": {
"$t": "connectionTimeout"
},
"value": {
"$t": "4000"
},
"encrypted": "false"
}
]
}
}
]
}
ログインリソースを使用して、INFA-SESSION-IDを取得できます。ログインリソースの詳細については、データ統合ヘルプの「REST APIリファレンス」を参照してください。
フィールドが正常に更新されると、次の応答を受け取ります。
{
"status": {
"$t": "SUCCESS"
}
}
フィールドは接続のGUIDに基づいて更新されます。GUIDが見つからない場合は、次の応答を受け取ります。
{
"status": {
"$t": "FAILED"
},
"errorDetails": {
"error": {
"$t": "Update failed for assets"
},
"failedAssets": {
"updateAssetFaultInfo": {
"xmlns": "https://com.informatica.icrt/2021/08/updateAssets.xsd",
"xmlns$aetgt": "https://com.informatica.icrt/2021/08/updateAssets.xsd",
"name": {},
"GUID": {
"$t": "<Incorrect guid value>"
},
"fault": {
"$t": "Entry not found for GUID."
}
}
}
}
}