機械翻訳について

ユーザーの管理

ユーザー名は特定のテナント内で一意であり、テナント名はシステム全体で一意です。

トピック:

ユーザーの追加

このAPIを使用すると、新しいユーザーを追加できます。

注意:

新しいユーザーを追加できるのは、テナント管理者のみです。

メソッド

POST

RESTリソース

/user/

URI

https://api_endpoint/user/

リクエスト本文のパラメータ

パラメータ 説明
username ユーザーの一意の階層名。 たとえば、/mytenant/myuserなどです。

オブジェクト名には、英数字、ハイフン、およびピリオドのみを使用できます。 オブジェクト名は大文字と小文字が区別されます。

fullname ユーザーのフル・ネーム
email 有効な電子メール・アドレス
role (オプション)システム内のユーザーのロール。

このオプションは、クラウド管理者が使用します。 テナント管理者が、このオプションを削除できます。 Oracle Cloud管理者は、ロール・オプションを使用して次のいずれか1つのロールをユーザーに追加します。

  • /cloud/adminをクラウド管理者に。

  • /cloud/monitorをクラウド監視者に。

  • /tenant_name/admin (テナント管理者)

  • /tenant_name/usersをテナント・ユーザーに

このオプションが指定されない場合、デフォルト・ロールの/tenant_name/usersが付与されます。
password (オプション)ユーザー・パスワード。
ユーザーのパスワードは、次の要件を満たしている必要があります:

  • 英数字

  • 少なくとも6文字の長さ。

  • 少なくとも5つの一意の文字。 たとえば、azylazは有効なパスワードではありませんが、azylmzは有効です。

  • アンダースコアとダッシュを含むことができます。

  • 一連の文字を含んではいけません。 たとえば、"abcde1"と"asdfgh"は有効なパスワードではありません。

  • 辞書にある単語を含みません

URIの例

https://api.oc.example.com/user/

リクエスト本文の例

{
        "username": "/mytenant/myuser", 
        "blacklisted": false, 
        "uri": null, 
        "role": "", 
        "groups": [], 
        "fullname": "myuserfullname", 
        "password": "zaqwsx1234", 
        "email": "myuser@example.com"
}

レスポンス本文の例

{
        "username": "/mytenant/myuser", 
        "customer": "mytenant", 
        "blacklisted": false, 
        "uri": "https://api/user/mytenant/myuser", 
        "id": "f36f54ca-e8d2-4e56-93acae392c4f1", 
        "role": "/mytenant/users", 
        "groups": ["/mytenant/users"], 
        fullname": "myuserfullname", 
        "password": "", 
        "email": "myuser@example.com"
}

ユーザーの削除

このAPIを使用すると、既存のユーザーを削除できます。

メソッド

DELETE

RESTリソース

/user/name

URI

https://api_endpoint/user/name

URIパラメータ

パラメータ 説明
name 削除するユーザーの階層名。 たとえば、/mytenant/myuser,や/cloud/myuserなどです

URIの例

https://api.oc.example.com/user/mytenant/myuser1

ユーザーの更新

このAPIを使用すると、ユーザーの情報を更新できます。

注意:

テナント・ユーザーのみがパスワードと電子メール・アドレスを更新できます。

メソッド

PUT

RESTリソース

/user/name

URI

https://api_endpoint/user/name

URIパラメータ

パラメータ 説明
name ユーザーの一意の階層名。 たとえば、/mytenant/myuserや/cloud/myuserなどです

リクエスト本文のパラメータ

パラメータ 説明
fullname (オプション)ユーザーのフル・ネーム
email (オプション)有効な電子メール・アドレス
role (オプション)システム内のユーザーのロール。

このオプションは、クラウド管理者が使用します。 テナント管理者が、このオプションを削除できます。 クラウド管理者は、ロール・オプションを使用して次のいずれか1つのロールをユーザーに追加します。

  • /cloud/adminをクラウド管理者に。

  • /cloud/monitorをクラウド監視者に。

  • /tenant_name/admin (テナント管理者)

  • /tenant_name/usersをテナント・ユーザーに
password (オプション)ユーザー・パスワード。
ユーザーのパスワードは、次の要件を満たしている必要があります:

  • 英数字

  • 少なくとも6文字の長さ。

  • 少なくとも5つの一意の文字。 たとえば、azylazは有効なパスワードではありませんが、azylmzは有効です。

  • アンダースコアとダッシュを含むことができます。

  • 一連の文字を含んではいけません。 たとえば、"abcde1"と"asdfgh"は有効なパスワードではありません。

  • 辞書にある単語を含みません
