orchestrator
2023.4
false
- 基本情報
- 認証
- Swagger の定義
- Orchestrator API
- プラットフォーム管理 API
[プレビュー] グループを更新する
重要 :
このコンテンツの一部は機械翻訳によって処理されており、完全な翻訳を保証するものではありません。
Orchestrator API ガイド
Last updated 2024年6月18日
[プレビュー] グループを更新する
指定したローカル グループの情報を取得します。
--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json'
--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json'
要求本文には、グループが属する組織 ID と、更新する情報 (グループの名前とメンバーシップなど) が含まれます。
{
"partitionGlobalId": "string",
"name": "string",
"directoryUserIDsToAdd": [
"string"
],
"directoryUserIDsToRemove": [
"string"
]
}
{
"partitionGlobalId": "string",
"name": "string",
"directoryUserIDsToAdd": [
"string"
],
"directoryUserIDsToRemove": [
"string"
]
}
API 呼び出しの構築に必要な情報をすべて収集したとします。
{baseURL}
はhttps://{yourDomain}/{organizationName}/{tenantName}
です。-
{access_token}
は1234
です (長さを考慮)。 {partitionGlobalId}
はmagic-7
です。- グループ名は現在の名前のままにします。
-
ユーザー Luna と Neville をグループに追加します。各ユーザーのユーザー ID は次のとおりです。
- Luna のユーザー ID は
lun-1302
です。 - Neville のユーザー ID は
nev-3007
です。
- Luna のユーザー ID は
呼び出しは以下のようになります (cURL)。
curl --location --request PUT 'https://{yourDomain}/{organizationName}/{tenantName}/identity_/api/Group/magic-7/gryff-01' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'
--data-raw '{
"partitionGlobalId": "magic-7",
"name": "Gryffindors",
"directoryUserIDsToAdd": [
"lun-1302", "nev-3007"
],
"directoryUserIDsToRemove": []
}'
curl --location --request PUT 'https://{yourDomain}/{organizationName}/{tenantName}/identity_/api/Group/magic-7/gryff-01' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'
--data-raw '{
"partitionGlobalId": "magic-7",
"name": "Gryffindors",
"directoryUserIDsToAdd": [
"lun-1302", "nev-3007"
],
"directoryUserIDsToRemove": []
}'
呼び出しが成功した場合、応答は次のようになります。
{
"id": "gryff-01",
"name": "Gryffindors",
"displayName": "Gryffindors",
"type": 1,
"creationTime": "2021-10-19T15:37:49.1853184",
"lastModificationTime": "2021-10-19T16:46:20.0742901",
"members": [
{
"objectType": "DirectoryUser",
"firstName": "Hermione",
"lastName": "Granger",
"jobTitle": "student",
"companyName": "Hogwarts",
"city": "London",
"department": "magic",
"displayName": "Hermione Granger",
"source": "local",
"identifier": "her-1909",
"name": "Hermione",
"email": "hermione@hogwarts.com"
},
{
"objectType": "DirectoryUser",
"firstName": "Harry",
"lastName": "Potter",
"jobTitle": ""student"",
"companyName": "Hogwarts",
"city": "London",
"department": "magic",
"displayName": "Harry Potter",
"source": "local",
"identifier": "har-3107",
"name": "Harry",
"email": "harry@hogwarts.com"
},
{
"objectType": "DirectoryUser",
"firstName": "Luna",
"lastName": "Lovegood",
"jobTitle": "student",
"companyName": "Hogwarts",
"city": "London",
"department": "magic",
"displayName": "Luna Lovegood",
"source": "local",
"identifier": "lun-1302",
"name": "Luna",
"email": "luna@hogwarts.com"
},
{
"objectType": "DirectoryUser",
"firstName": "Ron",
"lastName": "Weasley",
"jobTitle": "student",
"companyName": "Hogwarts",
"city": "London",
"department": "magic",
"displayName": "Ron Weasley",
"source": "local",
"identifier": "ron-0103",
"name": "Ron",
"email": "ron@hogwarts.com"
},
{
"objectType": "DirectoryUser",
"firstName": "Neville",
"lastName": "Longbottom",
"jobTitle": "student",
"companyName": "Hogwarts",
"city": "London",
"department": "magic",
"displayName": "Neville Longbottom",
"source": "local",
"identifier": "nev-3007",
"name": "Neville",
"email": "neville@hogwarts.com"
}
]
}
{
"id": "gryff-01",
"name": "Gryffindors",
"displayName": "Gryffindors",
"type": 1,
"creationTime": "2021-10-19T15:37:49.1853184",
"lastModificationTime": "2021-10-19T16:46:20.0742901",
"members": [
{
"objectType": "DirectoryUser",
"firstName": "Hermione",
"lastName": "Granger",
"jobTitle": "student",
"companyName": "Hogwarts",
"city": "London",
"department": "magic",
"displayName": "Hermione Granger",
"source": "local",
"identifier": "her-1909",
"name": "Hermione",
"email": "hermione@hogwarts.com"
},
{
"objectType": "DirectoryUser",
"firstName": "Harry",
"lastName": "Potter",
"jobTitle": ""student"",
"companyName": "Hogwarts",
"city": "London",
"department": "magic",
"displayName": "Harry Potter",
"source": "local",
"identifier": "har-3107",
"name": "Harry",
"email": "harry@hogwarts.com"
},
{
"objectType": "DirectoryUser",
"firstName": "Luna",
"lastName": "Lovegood",
"jobTitle": "student",
"companyName": "Hogwarts",
"city": "London",
"department": "magic",
"displayName": "Luna Lovegood",
"source": "local",
"identifier": "lun-1302",
"name": "Luna",
"email": "luna@hogwarts.com"
},
{
"objectType": "DirectoryUser",
"firstName": "Ron",
"lastName": "Weasley",
"jobTitle": "student",
"companyName": "Hogwarts",
"city": "London",
"department": "magic",
"displayName": "Ron Weasley",
"source": "local",
"identifier": "ron-0103",
"name": "Ron",
"email": "ron@hogwarts.com"
},
{
"objectType": "DirectoryUser",
"firstName": "Neville",
"lastName": "Longbottom",
"jobTitle": "student",
"companyName": "Hogwarts",
"city": "London",
"department": "magic",
"displayName": "Neville Longbottom",
"source": "local",
"identifier": "nev-3007",
"name": "Neville",
"email": "neville@hogwarts.com"
}
]
}