--- title: "Assignmentターゲットリストの照会" slug: "get-assignment-targets" updated: 2026-09-17T09:58:02Z published: 2026-09-17T09:58:02Z canonical: "api.ncloud-docs.com/get-assignment-targets" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # Assignmentターゲットリストの照会 Classic/VPC環境で利用できます。 Assignmentに追加したターゲット(SSO User、グループ)リストを照会します。 ## リクエスト リクエスト形式を説明します。リクエスト形式は次の通りです。 | メソッド | URI | | --- | --- | | GET | /api/v1/assignments/{assignmentId}/targets | ### リクエストヘッダ Ncloud Single Sign-On APIで共通して使用されるヘッダの詳細は、[Ncloud Single Sign-Onのリクエストヘッダ](/docs/ja/single-sign-on-overview#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。 ### リクエストパスパラメータ リクエストパスパラメータの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `assignmentId` | String | Required | Assignment ID - [Assignmentリストの照会](/docs/ja/get-assignments)を参照 | ### リクエストクエリパラメータ リクエストクエリパラメータの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `targetType` | String | Required | ターゲットのタイプ - `user` \| `group` - `user`: SSO User - `group`: グループ | | `page` | Integer | Optional | ページ番号 - 0~N (デフォルト: 0) | | `size` | Integer | Optional | ページの出力数 - 1~N (デフォルト: 20) | ### リクエスト例 リクエストのサンプルコードは次の通りです。 ``` curl --location --request GET 'https://sso.apigw.ntruss.com/api/v1/assignments/2c15b16c-****-****-****-3e7207ff2bf6/targets?targetType=group&page=0&size=20' \ --header 'x-ncp-apigw-timestamp: {Timestamp}' \ --header 'x-ncp-iam-access-key: {Access Key}' \ --header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' ``` ## レスポンス レスポンス形式を説明します。 ### レスポンスボディ レスポンスボディの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `page` | Number | - | ページ番号 | | `totalPages` | Number | - | ページの総数 | | `totalItems` | Number | - | レスポンス結果数 | | `isFirst` | Boolean | - | 最初のページかどうか - `true` \| `false` - `true`: 最初のページ - `false`: 最初のページではない | | `isLast` | Boolean | - | 最後のページかどうか - `true` \| `false` - `true`: 最後のページ - `false`: 最後のページではない | | `hasPrevious` | Boolean | - | 以前のページは存在するかどうか - `true` \| `false` - `true`: 存在する - `false`: 存在しない | | `hasNext` | Boolean | - | 次のページは存在するか - `true` \| `false` - `true`: 存在する - `false`: 存在しない | | `items` | Array | - | ターゲットリスト - SSO Userリスト(`targetType`が`user`の場合): [items](/docs/ja/get-assignment-targets#items1) - グループリスト(`targetType`が`group`の場合): [items](/docs/ja/get-assignment-targets#items2) | #### `items` ターゲットのタイプが SSO Userの場合、`items`の説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `userId` | String | - | SSO User ID | | `loginId` | String | - | SSO Userログイン ID | | `nrn` | String | - | SSO Userに対する NAVERクラウドプラットフォームリソースの識別値 | | `userProfile` | Object | - | SSO User Profile情報 | | `userProfile.firstName` | String | - | SSO Userの名(下の名前) | | `userProfile.lastName` | String | - | SSO Userの姓(苗字) | | `userProfile.email` | String | - | SSO Userのメールアドレス | | `userProfile.emailVerified` | Boolean | - | メールアドレスは認証済みかどうか - `true` \| `false` - `true`: 認証完了 - `false`: 認証が必要 | | `userProfile.empNo` | String | - | SSO Userの社員番号 | | `userProfile.phoneCountryCode` | String | - | SSO Userの国番号 | | `userProfile.phoneNo` | String | - | SSO Userの携帯電話番号 | | `userProfile.phoneNoVerified` | Boolean | - | 携帯電話番号は認証済みかどうか - `true` \| `false` - `true`: 認証完了 - `false`: 認証が必要 | | `userProfile.deptName` | String | - | SSO Userの部署名 | | `accessRules` | Object | - | アクセスルール情報 | | `accessRules.consoleAccessAllowed` | Boolean | - | コンソールアクセスを許可するか - `true` \| `false` - `true`: 許可 - `false`: 許可しない | | `accessRules.apiAccessAllowed` | Boolean | - | API Gatewayアクセスを許可するか - `true` \| `false` - `true`: 許可 - `false`: 許可しない | | `status` | String | - | SSO Userの状態 - `active` \| `suspended` - `active`: 使用中(有効化) - `suspended`: 停止(無効化) | | `lastLoginAt` | String | - | SSO Userの最終アクセス日時 - ISO 8601形式 | | `createdAt` | String | - | SSO Userの作成日時 - ISO 8601形式 | | `updatedAt` | String | - | SSO Userの更新日時 - ISO 8601形式 | | `description` | String | - | SSO Userの説明 | #### `items` ターゲットのタイプがグループの場合、`items`の説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `relationCreatedAt` | String | - | グループの追加日時 - ISO 8601形式 | | `groupId` | String | - | グループ ID | | `tenantId` | String | - | Tenant ID | | `nrn` | String | - | グループに対する NAVERクラウドプラットフォームリソースの識別値 | | `groupName` | String | - | グループ名 | | `description` | String | - | グループの説明 | | `createdAt` | String | - | グループの作成日時 - ISO 8601形式 | | `updatedAt` | String | - | グループの更新日時 - ISO 8601形式 | ### レスポンスステータスコード Ncloud Single Sign-On APIで共通して使用されるレスポンスステータスコードの詳細は、[Ncloud Single Sign-Onのレスポンスステータスコード](/docs/ja/single-sign-on-overview#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。 ### レスポンス例 レスポンスのサンプルコードは次の通りです。 #### ターゲットのタイプが SSO Userの場合 ターゲットのタイプが SSO Userの場合のレスポンスのサンプルコードは次の通りです。 ``` { "page": 0, "totalPages": 1, "totalItems": 1, "isFirst": true, "isLast": true, "hasPrevious": false, "hasNext": false, "items": [ { "userId": "a5968927-****-****-****-28592d5ba924", "loginId": "*******@ncloud.com", "nrn": "nrn:PUB:SSO::*******:User/a5968927-****-****-****-28592d5ba924", "userProfile": { "firstName": "ギルドン", "lastName": "ホン", "email": "*******@ncloud.com", "emailVerified": true, "empNo": "00112233", "phoneCountryCode": "82", "phoneNo": "010-0000-0000", "phoneNoVerified": true, "deptName": "部署" }, "accessRules": { "consoleAccessAllowed": true, "apiAccessAllowed": true }, "status": "active", "lastLoginAt": "2025-01-15T05:56:20Z", "createdAt": "2025-01-14T06:42:21Z", "updatedAt": "2025-01-15T05:56:20Z", "description": "description" } ] } ``` #### ターゲットのタイプがグループの場合 ターゲットのタイプがグループの場合のレスポンスのサンプルコードは次の通りです。 ``` { "page": 0, "totalPages": 1, "totalItems": 1, "isFirst": true, "isLast": true, "hasPrevious": false, "hasNext": false, "items": [ { "relationCreatedAt": "2025-01-14T02:09:39Z", "groupId": "12cfbd94-****-****-****-2ff725201395", "tenantId": "d71d79e8-****-****-****-281f2a1d5d45", "nrn": "nrn:PUB:SSO::*******:Group/12cfbd94-****-****-****-2ff725201395", "groupName": "group000", "description": "group description", "createdAt": "2025-01-13T02:04:15Z", "updatedAt": "2025-01-14T00:50:49Z" } ] } ```