検索

6.250. Users

download PDF

システム内のユーザーを管理するサービス。

表6.760 メソッドの概要
名前概要

add

ディレクトリーサービスからユーザーを追加します。

list

システム内のすべてのユーザーを一覧表示します。

6.250.1. add POST

ディレクトリーサービスからユーザーを追加します。

たとえば、myextension-authz 承認プロバイダーから myuser ユーザーを追加するには、次のようなリクエストを送信します。

POST /ovirt-engine/api/users

リクエスト本文は以下のようになります。

<user>
  <user_name>myuser@myextension-authz</user_name>
  <domain>
    <name>myextension-authz</name>
  </domain>
</user>

Active Directory を使用している場合は、ユーザープリンシパル名 (UPN) を username として渡し、その後に承認プロバイダー名を渡す必要があります。バグ 1147900 のため、ユーザーの UPN に設定された principal パラメーターも提供する必要があります。

たとえば、UPN myuser@mysubdomain.mydomain.com を持つユーザーを myextension-authz 承認プロバイダーから追加するには、以下のようなリクエスト本文を送信します。

<user>
  <principal>myuser@mysubdomain.mydomain.com</principal>
  <user_name>myuser@mysubdomain.mydomain.com@myextension-authz</user_name>
  <domain>
    <name>myextension-authz</name>
  </domain>
</user>
表6.761 パラメーターの概要
名前タイプ方向概要

user

User

In/Out

 

6.250.2. list GET

システム内のすべてのユーザーを一覧表示します。

使用方法

GET /ovirt-engine/api/users

ユーザーの一覧を返します。

<users>
  <user href="/ovirt-engine/api/users/1234" id="1234">
    <name>admin</name>
    <link href="/ovirt-engine/api/users/1234/sshpublickeys" rel="sshpublickeys"/>
    <link href="/ovirt-engine/api/users/1234/roles" rel="roles"/>
    <link href="/ovirt-engine/api/users/1234/permissions" rel="permissions"/>
    <link href="/ovirt-engine/api/users/1234/tags" rel="tags"/>
    <domain_entry_id>23456</domain_entry_id>
    <namespace>*</namespace>
    <principal>user1</principal>
    <user_name>user1@domain-authz</user_name>
    <domain href="/ovirt-engine/api/domains/45678" id="45678">
      <name>domain-authz</name>
    </domain>
  </user>
</users>

返されるユーザーのリストの順序は保証されません。

表6.762 パラメーターの概要
名前タイプ方向概要

case_sensitive

Boolean

In

search パラメーターを使用して実行する検索を、大文字と小文字を区別して実行する必要があるかどうかを示します。

follow

文字列

In

たどる 必要のある内部リンクを指定します。

max

Integer

In

返すユーザーの最大数を設定します。

search

文字列

In

返されるユーザーを制限するために使用されるクエリー文字列。

users

User[]

Out

ユーザーのリスト。

6.250.2.1. case_sensitive

search パラメーターを使用して実行する検索を、大文字と小文字を区別して実行する必要があるかどうかを示します。デフォルト値は true です。つまり、大文字と小文字の区別が考慮されます。ケースを無視する場合は、false に設定します。

6.250.2.2. follow

たどる 必要のある内部リンクを指定します。これらのリンクで参照されるオブジェクトは、現在の要求の一部としてフェッチされます。詳細は、こちら を参照してください。

6.250.2.3. max

返すユーザーの最大数を設定します。指定しない場合、すべてのユーザーが返されます。

Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

© 2024 Red Hat, Inc.