機械翻訳について
  1. Oracle Access Governance REST APIs
  2. タスク
  3. IdentityCollections

アイデンティティ・コレクションのメンバーのリストの取得

get

/access-governance/access-controls/20250331/identityCollections/{identityCollectionId}/members

指定されたアイデンティティ・コレクションのメンバーのリストを返します

リクエスト

パス・パラメータ
問合せパラメータ
  • コレクション形式: multi
    最大アイテム数: 5
    フィルタするキーワードのリスト
  • 最小値: 1
    最大値: 1000
    返されるアイテムの最大数。
    デフォルト値: 10
  • 最小長: 1
    結果の取得を開始する位置を表すトークン。 これは、前のレスポンスの`opc-next-page`ヘッダー・フィールドから取得する必要があります。
  • ソートの基準となるフィールド。 指定できるソート順は1つのみです。 timeCreatedのデフォルトの順序は降順です。 displayNameのデフォルトの順序は昇順です。
    デフォルト値: timeCreated
    許容値: [ "timeCreated", "displayName" ]
  • 使用するソート順(ASCまたはDESC)。
    許容値: [ "ASC", "DESC" ]
ヘッダー・パラメータ
  • トレース用のクライアント・リクエストID。 リクエストIDに有効な文字は、文字、数字、アンダースコアおよびダッシュのみです。
トップに戻る

レスポンス

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

200レスポンス

指定されたアイデンティティ・コレクションのメンバーのリストは正常に問合せされました。
ヘッダー
  • アイテム・リストのページ区切り。 リストをページングする際、このヘッダーがレスポンスに表示される場合は、部分的なリストが返されている可能性があります。 この値を後続のGETリクエストの`page`パラメータとして含め、次のアイテム・バッチを取得します。
  • リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
本文()
ルート・スキーマ : AccessGovernanceTypeCollection
型: object
アクセス・ガバナンス・エンティティ・アイテムのリスト。
ソースを表示
ネストされたスキーマ: items
型: array
アクセス・ガバナンス・エンティティ項目のリスト。
ソースを表示
ネストされたスキーマ : AccessGovernanceEntity
型: object
Access Governanceエンティティ
ソースを表示

400レスポンス

不正なリクエスト
ヘッダー
  • リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
本文()
ルート・スキーマ : Error
型: object
エラー情報。
ソースを表示

401レスポンス

未認可
ヘッダー
  • リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
本文()
ルート・スキーマ : Error
型: object
エラー情報。
ソースを表示

404レスポンス

見つかりません
ヘッダー
  • リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
本文()
ルート・スキーマ : Error
型: object
エラー情報。
ソースを表示

409レスポンス

競合
ヘッダー
  • リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
本文()
ルート・スキーマ : Error
型: object
エラー情報。
ソースを表示

429レスポンス

リクエストが多すぎます
ヘッダー
  • リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
本文()
ルート・スキーマ : Error
型: object
エラー情報。
ソースを表示

500レスポンス

内部サーバー・エラー
ヘッダー
  • リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
本文()
ルート・スキーマ : Error
型: object
エラー情報。
ソースを表示

デフォルト・レスポンス

不明なエラー
ヘッダー
  • リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
本文()
ルート・スキーマ : Error
型: object
エラー情報。
ソースを表示
トップに戻る

例

次の例は、アイデンティティ・コレクションに含まれるメンバー・リストを取得する方法を示しています。

cURL例 - 問合せパラメータなし

curl -i -X GET \
 -H "Authorization:Bearer <your access token >" \
 '${service-instance-url}/access-governance/access-controls/${version}/identityCollections/${identityCollectionID}/members'

レスポンス本文の例

JSON形式のレスポンス本文のコンテンツの例を次に示します。

このJSONには、アイデンティティ詳細、個人属性、ジョブ関連情報、アカウント・ステータス、部門関連など、アイデンティティ・コレクションに含まれるメンバーが含まれます。

{
  "items": [
    {
      "id": "globalId.8dxxxxxx-ab68-4f09-ae89-xxxxxx",
      "type": "IDENTITY",
      "name": "john.doe@example.com",
      "timeCreated": "2024-09-09T12:09:09.126Z",
      "timeUpdated": "2024-09-09T12:09:09.126Z",
      "isRuleBased": false,
      "entityType": "USER",
      "value": {
        "name": {
          "familyName": "Doe",
          "givenName": "John"
        },
        "userName": "john.doe@example.com",
        "displayName": "John Doe",
        "description": "Software Engineer",
        "primaryEmail": "john.doe@example.com",
        "userType": "Full-Time",
        "organization": {
          "value": "organization.8dxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
          "displayName": "Engineering"
        },
        "manager": {
          "value": "12345",
          "displayName": "Emily Taylor",
          "resourceType": "ACCOUNT"
        },
        "status": "Active",
        "jobCode": "ENG002",
        "state": "NY",
        "risk": 5,
        "location": "US",
        "emails": [
          {
            "value": "john.doe@example.com"
          }
        ],
        "phoneNumbers": [
          {
            "display": "555-000-0001",
            "primary": false,
            "type": "home"
          },
          {
            "display": "555-500-0002",
            "primary": false,
            "type": "mobile"
          }
        ],
        "customAttributes": {
          "Division": "Tech Division",
          "Age": 35,
          "BadgeNumber": "1001",
          "Company": "Example Corp",
          "HRAddress": "123 Business St",
          "AccountDisabled": false,
          "AccountLocked": false,
          "Alias": "john.doe"
        }
      }
    },
    {
      "id": "globalId.ICF.21xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
      "type": "IDENTITY",
      "name": "emma.smith@example.com",
      "timeCreated": "2025-04-01T12:46:58.146Z",
      "timeUpdated": "2025-04-01T12:46:58.146Z",
      "isRuleBased": false,
      "entityType": "USER",
      "value": {
        "name": {
          "familyName": "Smith",
          "givenName": "Emma"
        },
        "userName": "emma.smith@example.com",
        "displayName": "Emma Smith",
        "primaryEmail": "emma.smith@example.com",
        "userType": "Employee",
        "title": "Ms.",
        "employeeNumber": "ES12345",
        "organization": {
          "value": "organization.ICF.21xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
          "displayName": "Human Resources",
          "resourceType": "ORGANIZATION"
        },
        "department": "HR",
        "status": "Disabled",
        "jobCode": "HR456",
        "location": "London",
        "emails": [
          {
            "value": "emma.smith@example.com"
          }
        ],
        "addresses": [
          {
            "country": "UK",
            "postalCode": "E1 6AN",
            "region": "East London"
          }
        ],
        "customAttributes": {
          "Company": "Example Corp",
          "AccountLocked": true,
          "BadgeNumber": "2002",
          "HRAddress": "456 Corporate Blvd"
        }
      }
    }
  ]
}
先頭に戻る