Available in VPC
Get IAM access list information for a specific cluster.
Request
The following describes the request format for the endpoint. The request format is as follows:
| Method | URI |
|---|---|
| GET | /clusters/{uuid}/access-entries |
Request headers
For headers common to all Ncloud Kubernetes Service APIs, see Ncloud Kubernetes Service common request headers.
Request path parameters
The following describes the parameters.
| Field | Type | Required | Description |
|---|---|---|---|
uuid |
String | Required | Cluster's UUID
|
Request example
The following is a sample request.
curl --location --request GET 'https://nks.apigw.ntruss.com/vnks/v2/clusters/****a20e-e0fb-4dc9-af1b-97fd3f8d****/access-entries' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Sub Account Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'Content-Type: application/json'
Response
The following describes the response format.
Response body
The following describes the response body.
| Field | Type | Required | Description |
|---|---|---|---|
accessEntries[] |
Array | - | IAM access list |
accessEntries[].uuid |
String | - | IAM access entry UUID |
accessEntries[].entry |
String | - | NRN information by IAM USER, ROLE |
accessEntries[].groups[] |
Array | - | Group name |
accessEntries[].policies[] |
Array | - | Policy list |
accessEntries[].policies[].type |
String | - | Policy type |
accessEntries[].policies[].scope |
String | - | Policy scope |
accessEntries[].policies[].namespaces |
Array | - | Namespace |
Response status codes
For response status codes common to all Ncloud Kubernetes Service APIs, see Ncloud Kubernetes Service response status codes.
Response example
The following is a sample example.
{
"accessEntries": [
{
"clusterUuid": "****a20e-e0fb-4dc9-af1b-97fd3f8d****"
"entry": "***:Account::***",
"policies": [
{
"scope": "Cluster",
"type": "NKSClusterAdminPolicy"
}
],
"uuid": "****a20e-e0fb-4dc9-af1b-97fd3f8d****"
}
]
}