前のトピック: ユーザ アカウントの追加次のトピック: ユーザのすべてのアカウントの取得


ユーザ アカウントの更新

ユーザの既存のアカウントを更新するには、updateUserAccount 操作を使用する必要があります。 このセクションでは、ユーザ アカウントを更新するための手順について説明します。

リクエスト メッセージの準備

updateUserAccountRequest メッセージの要素は addUserAccountRequest の要素と同じです。 詳細については、「ユーザ アカウントの追加」の最初の表を参照してください。

Web サービスの起動

ユーザ アカウントを更新する方法

  1. (オプション) updateUserAccount 操作のヘッダに認証および許可の詳細を含めます。 ヘッダ要素の詳細については、「Web サービス セキュリティの管理」を参照してください。
  2. updateUserAccountRequest 要素を使用して、「ユーザ アカウントの追加」でリストされているユーザ アカウントの詳細を収集します。
  3. updateUserAccountRequest メッセージを使用して、前の手順で指定した詳細に従って入力メッセージを作成します。
  4. ArcorUserRegistrySvc サービスの updateUserAccount 操作を呼び出して、ユーザのアカウントを更新します。

    この操作では、トランザクション識別子、認証トークン、およびユーザ アカウントの詳細が含まれる updateUserAccountResponse メッセージが返されます。 レスポンス メッセージの詳細については、以下のセクションを参照してください。

レスポンス メッセージの解釈

updateUserAccountResponse レスポンス メッセージでは、SOAP エンベロープ ヘッダでトランザクション識別子および認証トークンが返されます。これらの要素については以下の表で説明しています。 操作が正常に実行されると、SOAP 本文で成功のメッセージが返されます。 エラーがある場合は、エラー レスポンスが返されます。 SOAP エラー メッセージの詳細については、付録「例外コードおよびエラー コード」を参照してください。

要素

説明

udsTransactionID

UDS を使用して実行されたトランザクションの一意の識別子。

authToken

Web サービスにアクセスするための認証情報の検証が成功した場合に返される認証トークン。 このトークンによって、その Web サービスへの後続のアクセスでは認証情報を提示する必要がなくなります。

デフォルトでは、認証トークンは 1 日間有効で、その後は認証が再度必要になります。