VPC環境で利用できます。
クラスタの kubeconfig設定ファイルを照会します。
参考
- 2022年2月13日以降に作成されたクラスタは IAM認証が自動的に適用されるため、この APIを通じて kubeconfig設定ファイルを照会することはできません。
- 2022年2月13日以前に作成されたクラスタの場合、ncp-iam-authenticatorを利用して kubeconfig設定ファイルを構成すると、IAM認証を通じて IAMサービス(SubAccount)アカウントごとにクラスタ権限を制御できます。
リクエスト
リクエスト形式を説明します。リクエスト形式は次の通りです。
| メソッド | URI |
|---|---|
| GET | /clusters/{uuid}/kubeconfig |
リクエストヘッダ
Ncloud Kubernetes Service APIで共通して使用されるヘッダの詳細は、Ncloud Kubernetes Serviceの共通ヘッダをご参照ください。
リクエストパスパラメータ
パラメータの説明は次の通りです。
| フィールド | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
uuid |
String | Required | クラスタの UUID |
リクエスト例
リクエストのサンプルコードは次の通りです。
curl --location 'https://nks.apigw.ntruss.com/vnks/v2/clusters/{uuid}/kubeconfig' \
--header 'x-ncp-apigw-timestamp: {timestamp}' \
--header 'x-ncp-iam-access-key: {access key}' \
--header 'x-ncp-apigw-signature-v2: {API gateway signature}' \
レスポンス
レスポンス形式を説明します。
レスポンス構文
レスポンス構文は次の通りです。
{
"kubeconfig": "string"
}
レスポンスボディ
レスポンスボディの説明は次の通りです。
| フィールド | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
kubeconfig |
String | - | kubeconfigの JSON値 |
レスポンスステータスコード
Ncloud Kubernetes Service APIで共通して使用されるレスポンスステータスコードの詳細は、Ncloud Kubernetes Serviceのレスポンスステータスコードをご参照ください。
レスポンス例
レスポンスのサンプルコードは次の通りです。
{
"kubeconfig": "apiVersion: v1\nclusters:\n - cluster:\n certificate-authority-data: LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSUM2VENDQWRHZ0F3SUJBZ0lCQURBTkJna3Foa2lHOXcwQkFRc0ZBREFWTVJNd0VRWURWUVFERXdwcmRXSmwKY201bGRHVnpNQ0FYRFRJME1ETXlPREEwTURnd01sb1lEekl4TWpRd016QTBNRFF3T0RBeVdqQVZNUk13RVFZRApWUVFERXdwcmRXSmxjbTVsZEdWek1JSUJJakFOQmdrcWhraUc5dzBCQVFFRkFBT0NBUThBTUlJQkNnS0NBUUVBCnBvNVJJRjZ4SldWaDM4RTlaVndYNkp5YUZrbFZ2VEpaYmRzdFc4bWxKeGwrOUVzMUhHYjB5YWNyOTlhN3draWIKUVdCREYwSTdhcSsrZVYyM25QMk0zbjJVTXluSzltTDl0SFhSVHB4eVhBR2llRHFNUkUvU2YvbkV2RVhzMzJsUApGOUdLZ0dYUko5Vk90c3NsRy9IaEd0MmFrVmZlYStSRHhZOUtzN1dnNGMzQzNGZ1pKaUNlUTcyY2dYZkdQbW10CmQ2VUVQT0Q1eURYdXlIbFhQWnR3V0MxMTRhdEs1ZC9VN0hJc1VQMSt0aWZNNnJHMkh3US9md2pCUUdhYUpPaEoKb01tdmUvVmYyUjRXcjV3cTFSM2xkRjBLemY1c1d5S3dabGZQcW9qZDByUElmUjBxTTJJaU01cDlOQkRHeGYzMApkdGtMeVpsWXFqczFqbzBNLzhvcWR3SURBUUFCbzBJd1FEQU9CZ05WSFE4QkFmOEVCQU1DQXFRd0R3WURWUjBUCkFRSC9CQVV3QXdFQi96QWRCZ05WSFE0RUZnUVUyRkpqbTFMRGZDZFE5WFBvM29uWWVKaXlwejh3RFFZSktvWkkKaHZjTkFRRUxCUUFEZ2dFQkFLUEFlcEdUVWl0QXpyUS9CM044dWlXY3pxZ0tWODd0N0N1WEVydlI1OGhoWXFPMApuMHJ4YjdoME5ubUN1TUYrMlZmQ0RmS2JYWWc5dDhTbFFpNzdpcEN2OUIwdDhpQ1AyM3BuMlB6Y3ZObjMxeGxvCllwUDMxekNGSk1VOElncndXZDNMdGlQSXZCSG9hMVlTalY3QWdNb01wMGtOQ3hEbm85dkI0b1Y4a2JKKzdha0cKMEdJN0hpOFRHS1l5Y2xURWFPem83TzZCa2ZLMVJTcC9tMzg1R201bzdCRlE4V05iVk5XaFpUdGN6V0M5MGhLeQo5VGMwZDVXMTNmeDJrTGxEN08vd0M2alZMa0EyV2NXVVBGd3RIRk4wNlJNZTRKQWNsQjFtTUcvNmNBQUNobnJ5ClRUWDZZR2NRWHVtWG12WFRxOTc1K3pnUXpUNkxhaWxEdkVuanN1Yz0KLS0tLS1FTkQgQ0VSVElGSUNBVEUtLS0tLQo=\n server: https://1a1111a1-4d44-99b9-88c8-9e99a99e9e99.kr.vnks.ntruss.com\n name: kubernetes\ncontexts:\n - context:\n cluster: kubernetes\n user: kubernetes-admin\n name: kubernetes-admin@kubernetes\ncurrent-context: kubernetes-admin@kubernetes\nkind: Config\npreferences: {}\n"
}