Get cluster IAM access

Article summary

Did you find this summary helpful?

Thank you for your feedback

Available in VPC

Get IAM access 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/{entryUuid}

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 Check through Get cluster list
`entryUuid`	String	Required	IAM access entry UUID Check through Get IAM access list

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/****a20e-e0fb-4dc9-af1b-97fd3f8d****' \
--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
`accessEntry`	Object	-	IAM access information
`accessEntry.uuid`	String	-	IAM access entry UUID
`accessEntry.entry`	String	-	NRN information by IAM USER, ROLE
`accessEntry.groups[]`	Array	-	Group name
`accessEntry.policies[]`	Array	-	Policy list
`accessEntry.policies[].type`	String	-	Policy type
`accessEntry.policies[].scope`	String	-	Policy scope
`accessEntry.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.

{
    "accessEntry": {
        "clusterUuid": "****a20e-e0fb-4dc9-af1b-97fd3f8d****"
        "entry": "***:Account::***",
        "policies": [
          {
            "scope": "Cluster",
            "type": "NKSClusterAdminPolicy"
          }
        ],
        "uuid": "****a20e-e0fb-4dc9-af1b-97fd3f8d****"
    }
}

Was this article helpful?

What's Next

Create cluster IAM access

Table of contents

Request
Response