az networkcloud kubernetescluster
Note
このリファレンスは、Azure CLI (バージョン 2.51.0 以降) のネットワーククラウド拡張機能の一部です。 拡張機能は、az networkcloud kubernetescluster コマンドを初めて実行するときに自動的にインストールされます。 拡張機能の詳細をご覧ください。
コマンド グループ 'az networkcloud' はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus
Kubernetes クラスターを管理します。
コマンド
名前 | 説明 | 型 | Status |
---|---|---|---|
az networkcloud kubernetescluster agentpool |
Kubernetes クラスターのエージェント プールを管理します。 |
拡張機能 | プレビュー |
az networkcloud kubernetescluster agentpool create |
新しい Kubernetes クラスター エージェント プールを作成するか、既存の Kubernetes クラスター エージェント プールのプロパティを更新します。 |
拡張機能 | プレビュー |
az networkcloud kubernetescluster agentpool delete |
指定された Kubernetes クラスター エージェント プールを削除します。 |
拡張機能 | プレビュー |
az networkcloud kubernetescluster agentpool list |
指定された Kubernetes クラスターのエージェント プールを一覧表示します。 |
拡張機能 | プレビュー |
az networkcloud kubernetescluster agentpool show |
指定された Kubernetes クラスター エージェント プールのプロパティを取得します。 |
拡張機能 | プレビュー |
az networkcloud kubernetescluster agentpool update |
指定された Kubernetes クラスター エージェント プールのプロパティを更新するか、Kubernetes クラスター エージェント プールに関連付けられているタグを更新します。 プロパティとタグの更新を、個別に実行できます。 |
拡張機能 | プレビュー |
az networkcloud kubernetescluster agentpool wait |
条件が満たされるまで CLI を待機状態にします。 |
拡張機能 | プレビュー |
az networkcloud kubernetescluster create |
新しい Kubernetes クラスターを作成するか、既存の Kubernetes クラスターのプロパティを更新します。 |
拡張機能 | プレビュー |
az networkcloud kubernetescluster delete |
指定された Kubernetes クラスターを削除します。 |
拡張機能 | プレビュー |
az networkcloud kubernetescluster list |
指定されたサブスクリプション内の Kubernetes クラスターを一覧表示します。 |
拡張機能 | プレビュー |
az networkcloud kubernetescluster restart-node |
Kubernetes クラスターのターゲット ノードを再起動します。 |
拡張機能 | プレビュー |
az networkcloud kubernetescluster show |
指定された Kubernetes クラスターのプロパティを取得します。 |
拡張機能 | プレビュー |
az networkcloud kubernetescluster update |
指定された Kubernetes クラスターのプロパティを更新するか、Kubernetes クラスターに関連付けられているタグを更新します。 プロパティとタグの更新を、個別に実行できます。 |
拡張機能 | プレビュー |
az networkcloud kubernetescluster wait |
条件が満たされるまで CLI を待機状態にします。 |
拡張機能 | プレビュー |
az networkcloud kubernetescluster create
コマンド グループ 'az networkcloud' はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus
新しい Kubernetes クラスターを作成するか、既存の Kubernetes クラスターのプロパティを更新します。
az networkcloud kubernetescluster create --control-plane-node-configuration
--extended-location
--initial-agent-pool-configurations
--kubernetes-cluster-name
--kubernetes-version
--network-configuration
--resource-group
[--aad-configuration]
[--admin-username]
[--generate-ssh-keys {0, 1, f, false, n, no, t, true, y, yes}]
[--location]
[--managed-resource-group-configuration]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--ssh-dest-key-path]
[--ssh-key-values]
[--tags]
例
Kubernetes クラスターを作成または更新する
az networkcloud kubernetescluster create --name "kubernetesClusterName" --resource-group "resourceGroupName" --location "location" --kubernetes-version "1.XX.Y" --extended-location name="/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ExtendedLocation/customLocations/clusterExtendedLocationName" type=CustomLocation --aad-configuration admin-group-object-ids=["f110271b-XXXX-4163-9b99-214d91660f0e"] --admin-username "azureuser" --ssh-key-values "ssh-rsa AAAAB3NzaC1yc2EAAAADAQAt5SjWU= admin@vm" --initial-agent-pool-configurations "[{count:1,mode:'System',name:'systemPool-1',vmSkuName:'NC-XXXXX',agentOptions:{hugepagesCount:96,hugepagesSize:1G},upgradeSettings:{maxSurge:'10%'},adminUsername:'azureuser',ssh-key-values:['ssh-rsa AAAAB3NzaC1yc2EAAAADAQAt5SjWU= admin@vm']}]" --control-plane-node-configuration count=1 vmSkuName='NC-YYYYY' adminUsername='azureuser' ssh-key-values="['ssh-rsa AAAAB3NzaC1yc2EAAAADAQAt5SjWU= admin@vm']" --network-configuration cloud-services-network-id="/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/cloudServicesNetworks/cloudServicesNetworkName" cni-network-id="/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/l3Networks/l3NetworkName" pod-cidrs=["10.244.0.0/16"] service-cidrs=["10.96.0.0/16"] dns-service-ip="10.96.0.10" attached-network-configuration.l2-networks="[{networkId:'/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/l2Networks/l2NetworkName',pluginType:'DPDK'}]" attached-network-configuration.l3-networks="[{networkId:'/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/l3Networks/l3NetworkName',pluginType:'SRIOV',ipamEnabled:'False'}]" attached-network-configuration.trunked-networks="[{networkId:'/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/trunkedNetworks/trunkedNetworkName',pluginType:'MACVLAN'}]" bgp-service-load-balancer-configuration.bgp-advertisements="[{advertiseToFabric:'True',communities:['64512:100'],ipAddressPools:['pool1'],peers:['peer1']}]" bgp-service-load-balancer-configuration.fabric-peering-enabled="True" bgp-service-load-balancer-configuration.bgp-peers="[{bfdEnabled:'False',bgpMultiHop:'False',holdTime:'P300s',keepAliveTime:'P300s',myAsn:64512,name:'peer1',peerAddress:'203.0.113.254',peerAsn:64497,peerPort:179}]" bgp-service-load-balancer-configuration.ip-address-pools="[{addresses:['198.51.102.0/24'],autoAssign:'True',name:'pool1',onlyUseHostIps:'True'}]"
必須のパラメーター
この Kubernetes クラスターのコントロール プレーンの定義特性。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。
リソースに関連付けられているクラスターの拡張された場所。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。
重要なシステム サービスとワークロードを実行するために、この Kubernetes クラスターで作成されたエージェント プール。 このフィールドのこのデータは作成時にのみ使用され、Kubernetes クラスターの作成後、フィールドは空になります。 作成後、エージェント プールの管理は agentPools サブリソースを使用して行われます。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。
Kubernetes クラスターの名前。
このクラスターの Kubernetes バージョン。 n.n、n.n.n、および n.n.n-n 形式を受け入れます。 使用される解釈されたバージョンは、作成または更新後にこのフィールドに解決されます。
Kubernetes クラスター ネットワークの構成 (クラスターにまたがるネットワークの添付ファイルを含む)。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
省略可能のパラメーター
Azure Active Directory 統合プロパティ。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。
Kubernetes ノードを実行するオペレーティング システムに適用される管理者のユーザー名。 指定しない場合は、サービスによってユーザー名が選択されます。
SSH 公開キー ファイルおよび SSH 秘密キー ファイルがない場合は生成します。 キーは '~/.ssh' の下に格納されます。
リソースが存在する地理的な場所 を指定しない場合は、リソース グループの場所が使用されます。
リソースに関連付けられているマネージド リソース グループの構成。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。
実行時間の長い操作の終了を待機しません。
ssh 公開キーへのスペース区切りパスの一覧。 ファイル パスは、指定することも、ディレクトリにすることもできます。 ディレクトリが指定されている場合は、見つかったすべての公開キー (.pub) の読み込みが試行されます。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。
スペース区切りの SSH 公開キーの一覧。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。
リソース タグ。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az networkcloud kubernetescluster delete
コマンド グループ 'az networkcloud' はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus
指定された Kubernetes クラスターを削除します。
az networkcloud kubernetescluster delete [--ids]
[--kubernetes-cluster-name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]
[--yes]
例
Kubernetes クラスターを削除する
az networkcloud kubernetescluster delete --name "kubernetesClusterName" --resource-group "resourceGroupName"
省略可能のパラメーター
1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。
Kubernetes クラスターの名前。
実行時間の長い操作の終了を待機しません。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
確認のダイアログを表示しません。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az networkcloud kubernetescluster list
コマンド グループ 'az networkcloud' はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus
指定されたサブスクリプション内の Kubernetes クラスターを一覧表示します。
az networkcloud kubernetescluster list [--max-items]
[--next-token]
[--resource-group]
例
サブスクリプションの Kubernetes クラスターを一覧表示する
az networkcloud kubernetescluster list
リソース グループの Kubernetes クラスターを一覧表示する
az networkcloud kubernetescluster list --resource-group "resourceGroupName"
省略可能のパラメーター
コマンドの出力で返される項目の合計数。 使用可能な項目の合計数が指定された値を超える場合は、コマンドの出力にトークンが提供されます。 改ページ位置の変更を再開するには、後続のコマンドの引数に --next-token
トークン値を指定します。
ページ分割を開始する場所を指定するトークン。 これは、以前に切り捨てられた応答からのトークン値です。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az networkcloud kubernetescluster restart-node
コマンド グループ 'az networkcloud' はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus
Kubernetes クラスターのターゲット ノードを再起動します。
az networkcloud kubernetescluster restart-node --node-name
[--ids]
[--kubernetes-cluster-name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]
例
Kubernetes クラスター ノードを再起動する
az networkcloud kubernetescluster restart-node --node-name "nodeName" --kubernetes-cluster-name "kubernetesClusterName" --resource-group "resourceGroupName"
必須のパラメーター
再起動するノードの名前。
省略可能のパラメーター
1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。
Kubernetes クラスターの名前。
実行時間の長い操作の終了を待機しません。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az networkcloud kubernetescluster show
コマンド グループ 'az networkcloud' はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus
指定された Kubernetes クラスターのプロパティを取得します。
az networkcloud kubernetescluster show [--ids]
[--kubernetes-cluster-name]
[--resource-group]
[--subscription]
例
Kubernetes クラスターを取得する
az networkcloud kubernetescluster show --name "kubernetesClusterName" --resource-group "resourceGroupName"
省略可能のパラメーター
1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。
Kubernetes クラスターの名前。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az networkcloud kubernetescluster update
コマンド グループ 'az networkcloud' はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus
指定された Kubernetes クラスターのプロパティを更新するか、Kubernetes クラスターに関連付けられているタグを更新します。 プロパティとタグの更新を、個別に実行できます。
az networkcloud kubernetescluster update [--control-plane-node-configuration]
[--generate-ssh-keys {0, 1, f, false, n, no, t, true, y, yes}]
[--ids]
[--kubernetes-cluster-name]
[--kubernetes-version]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--ssh-dest-key-path]
[--ssh-key-values]
[--subscription]
[--tags]
例
Kubernetes クラスターにパッチを適用する
az networkcloud kubernetescluster update --name "kubernetesClusterName" --resource-group "resourceGroupName" --kubernetes-version "1.25.4" --control-plane-node-configuration count="3" --tags key1="myvalue1" key2="myvalue2"
Kubernetes クラスター管理者の資格情報を更新する
az networkcloud kubernetescluster update --name "kubernetesClusterName" --resource-group "resourceGroupName" --ssh-key-values 'ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgt5SjWU= admin@vm'
Kubernetes クラスター制御ノード管理者の資格情報を更新する
az networkcloud kubernetescluster update --name "kubernetesClusterName" --resource-group "resourceGroupName" --control-plane-node-configuration ssh-key-values="['ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgt5SjWU= admin@vm']"
省略可能のパラメーター
この Kubernetes クラスターにパッチを適用できるコントロール プレーンの定義特性。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。
SSH 公開キー ファイルおよび SSH 秘密キー ファイルがない場合は生成します。 キーは '~/.ssh' の下に格納されます。
1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。
Kubernetes クラスターの名前。
このクラスターの Kubernetes バージョン。 n.n、n.n.n、および n.n.n-n 形式を受け入れます。 使用される解釈されたバージョンは、作成または更新後にこのフィールドに解決されます。
実行時間の長い操作の終了を待機しません。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
ssh 公開キーへのスペース区切りパスの一覧。 ファイル パスは、指定することも、ディレクトリにすることもできます。 ディレクトリが指定されている場合は、見つかったすべての公開キー (.pub) の読み込みが試行されます。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。
スペース区切りの SSH 公開キーの一覧。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
既存のものを置き換える Azure リソース タグ。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az networkcloud kubernetescluster wait
コマンド グループ 'az networkcloud' はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus
条件が満たされるまで CLI を待機状態にします。
az networkcloud kubernetescluster wait [--created]
[--custom]
[--deleted]
[--exists]
[--ids]
[--interval]
[--kubernetes-cluster-name]
[--resource-group]
[--subscription]
[--timeout]
[--updated]
省略可能のパラメーター
'provisioningState' が 'Succeeded' で作成されるまで待ちます。
条件がカスタム JMESPath クエリを満たすまで待ちます。 例: provisioningState!='InProgress'、instanceView.statuses[?code=='PowerState/running']。
削除されるまで待ちます。
リソースが存在するまで待ちます。
1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。
ポーリング間隔 (秒単位)。
Kubernetes クラスターの名前。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
最大待機時間 (秒単位)。
provisioningState が 'Succeeded' で更新されるまで待ちます。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
Azure CLI