Edit cluster IAM access
- Print
- PDF
Edit cluster IAM access
- Print
- PDF
Article summary
Did you find this summary helpful?
Thank you for your feedback
Available in VPC
Edit IAM access information for a created cluster.
Request
The following describes the request format for the endpoint. The request format is as follows:
Method | URI |
---|---|
PUT | /clusters/{uuid}/access-entries/{entryUuid} |
Request headers
For headers common to all Ncloud Kubernetes Service APIs, see Ncloud Kubernetes Service common headers.
Request path parameters
The following describes the parameters.
Field | Type | Required | Description |
---|---|---|---|
uuid | String | Required | Cluster's UUID
|
entryUuid | String | Required | IAM access entry UUID
|
Request syntax
The request syntax is as follows.
{
"groups": [
"string"
],
"policies": [
{
"type": "string",
"scope": "string",
"namespaces": [
"string"
]
}
]
}
Request body
The following describes the request body.
Field | Type | Required | Description |
---|---|---|---|
groups[] | Array | Optional | Group name |
policies[] | Array | Optional | List of policies to add |
policies[].type | String | Conditional | Policy type
|
policies[].scope | String | Conditional | Policy scope
|
policies[].namespaces | Array | Conditional | Namespace
|
Request example
The following is a sample request.
curl --location --request PUT '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: {access key}' \
--header 'x-ncp-apigw-signature-v2: {API gateway signature}' \
--data '{
"policies": [
{
"type": "NKSClusterAdminPolicy",
"entryUuid": "cluster"
}
]
}'
Response
The following describes the response format.
Response syntax
The response syntax is as follows.
{
"uuid": "string",
"entryUuid": "string"
}
Response body
The following describes the response body.
Field | Type | Required | Description |
---|---|---|---|
uuid | String | - | UUID of the cluster |
entryUuid | String | - | IAM access entry UUID |
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.
{
"uuid": "****a20e-e0fb-4dc9-af1b-97fd3f8d****",
"entryUuid": "****a20e-e0fb-4dc9-af1b-97fd3f8d****"
}
Was this article helpful?