blacklisted (オプション)ユーザーがブラックリストにあるかどうかを指定します

URIの例

https://api.oc.example.com/user/mytenant/myuser

リクエスト本文の例

{
        "username": "/mytenant/myuser", 
        "fullname": "myuserfullname", 
        "password": "", 
        "email": "new.email@example.com"
}

レスポンス本文の例

{
        "username": "/mytenant/myuser", 
        "customer": "mytenant", 
        "blacklisted": false, 
        "uri": "https://api/user/mytenant/myuser", 
        "id": "f36f54ca-e8d2-4e56-9371-0acae392c4f1", 
        "role": "/mytenant/users", 
        "groups": ["/mytenant/users"], 
        "fullname": "myuserfullname", 
        "password": "", 
        "email": "new.email@example.com"
}

ユーザー詳細の取得

ユーザー詳細を取得するには、REST APIを使用します。

トピック:

ユーザーの検出

このAPIを使用すると、特定のコンテナのユーザーのリストを検出できます。

注意:

検出APIコールは、指定されたコンテナ内のオブジェクトの名前を表示しますが、オブジェクトの詳細は表示しません。 オブジェクトの名前をリストするには、Acceptヘッダーをapplication/oracle-compute-v3+directory+jsonに設定します。 その他の目的では、Acceptヘッダーをapplication/oracle-compute-v3+jsonに設定する必要があります。

メソッド

GET

RESTリソース

/user/container

URI

https://api_endpoint/user/container

URIパラメータ

パラメータ 説明
container ユーザーの階層名前空間。

URIの例

https://api.oc.example.com/user/

レスポンス本文の例

{"result": ["/mytenant/administrator", "/mytenant/user123"]}

ユーザーの取得

このAPIを使用すると、特定のユーザーの情報を取得できます。

メソッド

GET

RESTリソース

/user/name

URI

https://api_endpoint/user/name

URIパラメータ

パラメータ 説明
name ユーザーの階層名。 たとえば、/mytenant/myuserや/cloud/myuserなどです

URIの例

https://api.oc.example.com/user/mytenant/myuser

レスポンス本文の例

{
        "username": "/mytenant/myuser", 
        "customer": "mytenant", 
        "blacklisted": false, 
        "uri": "https://api/user/mytenant/myuser", 
        "id": "f36f54ca-e8d2-4e56-9371-0acae392c4f1", 
        "role": "/mytenant/users", 
        "groups": ["/mytenant/users"], 
        "fullname": "myuserfullname", 
        "password": "", 
        "email": "myuser@example.com"
}

ユーザーのリスト表示

このAPIを使用すると、特定のコンテナのユーザーをリストできます。

注意:

自分のテナント内のテナント・ユーザーのみをリストできます。

メソッド

GET

RESTリソース

/user/name

URI

https://api_endpoint/user/container?role=roleValue

URIパラメータ

パラメータ 説明
container ユーザーの階層名前空間。
role=roleValue (オプション)システム内のユーザーのロール。
次のいずれかを指定することによって、ユーザー・ロールに基づいてリスト出力をフィルタできます。

  • /cloud/adminをクラウド管理者に

  • /cloud/monitorをクラウド監視者に

  • /tenant_name/admin (テナント管理者)

  • /tenant_name/usersをテナント・ユーザーに

URIの例

https://api.oc.example.com/user/mytenant/

レスポンス本文の例

{"result": [
        {
                "username": "/mytenant/administrator", 
                "customer": "mytenant", "blacklisted": false, 
                "uri": "https://api/user/mytenant/administrator", 
                "id": "1ccf2e90-39aa-4b73-bca8-da9fdf8c6441", 
                "role": "/mytenant/admin", 
                "groups": ["/mytenant/admin"], 
                "fullname": "Administrator", "password": "", 
                "email": "myuser@example.com"
        }, 

        {
                "username": "/mytenant/myuser", 
                "customer": "mytenant", 
                "blacklisted": false, 
                "uri": "https://api/user/mytenant/myuser", 
                "id": "f36f54ca-e8d2-4e56-9371-0acae392c4f1", 
                "role": "/mytenant/users", 
                "groups": ["/mytenant/users"], 
                "fullname": "myuserfullname", 
                "password": "", 
                "email": "myuser@example.com"
        }
]}