List groups

GET https://api.ap1.datadoghq.com/api/v2/scim/Groupshttps://api.ap2.datadoghq.com/api/v2/scim/Groupshttps://api.datadoghq.eu/api/v2/scim/Groupshttps://api.ddog-gov.com/api/v2/scim/Groupshttps://api.us2.ddog-gov.com/api/v2/scim/Groupshttps://api.uk1.datadoghq.com/api/v2/scim/Groupshttps://api.datadoghq.com/api/v2/scim/Groupshttps://api.us3.datadoghq.com/api/v2/scim/Groupshttps://api.us5.datadoghq.com/api/v2/scim/Groups

概要

オーガニゼーション内のグループを一覧表示します。 結果は startIndexcount パラメーターでページネーションされます。 filter パラメーターを使用して結果を絞り込むことができます。 This endpoint requires all of the following permissions:

  • user_access_invite
  • user_access_manage

  • 引数

    クエリ文字列

    名前

    種類

    説明

    startIndex

    integer

    Specifies the start index to fetch the results (1-indexed).

    count

    integer

    Specifies the number of groups to be returned.

    filter

    string

    Specifies the url encoded filter to use to narrow down the results. Filters can be in the form of displayName eq <group name> or externalId eq <external id of group> or id eq <group id> and members eq <user uuid> or members eq <user uuid> and id eq <group id>.

    応答

    OK

    List groups response object.

    Expand All

    フィールド

    種類

    説明

    Resources

    [object]

    List of groups matching the request criteria.

    displayName

    string

    A human-readable name for the group.

    externalId

    string

    An identifier for the resource as defined by the provisioning client.

    id

    string

    The identifier of the resource. Not required when creating a group.

    members

    [object]

    A list of members belonging to the team.

    $ref

    string

    The URI corresponding to a resource that is a member of this group.

    display

    string

    Full name of the user.

    type

    string

    A label indicating the type of resource. Only supported value is "User".

    value

    string

    The identifier of the member of this group.

    meta

    object

    Metadata associated with a group.

    created

    date-time

    The date and time the group was created.

    lastModified

    date-time

    The date and time the group was last changed.

    location

    string

    URL identifying the resource.

    resourceType

    string

    Type of resource.

    schemas

    [string]

    Group JSON Schemas.

    itemsPerPage

    int64

    Number of groups returned per page.

    schemas

    [string]

    List response JSON Schemas.

    startIndex

    int64

    Starting index of the groups for this page (1-indexed).

    totalResults

    int64

    Total number of groups matching the request criteria.

    {
      "Resources": [
        {
          "displayName": "Group 1",
          "externalId": "group1",
          "id": "e43536e9-33fe-43f8-90b8-d3e39a7dd6ad",
          "members": [
            {
              "$ref": "https://app.datadoghq.com/api/scim/v2/Users/d34a5f93-5690-4d3f-a293-f2ad5c7a82a4",
              "display": "John Doe",
              "type": "User",
              "value": "d34a5f93-5690-4d3f-a293-f2ad5c7a82a4"
            },
            {
              "$ref": "https://app.datadoghq.com/api/scim/v2/Users/429ebce5-8ed3-4da9-9f1e-662f2dbc2fe6",
              "display": "Jane Doe",
              "type": "User",
              "value": "429ebce5-8ed3-4da9-9f1e-662f2dbc2fe6"
            }
          ],
          "meta": {
            "created": "2024-11-22T15:05:52.055138963Z",
            "lastModified": "2024-11-22T15:05:52.055139017Z",
            "location": "https://app.datadoghq.com/api/scim/v2/Groups/e43536e9-33fe-43f8-90b8-d3e39a7dd6ad",
            "resourceType": "Group"
          },
          "schemas": [
            "urn:ietf:params:scim:schemas:core:2.0:Group"
          ]
        },
        {
          "displayName": "Group 2",
          "externalId": "group2",
          "id": "79ef0d28-f257-4829-97e6-d23d2a26cb1a",
          "members": [
            {
              "$ref": "https://app.datadoghq.com/api/scim/v2/Users/29da9fb7-8fca-4e87-bf58-86652253deae",
              "display": "Alice Smith",
              "type": "User",
              "value": "29da9fb7-8fca-4e87-bf58-86652253deae"
            },
            {
              "$ref": "https://app.datadoghq.com/api/scim/v2/Users/f85e3868-ad7b-47e3-a8a9-ff1eade2bbf9",
              "display": "Bob Smith",
              "type": "User",
              "value": "f85e3868-ad7b-47e3-a8a9-ff1eade2bbf9"
            }
          ],
          "meta": {
            "created": "2024-11-22T15:05:52.055139748Z",
            "lastModified": "2024-11-22T15:05:52.055139813Z",
            "location": "https://app.datadoghq.com/api/scim/v2/Groups/79ef0d28-f257-4829-97e6-d23d2a26cb1a",
            "resourceType": "Group"
          },
          "schemas": [
            "urn:ietf:params:scim:schemas:core:2.0:Group"
          ]
        }
      ],
      "itemsPerPage": 2,
      "schemas": [
        "urn:ietf:params:scim:api:messages:2.0:ListResponse"
      ],
      "startIndex": 1,
      "totalResults": 2
    }

    Bad Request

    API error response.

    Expand All

    フィールド

    種類

    説明

    errors [required]

    [string]

    A list of errors.

    {
      "errors": [
        "Bad Request"
      ]
    }

    Too many requests

    API error response.

    Expand All

    フィールド

    種類

    説明

    errors [required]

    [string]

    A list of errors.

    {
      "errors": [
        "Bad Request"
      ]
    }

    コード例

                      # Curl command
    curl -X GET "https://api.ap1.datadoghq.com"https://api.ap2.datadoghq.com"https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.us2.ddog-gov.com"https://api.uk1.datadoghq.com"https://api.datadoghq.com"https://api.us3.datadoghq.com"https://api.us5.datadoghq.com/api/v2/scim/Groups" \ -H "Accept: application/json" \ -H "Authorization: Bearer ${DD_BEARER_TOKEN}"