Fetching List of DKE Roles
Use the get /v1/cckm/microsoft/dke/get-roles API to fetch a list of the Microsoft DKE role definitions. The results can be filtered using the connection parameter.
Syntax
curl -k '<CCKM IP address>/v1/cckm/microsoft/dke/get-roles' -H 'Authorization: Bearer AUTHTOKEN' -H 'accept: application/json' --compressed
Request Parameter
| Parameter | Type | Description |
|---|---|---|
| AUTHTOKEN | string | Authorization token. |
| connection | string | ID of the Azure connection. Mandatory for role-based authorization. |
Example Request
curl -k 'https://54.173.227.108/api/v1/cckm/microsoft/dke/get-roles' -X POST -H 'Authorization: Bearer eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiI1OGE3OTZlNi0wMjY0LTRjNjgtOWVlOS0xNTEzODFmYWYxZWIiLCJzdWIiOiJsb2NhbHwxYWIwNGY0ZC01MDQ5LTQ0M2ItOWQ0OC02MzVlYjVjNDRmYzciLCJpc3MiOiJreWxvIiwiYWNjIjoia3lsbyIsInByZWZlcnJlZF91c2VybmFtZSI6ImFkbWluIiwiY3VzdCI6eyJjbGllbnRfaWQiOiI4MzdjODQwZC03NWRkLTRiNGYtYTMxOC03OWNiMTZjYTI0OGQiLCJjbGllbnRfbmFtZSI6ImFwaS1wbGF5Z3JvdW5kIiwiY2xpZW50X3R5cGUiOiJwdWJsaWMiLCJkb21haW5faWQiOiIwMDAwMDAwMC0wMDAwLTAwMDAtMDAwMC0wMDAwMDAwMDAwMDAiLCJncm91cHMiOlsiYWRtaW4iXSwic2lkIjoiODM3Yzg0MGQtNzVkZC00YjRmLWEzMTgtNzljYjE2Y2EyNDhkIiwiem9uZV9pZCI6IjAwMDAwMDAwLTAwMDAtMDAwMC0wMDAwLTAwMDAwMDAwMDAwMCJ9LCJqd3RpZCI6ImFkNmFmNThiLTMzMzItNGU3ZC05MGIyLTdkZjUxODc2ZjRkNiIsImlhdCI6MTcwODUwNDE1NSwiZXhwIjoxNzA4NTA0NDU1fQ.olE7XMU745KAH9nZHacrUZvC4YErE2zvCA4AmFao3cAcBFv0xO5ssEMUpHNIQst-jTe0gqaUh_a3d4t3jczcHg' -H 'accept: application/json' --compressed
Example Response
[
{
"id": "74574343-69f5-4237-9190-012177145e10",
"description": "Can manage all aspects of Microsoft Entra ID and Microsoft services that use Microsoft Entra identities.",
"displayName": "Global Administrator",
"isBuiltIn": true,
"isEnabled": true,
"templateId": "74574343-69f5-4237-9190-012177145e10",
"version": "1"
},
{
"id": "87584754-b6af-4016-8d66-8c2a99b929b3",
"description": "Default role for guest users. Can read a limited set of directory information.",
"displayName": "Guest User",
"isBuiltIn": true,
"isEnabled": true,
"templateId": "87584754-b6af-4016-8d66-8c2a99b929b3",
"version": "1"
}
]
The sample output shows two DKE roles listed--one with the endpoint ID of 74574343-69f5-4237-9190-012177145e10 and the other with the endpoint ID of 87584754-b6af-4016-8d66-8c2a99b929b3.
Response Codes
| Response Code | Description |
|---|---|
| 2xx | Success |
| 4xx | Client errors |
| 5xx | Server errors |
Refer to HTTP status codes for details.
