Cluster IAMアクセスの更新

Prev Next

VPC環境で利用できます。

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

リクエスト

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

メソッド URI
PUT /clusters/{uuid}/access-entries/{entryUuid}

リクエストヘッダ

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

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

パラメータの説明は次の通りです。

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

リクエスト構文

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

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

リクエストボディ

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

フィールド タイプ 必須の有無 説明
groups[] Array Optional グループ名
policies[] Array Optional 追加対象のポリシーリスト
policies[].type String Conditional ポリシーのタイプ
  • policies[]入力時、必須
  • NKSClusterAdminPolicy
  • NKSAdminPolicy
  • NKSEditPolicy
  • NKSViewPolicy
policies[].scope String Conditional ポリシーの範囲
  • policies[]入力時、必須
  • cluster
  • namespace
policies[].namespaces Array Conditional ネームスペース
  • policies[].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****"
}