Delete an org group membership - 組織グループ

警告Note: This endpoint is in Preview and is subject to change. If you have any feedback, contact Datadog support.

DELETEhttps://api.datadoghq.com/api/v2/org_group_memberships/{org_group_membership_id}https://api.us3.datadoghq.com/api/v2/org_group_memberships/{org_group_membership_id}https://api.us5.datadoghq.com/api/v2/org_group_memberships/{org_group_membership_id}https://api.datadoghq.eu/api/v2/org_group_memberships/{org_group_membership_id}https://api.ap1.datadoghq.com/api/v2/org_group_memberships/{org_group_membership_id}https://api.ap2.datadoghq.com/api/v2/org_group_memberships/{org_group_membership_id}https://api.uk1.datadoghq.com/api/v2/org_group_memberships/{org_group_membership_id}https://api.ddog-gov.com/api/v2/org_group_memberships/{org_group_membership_id}https://api.us2.ddog-gov.com/api/v2/org_group_memberships/{org_group_membership_id}

概要

Remove an organization from an organization group by deleting its membership. This operation is not supported for organization groups with group_type set to config_management. The organization group that the membership belongs to must be specified using filter[org_group_id], and the requesting organization must own that organization group. Returns 404 if the membership does not exist, was already removed, or does not belong to the organization group.

This endpoint requires the org_group_write permission.

引数

パスパラメーター

名前

タイプ

説明

org_group_membership_id [required]

string

The ID of the org group membership.

クエリ文字列

名前

タイプ

説明

filter[org_group_id] [required]

string

The ID of the organization group that the memberships belong to.

応答

No Content

Bad Request

API error response.

フィールド

タイプ

説明

errors [required]

[object]

A list of errors.

{
  "errors": [
    {
      "detail": "Missing required attribute in body",
      "meta": {},
      "source": {
        "header": "Authorization",
        "parameter": "limit",
        "pointer": "/data/attributes/title"
      },
      "status": "400",
      "title": "Bad Request"
    }
  ]
}

Unauthorized

API error response.

フィールド

タイプ

説明

errors [required]

[object]

A list of errors.

{
  "errors": [
    {
      "detail": "Missing required attribute in body",
      "meta": {},
      "source": {
        "header": "Authorization",
        "parameter": "limit",
        "pointer": "/data/attributes/title"
      },
      "status": "400",
      "title": "Bad Request"
    }
  ]
}

Forbidden

API error response.

フィールド

タイプ

説明

errors [required]

[object]

A list of errors.

{
  "errors": [
    {
      "detail": "Missing required attribute in body",
      "meta": {},
      "source": {
        "header": "Authorization",
        "parameter": "limit",
        "pointer": "/data/attributes/title"
      },
      "status": "400",
      "title": "Bad Request"
    }
  ]
}

Not Found

API error response.

フィールド

タイプ

説明

errors [required]

[object]

A list of errors.

{
  "errors": [
    {
      "detail": "Missing required attribute in body",
      "meta": {},
      "source": {
        "header": "Authorization",
        "parameter": "limit",
        "pointer": "/data/attributes/title"
      },
      "status": "400",
      "title": "Bad Request"
    }
  ]
}

Too many requests

API error response.

フィールド

タイプ

説明

errors [required]

[string]

A list of errors.

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

コード例

Delete an org group membership

# Path parameters
export org_group_membership_id="f1e2d3c4-b5a6-7890-1234-567890abcdef"
# Required query arguments
export filter_org_group_id="a1b2c3d4-e5f6-7890-abcd-ef0123456789"

# 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 DELETE "https://api.${DD_SITE}/api/v2/org_group_memberships/${org_group_membership_id}?filter%5Borg_group_id%5D=${filter_org_group_id}" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"

# Path parameters
export org_group_membership_id="f1e2d3c4-b5a6-7890-1234-567890abcdef"
# Required query arguments
export filter_org_group_id="a1b2c3d4-e5f6-7890-abcd-ef0123456789"

# 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 DELETE "https://api.${DD_SITE}/api/v2/org_group_memberships/${org_group_membership_id}?filter%5Borg_group_id%5D=${filter_org_group_id}" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"

# Path parameters
export org_group_membership_id="f1e2d3c4-b5a6-7890-1234-567890abcdef"
# Required query arguments
export filter_org_group_id="a1b2c3d4-e5f6-7890-abcd-ef0123456789"

# 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 DELETE "https://api.${DD_SITE}/api/v2/org_group_memberships/${org_group_membership_id}?filter%5Borg_group_id%5D=${filter_org_group_id}" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"

# Path parameters
export org_group_membership_id="f1e2d3c4-b5a6-7890-1234-567890abcdef"
# Required query arguments
export filter_org_group_id="a1b2c3d4-e5f6-7890-abcd-ef0123456789"

# 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 DELETE "https://api.${DD_SITE}/api/v2/org_group_memberships/${org_group_membership_id}?filter%5Borg_group_id%5D=${filter_org_group_id}" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"

# Path parameters
export org_group_membership_id="f1e2d3c4-b5a6-7890-1234-567890abcdef"
# Required query arguments
export filter_org_group_id="a1b2c3d4-e5f6-7890-abcd-ef0123456789"

# 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 DELETE "https://api.${DD_SITE}/api/v2/org_group_memberships/${org_group_membership_id}?filter%5Borg_group_id%5D=${filter_org_group_id}" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"

# Path parameters
export org_group_membership_id="f1e2d3c4-b5a6-7890-1234-567890abcdef"
# Required query arguments
export filter_org_group_id="a1b2c3d4-e5f6-7890-abcd-ef0123456789"

# 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 DELETE "https://api.${DD_SITE}/api/v2/org_group_memberships/${org_group_membership_id}?filter%5Borg_group_id%5D=${filter_org_group_id}" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"

# Path parameters
export org_group_membership_id="f1e2d3c4-b5a6-7890-1234-567890abcdef"
# Required query arguments
export filter_org_group_id="a1b2c3d4-e5f6-7890-abcd-ef0123456789"

# 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 DELETE "https://api.${DD_SITE}/api/v2/org_group_memberships/${org_group_membership_id}?filter%5Borg_group_id%5D=${filter_org_group_id}" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"

# Path parameters
export org_group_membership_id="f1e2d3c4-b5a6-7890-1234-567890abcdef"
# Required query arguments
export filter_org_group_id="a1b2c3d4-e5f6-7890-abcd-ef0123456789"

# 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 DELETE "https://api.${DD_SITE}/api/v2/org_group_memberships/${org_group_membership_id}?filter%5Borg_group_id%5D=${filter_org_group_id}" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"

# Path parameters
export org_group_membership_id="f1e2d3c4-b5a6-7890-1234-567890abcdef"
# Required query arguments
export filter_org_group_id="a1b2c3d4-e5f6-7890-abcd-ef0123456789"

# 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 DELETE "https://api.${DD_SITE}/api/v2/org_group_memberships/${org_group_membership_id}?filter%5Borg_group_id%5D=${filter_org_group_id}" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"