スペースにユーザーを追加
put
/ic/api/process/v1/spaces/{spaceId}/permissions/{principal}
オプションで、ユーザーが持つロールを指定できます。 ユーザーにすでにロールがある場合は、そのロールが更新されます
リクエスト
サポートされているメディア・タイプ
- application/x-www-form-urlencoded
パス・パラメータ
- principal(required): string
プリンシパルID
- spaceId(required): string
スペースID
フォーム・パラメータ
- role: string
ユーザーに割り当てるロールデフォルト値:
viewer許容値:[ "viewer", "editor", "owner" ]
レスポンス
サポートされているメディア・タイプ
- application/json
- application/xml;qs=0.9
200レスポンス
成功した操作
ルート・スキーマ : grant
型:
object許可の表現
201レスポンス
成功。 スペース・パーミッションが正常に作成されました。
401レスポンス
未認可
403レスポンス
権限が必要です。 ユーザーはスペース権限を追加できません
404レスポンス
スペース/プリンシパルが見つかりません。
500レスポンス
スペース権限の作成中にエラーが発生しました
例
次の例は、RESTリソースに対してPUTリクエストを発行して、ユーザーをスペースに追加する方法を示しています。
curl -X PUT --header 'Content-Type: application/x-www-form-urlencoded' --header 'Accept: application/json' -H 'Authorization: Bearer access_token' -d 'role=owner' 'http://example.com:7001/ic/api/process/v1/spaces/<spaceId>/permissions/<principal>'
説明
-
example.comは、Oracle Integrationが実行されているホストです。 -
Content-Type:application/x-www-form-urlencoded -
Request URL:http://example.com:7001/ic/api/process/v1/spaces/<spaceId>/permissions/<principal> -
<spaceId>はスペースの一意のIDです。 使用可能なスペースを取得するには、「スペースの取得」を参照してください。
-
<principal>はユーザー名です。 領域の使用可能な権限を取得するには、「指定されたスペースに割り当てられているすべての権限を一覧表示」を参照してください。
次に、ユーザーを追加するために必要なリクエスト・パラメータを示します。 application/x-www-form-urlencodedパラメータを指定する必要があります。
-
role: ユーザーのロールを指定します。 指定できる値は、owner、editor、およびviewerです
レスポンス・ヘッダーの例
Status Code: 201 Created Date: Mon, 03 Apr 2017 09:39:39 GMT Content-Type: application/json
レスポンス本文の例
{
"user": "jsmith",
"role": "owner",
"links": [
{
"href": "http://example.com:7001/ic/api/process/v1/spaces/89f7e082-6855-4a75-b2a6-6a726aff7f23/permissions/jsmith",
"rel": "self"
},
{
"href": "http://example.com:7001/ic/api/process/v1/spaces/89f7e082-6855-4a75-b2a6-6a726aff7f23/permissions/jsmith",
"rel": "canonical"
},
{
"href": "http://example.com:7001/ic/api/process/v1/spaces/89f7e082-6855-4a75-b2a6-6a726aff7f23",
"rel": "parent"
}
]
}