Cluster IAMアクセスの更新

VPC環境で利用できます。

作成されたクラスタの IAMアクセス情報を更新します。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド	URI
PUT	/vnks/v2/clusters/{uuid}/access-entries/{entryUuid} (韓国リージョン)
PUT	/vnks/sgn-v2/clusters/{uuid}/access-entries/{entryUuid} (シンガポールリージョン)
PUT	/vnks/jpn-v2/clusters/{uuid}/access-entries/{entryUuid} (日本リージョン)

リクエストヘッダ

Ncloud Kubernetes Service APIで共通して使用されるヘッダの詳細は、Ncloud Kubernetes Serviceのリクエストヘッダをご参照ください。

リクエストパスパラメータ

リクエストパスパラメータの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`uuid`	String	Required	クラスタの UUID クラスタリストの照会を参照
`entryUuid`	String	Required	IAMアクセスの Entry UUID IAMアクセスリストの照会を参照

リクエスト構文

リクエスト構文は次の通りです。

{
  "groups": [
    "string"
  ],
  "policies": [
    {
      "type": "string",
      "scope": "string",
      "namespaces": [
        "string"
      ]
    }
  ]
}

リクエストボディ

リクエストボディの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`groups`	Array	Optional	グループ名
`policies`	Array	Optional	追加対象のポリシーリスト: policies

`policies`

policiesの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`type`	String	Conditional	ポリシーのタイプ `policies`入力時、必須 `NKSClusterAdminPolicy` `NKSAdminPolicy` `NKSEditPolicy` `NKSViewPolicy`
`scope`	String	Conditional	ポリシーの範囲 `policies`入力時、必須 `cluster` `namespace`
`namespaces`	Array	Conditional	ネームスペース `scope`設定が`namespace`の場合、必須

リクエスト例

リクエストのサンプルコードは次の通りです。

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"
    }
  ]
}'

レスポンス

レスポンス形式を説明します。

レスポンス構文

レスポンス構文は次の通りです。

{
    "uuid": "string",
    "entryUuid": "string"
}

レスポンスボディ

レスポンスボディの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`uuid`	String	-	クラスタの UUID
`entryUuid`	String	-	IAMアクセス Entry UUID

レスポンスステータスコード

Ncloud Kubernetes Service APIで共通して使用されるレスポンスステータスコードの詳細は、Ncloud Kubernetes Serviceのレスポンスステータスコードをご参照ください。

レスポンス例

レスポンスのサンプルコードは次の通りです。

{
    "uuid": "****a20e-e0fb-4dc9-af1b-97fd3f8d****",
    "entryUuid": "****a20e-e0fb-4dc9-af1b-97fd3f8d****"
}