List groups
GET https://{{host}}/config-dns/v2/data/groups?gid={{gid}}
Lists the groups accessible to the current user. Each group includes the list of contracts related to that group, as well as your permissions of READ
, WRITE
, ADD
, or DELETE
zone on that group.
Body
PARAM
Key | Datatype | Required | Description |
gid
|
string | (Required) The currently selected group ID to manage. | |
accountSwitchKey
|
string | (Optional) For customers who manage more than one account, this [runs the operation from another account](https://techdocs.akamai.com/developer/docs/manage-many-accounts-with-one-api-client). The Identity and Access Management API provides a [list of available account switch keys](https://techdocs.akamai.com/iam-api/reference/get-client-account-switch-keys). |
HEADERS
Key | Datatype | Required | Description |
Accept
|
string |
RESPONSES
status OK
{
"groups": [
{
"contractIds": [
"C-0N7RAC71"
],
"groupId": 54321,
"groupName": "example-name",
"permissions": [
"READ",
"WRITE",
"ADD",
"DELETE"
]
}
]
} |
ENDPOINTS