For AI agents: A markdown version of this page is available at https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/ko/api/latest/teams/link-teams-with-external-teams.md. A documentation index is available at /llms.txt.
homeHomedocs문서apiAPI
Language
Datadog site

Teams와 GitHub Teams 연결

POSThttps://api.datadoghq.com/api/v2/team/synchttps://api.us3.datadoghq.com/api/v2/team/synchttps://api.us5.datadoghq.com/api/v2/team/synchttps://api.datadoghq.eu/api/v2/team/synchttps://api.ap1.datadoghq.com/api/v2/team/synchttps://api.ap2.datadoghq.com/api/v2/team/synchttps://api.uk1.datadoghq.com/api/v2/team/synchttps://api.ddog-gov.com/api/v2/team/synchttps://api.us2.ddog-gov.com/api/v2/team/sync

개요

이 엔드포인트는 기존 Datadog 팀과 GitHub 팀의 이름을 일치시켜 이러한 팀 간에 동기화를 구성합니다. 현재 모든 Datadog 팀을 평가하여 Datadog 팀 핸들과 GitHub 팀 슬러그를 기반으로 Datadog 계정에 연결된 GitHub 조직 내 팀과 비교합니다 (소문자 및 케밥 케이스).

이 작업은 GitHub 측에서 읽기 전용이며, 팀이 수정되거나 생성되지 않습니다.

필요시 selection_state를 제공하여 모든 팀을 동기화하는 대신 특정 팀이나 조직 및 해당 하위 트리로 동기화를 제한할 수 있습니다.

GitHub 조직이 Datadog 계정에 연결되어 있어야 하며, Datadog과 통합된 GitHub 앱에는 Members Read 권한이 있어야 합니다. 정규화된 일치 항목을 사용하 Datadog 팀 핸들과 GitHub 팀 슬러그를 비교하여 매칭이 수행됩니다. 이때, 대소문자는 무시되고 공백은 제거됩니다. GitHub의 팀에는 수정 사항이 적용되지 않습니다. 이 작업은 유형이 provision으로 설정된 경우에만 Datadog에서 새 팀을 생성합니다.

This endpoint requires the teams_manage permission.

OAuth apps require the teams_manage authorization scope to access this endpoint.

요청

Body Data (required)

항목
유형
설명
data [required]
object

팀 동기화 요청입니다.

응답

OK

코드 예시

Link teams with external teams returns "No Content" response
# Set your Datadog site and credentials
export DD_SITE="datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/team/sync" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "source": "github",
      "type": "link",
      "selection_state": [
        {
          "external_id": {
            "type": "organization",
            "value": "1"
          }
        }
      ]
    },
    "type": "team_sync_bulk"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="us3.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/team/sync" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "source": "github",
      "type": "link",
      "selection_state": [
        {
          "external_id": {
            "type": "organization",
            "value": "1"
          }
        }
      ]
    },
    "type": "team_sync_bulk"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="us5.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/team/sync" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "source": "github",
      "type": "link",
      "selection_state": [
        {
          "external_id": {
            "type": "organization",
            "value": "1"
          }
        }
      ]
    },
    "type": "team_sync_bulk"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="datadoghq.eu"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/team/sync" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "source": "github",
      "type": "link",
      "selection_state": [
        {
          "external_id": {
            "type": "organization",
            "value": "1"
          }
        }
      ]
    },
    "type": "team_sync_bulk"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="ap1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/team/sync" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "source": "github",
      "type": "link",
      "selection_state": [
        {
          "external_id": {
            "type": "organization",
            "value": "1"
          }
        }
      ]
    },
    "type": "team_sync_bulk"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="ap2.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/team/sync" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "source": "github",
      "type": "link",
      "selection_state": [
        {
          "external_id": {
            "type": "organization",
            "value": "1"
          }
        }
      ]
    },
    "type": "team_sync_bulk"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="uk1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/team/sync" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "source": "github",
      "type": "link",
      "selection_state": [
        {
          "external_id": {
            "type": "organization",
            "value": "1"
          }
        }
      ]
    },
    "type": "team_sync_bulk"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/team/sync" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "source": "github",
      "type": "link",
      "selection_state": [
        {
          "external_id": {
            "type": "organization",
            "value": "1"
          }
        }
      ]
    },
    "type": "team_sync_bulk"
  }
}
EOF
# Set your Datadog site and credentials
export DD_SITE="us2.ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/team/sync" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "source": "github",
      "type": "link",
      "selection_state": [
        {
          "external_id": {
            "type": "organization",
            "value": "1"
          }
        }
      ]
    },
    "type": "team_sync_bulk"
  }
}
EOF