移動先

• リクエスト
• レスポンス
• 例

サービス役割のプロビジョニング

put

/essbase/rest/v1/permissions/{id}

Essbaseサービス役割について単一のユーザーまたはグループをプロビジョニングします。サービス役割には、サービス管理者、パワー・ユーザーおよびユーザーが含まれます。

EPM共有サービス・セキュリティ・モードを使用している場合、この操作は実行できません。かわりに、共有サービス・コンソールでユーザー、グループおよび権限を管理します。

リクエスト

サポートされているメディア・タイプ

• application/json
• application/xml

パス・パラメータ

• id(required): string

  ユーザーIDまたはグループID

本体()

ユーザーまたはグループのプロビジョニング情報。

ルート・スキーマ : permission

型: object

ソースの表示

• group: boolean

  trueまたはfalse。idがグループを参照するかどうか。

• id: string

  ユーザーIDまたはグループID

• links: array links
• name: string

  ユーザー名またはグループ名。

• role: string

  ユーザーまたはグループの役割。

{
    "type":"object",
    "properties":{
        "links":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/Link"
            }
        },
        "id":{
            "type":"string",
            "description":"<p>User or group ID.</p>"
        },
        "name":{
            "type":"string",
            "description":"<p>User or group name.</p>"
        },
        "role":{
            "type":"string",
            "description":"<p>User or group role.</p>"
        },
        "group":{
            "type":"boolean",
            "description":"<p><b>true</b> or <b>false</b>. Whether the <b>id</b> refers to a group.</p>"
        }
    },
    "xml":{
        "name":"permission"
    }
}

ネストされたスキーマ : links

型: array

ソースの表示

• 配列: object Link

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/Link"
    }
}

ネストされたスキーマ : Link

型: object

ソースの表示

• href: string
• method: string
• rel: string
• type: string

{
    "type":"object",
    "properties":{
        "rel":{
            "type":"string"
        },
        "href":{
            "type":"string"
        },
        "method":{
            "type":"string"
        },
        "type":{
            "type":"string"
        }
    }
}

先頭に戻る

レスポンス

サポートされているメディア・タイプ

• application/json
• application/xml

204 レスポンス

OK

ユーザーまたはグループが正常にプロビジョニングされました。

400 レスポンス

不正なリクエスト

ログインしているユーザーに、必要なサービス管理者役割がない可能性があります。

500 レスポンス

サーバーの内部エラーです。

先頭に戻る

例

次の例では、1つのサービス役割に単一のユーザーまたはグループをプロビジョニングする方法を示します。

この例では、cURLを使用して、Windowsシェル・スクリプトからREST APIにアクセスします。呼出し元ユーザーのIDおよびパスワードは変数であり、properties.bat内でその変数値が設定されています。

cURLコマンドを含むスクリプト

call properties.bat
curl -X PUT "https://myserver.example.com:9001/essbase/rest/v1/permissions/user1" -H "accept: application/json" -H "Content-Type: application/json" -d '{"links": [ {"rel": "string", "href": "string", "method": "string", "type": "string"} ], "id": "user1", "name": "user1", "role": "service_administrator", "group": false}' -u %User%:%Password%

MSADプロビジョニング用のcURLサンプル・テンプレート

user1という名前のMicrosoft Active Directoryユーザーにservice_administratorロールをプロビジョニングするには、WebLogic管理者アカウントとして次のリクエストを発行します。<weblogic_admin_user>、<weblogic_admin_password>、<Essbase_Host>、<Essbase_Managed_Server_Port>、<user1>を適切な値に置き換えます。

curl -X PUT -u <weblogic_admin_user>:<weblogic_admin_password> "https://<Essbase_Host>:<Essbase_Managed_Server_Port>/essbase/rest/v1/permissions/user1" -H "accept: application/json" -H "Content-Type: application/json" -d '{"links": [ {"rel": "string", "href": "string", "method": "string", "type": "string"} ], "id": "user1", "name": "user1", "role": "service_administrator", "group": false}'

先頭に戻る