az aksarc

Note

Esta referência faz parte da extensão aksarc para o CLI do Azure (versão 2.77.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az aksarc . Saiba mais sobre extensões.

Gerencie clusters provisionados.

Comandos

Nome Descrição Tipo Estado
az aksarc create

Cria o cluster provisionado.

Extension disponibilidade geral
az aksarc delete

Exclui o cluster provisionado.

Extension disponibilidade geral
az aksarc deploy

Implante um cluster AKS baremetal completo em um ou mais hosts Arc-for-Servers (BareMetal) existentes.

Extension disponibilidade geral
az aksarc get-credentials

Obtenha kubeconfig local do cluster provisionado.

Extension disponibilidade geral
az aksarc get-logs

Colete logs de clusters provisionados e da infraestrutura subjacente.

Extension disponibilidade geral
az aksarc get-upgrades

Obtenha as versões de atualização disponíveis para o cluster provisionado.

Extension disponibilidade geral
az aksarc get-versions

Liste as versões suportadas do Kubernetes no local personalizado especificado.

Extension disponibilidade geral
az aksarc list

Lista os clusters provisionados em um grupo de recursos ou em uma assinatura.

Extension disponibilidade geral
az aksarc logs

Deprecated. Use 'az aksarc get-logs' em vez disso.

Extension disponibilidade geral
az aksarc logs hci

Colete logs de clusters provisionados e da infraestrutura subjacente.

Extension Deprecated
az aksarc nodepool

Gerencie pools de nós em um cluster provisionado.

Extension disponibilidade geral
az aksarc nodepool add

Adiciona um pool de nós no cluster provisionado.

Extension disponibilidade geral
az aksarc nodepool delete

Exclui o pool de nós no cluster provisionado.

Extension disponibilidade geral
az aksarc nodepool list

Lista todos os nodepools no cluster provisionado.

Extension disponibilidade geral
az aksarc nodepool scale

Dimensiona o pool de nós no cluster provisionado.

Extension disponibilidade geral
az aksarc nodepool show

Obtém o pool de nós no cluster provisionado.

Extension disponibilidade geral
az aksarc nodepool update

Atualize um pool de nós no cluster provisionado.

Extension disponibilidade geral
az aksarc notice

Saída do arquivo NOTICE para o caminho de arquivo especificado pelo usuário.

Extension disponibilidade geral
az aksarc release

Gerencie imagens VHD para clusters provisionados.

Extension Preview
az aksarc release download

Baixa as imagens VHD de uma versão.

Extension Preview
az aksarc release save

Provisiona as imagens VHD baixadas para a ponte de recursos do arco.

Extension Preview
az aksarc show

Obtém o cluster provisionado.

Extension disponibilidade geral
az aksarc undeploy

Desmontar um cluster de AKS baremetal anteriormente criado pelo 'az aksarc deploy'.

Extension disponibilidade geral
az aksarc update

Atualiza o cluster provisionado.

Extension disponibilidade geral
az aksarc upgrade

Atualiza o cluster provisionado.

Extension disponibilidade geral
az aksarc vmsize

Gerencie SKUs de máquinas virtuais para clusters provisionados.

Extension disponibilidade geral
az aksarc vmsize list

Lista os tamanhos de máquina virtual suportados no local personalizado especificado.

Extension disponibilidade geral
az aksarc vnet

Gerencie redes virtuais para clusters provisionados.

Extension disponibilidade geral
az aksarc vnet create

Cria a rede virtual.

Extension disponibilidade geral
az aksarc vnet delete

Exclui a rede virtual.

Extension disponibilidade geral
az aksarc vnet list

Lista as redes virtuais por grupo de recursos ou assinatura.

Extension disponibilidade geral
az aksarc vnet show

Obtém a rede virtual.

Extension disponibilidade geral

az aksarc create

Cria o cluster provisionado.

az aksarc create --custom-location
                 --name
                 --resource-group
                 --vnet-id --vnet-ids
                 [--aad-admin-group-object-ids]
                 [--acquire-policy-token]
                 [--ca-certs --custom-ca-trust-certificates]
                 [--ca-profile --cluster-autoscaler-profile]
                 [--change-reference]
                 [--control-plane-count --control-plane-node-count]
                 [--control-plane-ip]
                 [--control-plane-vm-size]
                 [--disable-nfs-driver]
                 [--disable-smb-driver]
                 [--enable-ahub]
                 [--enable-ai-toolchain-operator --enable-kaito]
                 [--enable-azure-rbac]
                 [--enable-cluster-autoscaler]
                 [--enable-oidc-issuer]
                 [--enable-wi --enable-workload-identity]
                 [--gateway-id]
                 [--generate-ssh-keys]
                 [--gpu-count-per-node]
                 [--kubernetes-version]
                 [--load-balancer-count]
                 [--location]
                 [--max-count]
                 [--max-pods]
                 [--min-count]
                 [--no-wait]
                 [--node-count]
                 [--node-vm-size]
                 [--nodepool-labels]
                 [--nodepool-taints]
                 [--pod-cidr]
                 [--ssh-auth-ips --ssh-authorized-ip-ranges]
                 [--ssh-key-value]
                 [--tags]
                 [--validate]

Exemplos

PutProvisionedCluster

az aksarc create --resource-group sample-rg --custom-location sample-cl --name sample-aksarccluster --vnet-ids "vnet-arm-id"

Parâmetros Obrigatórios

--custom-location

Nome ou ID do local personalizado a ser usado para o cluster provisionado.

--name -n

Nome do cluster provisionado.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--vnet-id --vnet-ids

ID de recurso ARM de rede virtual aksarc ou Azure Local logical network.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--aad-admin-group-object-ids -i

Lista separada por vírgulas de IDs de objeto de grupo aad que serão definidas como administrador de cluster no cluster provisionado.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--ca-certs --custom-ca-trust-certificates

Caminho para um ficheiro contendo certificados de confiança CA personalizados para o perfil de segurança. O ficheiro pode conter vários certificados em formato PEM (até 10). Cada certificado será codificado em base64 e adicionado ao trust store em todos os nós.

--ca-profile --cluster-autoscaler-profile

Lista separada por espaço de pares key=value para configurar o autoscaler de cluster. Passe uma cadeia de caracteres vazia para limpar o perfil.

--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--control-plane-count --control-plane-node-count

Número de nós do plano de controlo.

--control-plane-ip

Kubernetes APIServer IPAddress. O IPAddress deve ser roteável a partir do Azure Resource Bridge Appliance VM.It deve fazer parte da sub-rede de referência da rede. A criação do cluster pode falhar ou expirar se um IPAddress não roteável for ultrapassado.

--control-plane-vm-size

VM Tamanho do plano de controle.

--disable-nfs-driver

Desative o driver NFS para o cluster provisionado.

Propriedade Valor
Valor predefinido: False
--disable-smb-driver

Desative o driver SMB para o cluster provisionado.

Propriedade Valor
Valor predefinido: False
--enable-ahub

Ative o Azure Hybrid User Benefits (AHUB) para o cluster provisionado.

Propriedade Valor
Valor predefinido: False
--enable-ai-toolchain-operator --enable-kaito

Habilite o AI Toolchain Operator para o cluster provisionado.

Propriedade Valor
Valor predefinido: False
--enable-azure-rbac

Ative o Azure RBAC para controlar as verificações de autorização no cluster.

Propriedade Valor
Valor predefinido: False
--enable-cluster-autoscaler -e

Habilite o dimensionador automático de cluster para o cluster provisionado.

Propriedade Valor
Valor predefinido: False
--enable-oidc-issuer

Habilite o emissor OIDC.

Propriedade Valor
Valor predefinido: False
--enable-wi --enable-workload-identity

Habilite o addon de identidade da carga de trabalho.

Propriedade Valor
Valor predefinido: False
--gateway-id

ID do braço do gateway do cluster provisionado.

--generate-ssh-keys

Gere o par de chaves ssh se não estiver presente.

Propriedade Valor
Valor predefinido: False
--gpu-count-per-node

Número de GPUs ligadas a um nó.

--kubernetes-version -k

A versão kubernetes do cluster provisionado.

--load-balancer-count

Número de nós do balanceador de carga.

--location -l

Location. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--max-count

O número máximo de nós para dimensionamento automático.

--max-pods -m

Número máximo de pods que podem ser executados em um nó.

--min-count

O número mínimo de nós para dimensionamento automático.

--no-wait

Não espere que a operação de longa duração termine.

Propriedade Valor
Valor predefinido: False
--node-count -c

Número de nós a serem criados no pool de nós.

Propriedade Valor
Valor predefinido: 1
--node-vm-size

Tamanho da VM dos nós no pool de nós.

--nodepool-labels

Etiquetas separadas por espaço: key[=value] [key[=value] ...].

--nodepool-taints

Lista separada por vírgulas de manchas do pool de nós.

--pod-cidr

O IP de notação CIDR varia a partir do qual atribuir IPs pod.

--ssh-auth-ips --ssh-authorized-ip-ranges

Lista separada por vírgulas de endereços IP ou CIDR que têm permissão para ssh para a vm do cluster.

--ssh-key-value

Caminho para a chave pública ssh a ser injetada no plano de controle.

Propriedade Valor
Valor predefinido: ~\.ssh\id_rsa.pub
--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags existentes.

--validate

Valide os parâmetros de entrada do cluster sem realmente criar o cluster.

Propriedade Valor
Valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor predefinido: False

az aksarc delete

Exclui o cluster provisionado.

az aksarc delete --name
                 --resource-group
                 [--acquire-policy-token]
                 [--change-reference]
                 [--no-wait]
                 [--yes]

Exemplos

DeleteProvisionedCluster

az aksarc delete --name "sample-aksarccluster" --resource-group "sample-rg"

Parâmetros Obrigatórios

--name -n

Nome do cluster provisionado.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--no-wait

Não espere que a operação de longa duração termine.

Propriedade Valor
Valor predefinido: False
--yes -y

Não solicite confirmação.

Propriedade Valor
Valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor predefinido: False

az aksarc deploy

Implante um cluster AKS baremetal completo em um ou mais hosts Arc-for-Servers (BareMetal) existentes.

Implementa um cluster AKS baremetal completo num ou mais hosts Arc-for-Servers (BareMetal) existentes. A única entrada necessária é a lista de nomes de máquinas com Arc que compõem o cluster. Os hosts já devem estar ativados com Arc-for-Servers.

az aksarc deploy --arc-machine-name --arc-machine-names --machine-names
                 --resource-group
                 [--acquire-policy-token]
                 [--change-reference]
                 [--enable-wi --enable-workload-identity]
                 [--hci-rp-object-id]
                 [--kubernetes-version]
                 [--no-wait]
                 [--validate]
                 [--yes]

Exemplos

Implantar um cluster AKS baremetal de nó único

az aksarc deploy --resource-group sample-rg --arc-machine-names myArcHost

Implantar um cluster AKS baremetal multi-nós

az aksarc deploy --resource-group sample-rg --arc-machine-names host1 host2 host3

Implementar com suporte ao WorkloadIdentity ativado

az aksarc deploy --resource-group sample-rg --arc-machine-names myArcHost --enable-workload-identity

Implementar um bundle Kubernetes versionado específico

az aksarc deploy --resource-group sample-rg --arc-machine-names myArcHost --kubernetes-version 1.35.5-20260701

Deployar sem consulta Microsoft Graph

az aksarc deploy --resource-group sample-rg --arc-machine-names myArcHost --hci-rp-object-id <hci-rp-object-id>

Validar sem implementar

az aksarc deploy --resource-group sample-rg --arc-machine-names host1 host2 --validate

Parâmetros Obrigatórios

--arc-machine-name --arc-machine-names --machine-names -m

Nomes separados no espaço das máquinas existentes com Arc-enabled (Arc-for-Servers) no grupo de recursos para formar o pool de dispositivos do cluster. Forneça um para um pool de um só nó ou vários para um pool de múltiplos nós. Esta é a única entrada necessária; todos os outros recursos do cluster são derivados automaticamente.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--enable-wi --enable-workload-identity

Ativar a identidade da carga de trabalho e o emissor OIDC necessário para Operações IoT do Azure.

Propriedade Valor
Valor predefinido: False
--hci-rp-object-id

ID de objeto específico do inquilino da Microsoft. AzureStackHCI, principal de serviço fornecedor de recursos. Quando omitido, o CLI usa HCI_RP_OBJECT_ID se ativado, depois volta a Microsoft Graph.

--kubernetes-version -k

Kubernetes versionado para o cluster, como 1.35.5-20260701. Quando omitido, o operador AKS Arc seleciona a sua versão padrão atual.

--no-wait

Não espere que a operação de longa duração termine.

Propriedade Valor
Valor predefinido: False
--validate

Valida o modelo de implementação sem realmente implementar.

Propriedade Valor
Valor predefinido: False
--yes -y

Não solicite confirmação.

Propriedade Valor
Valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor predefinido: False

az aksarc get-credentials

Obtenha kubeconfig local do cluster provisionado.

az aksarc get-credentials --name
                          --resource-group
                          [--acquire-policy-token]
                          [--admin]
                          [--change-reference]
                          [--context]
                          [--file]
                          [--overwrite-existing]

Exemplos

GetAdminCredential

az aksarc get-credentials --name "sample-aksarccluster" --resource-group "sample-rg" --admin

GetAADUserCredential

az aksarc get-credentials --name "sample-aksarccluster" --resource-group "sample-rg"

Parâmetros Obrigatórios

--name -n

Nome do cluster provisionado.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--admin -a

Obtenha credenciais de administrador de cluster.

Propriedade Valor
Valor predefinido: False
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--context

Se especificado, substitua o nome de contexto padrão.

--file -f

Arquivo de configuração do Kubernetes a ser atualizado. Se não for fornecido, atualiza o arquivo '~/.kube/config'.

Propriedade Valor
Valor predefinido: ~\.kube\config
--overwrite-existing

Substitua qualquer entrada de cluster existente com o mesmo nome.

Propriedade Valor
Valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor predefinido: False

az aksarc get-logs

Colete logs de clusters provisionados e da infraestrutura subjacente.

az aksarc get-logs [--acquire-policy-token]
                   [--change-reference]
                   [--credentials-dir --ssh-key]
                   [--ip --ips]
                   [--kubeconfig]
                   [--out-dir]

Exemplos

Coletar logs com endereço IP e credenciais SSH

az aksarc get-logs --ip 192.168.200.31 192.168.200.32 --ssh-key ~/.ssh --out-dir ./logs

Colete logs com credenciais kubeconfig e SSH, kubeconfig é usado apenas para coletar endereços IP e caminho de arquivo ssh-key é usado em vez de diretório

az aksarc get-logs --kubeconfig ~/.kube/config --ssh-key ~/.ssh/id_rsa --out-dir ./logs

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--credentials-dir --ssh-key

Caminho para credenciais SSH para se conectar a nós, id_rsa arquivo ou diretório é aceito.

--ip --ips

Endereços IP de nós (nós de plano de controle ou nós de trabalho) dos quais os logs precisam ser coletados.

--kubeconfig

Caminho para o arquivo kubeconfig para se conectar ao cluster.

--out-dir

Diretório de saída para armazenar logs coletados. Se não for especificado, os logs serão armazenados no diretório atual.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor predefinido: False

az aksarc get-upgrades

Obtenha as versões de atualização disponíveis para o cluster provisionado.

az aksarc get-upgrades --name
                       --resource-group
                       [--acquire-policy-token]
                       [--change-reference]

Exemplos

Obtenha as versões de atualização disponíveis para o cluster provisionado AKS híbrido

az aksarc get-upgrades --name "samplecluster" --resource-group "sample-rg"

Parâmetros Obrigatórios

--name -n

Nome do cluster provisionado.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor predefinido: False

az aksarc get-versions

Liste as versões suportadas do Kubernetes no local personalizado especificado.

az aksarc get-versions --custom-location
                       [--acquire-policy-token]
                       [--change-reference]
                       [--resource-group]

Exemplos

VMListSkus

az aksarc get-versions -g sample-rg --custom-location sample-cl

Parâmetros Obrigatórios

--custom-location

Nome do local personalizado a ser usado para exibir as versões k8s suportadas.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor predefinido: False

az aksarc list

Lista os clusters provisionados em um grupo de recursos ou em uma assinatura.

az aksarc list [--resource-group]

Exemplos

ListProvisionedClusterByResourceGroup

az aksarc list --resource-group "sample-rg"

ListProvisionedClusterBySubscription

az aksarc list

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor predefinido: False

az aksarc notice

Saída do arquivo NOTICE para o caminho de arquivo especificado pelo usuário.

az aksarc notice --output-filepath
                 [--acquire-policy-token]
                 [--change-reference]

Exemplos

GetNoticeFile

az aksarc notice --output-filepath "./Notice"

Parâmetros Obrigatórios

--output-filepath

Caminho de arquivo de saída para o arquivo NOTICE.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor predefinido: False

az aksarc show

Obtém o cluster provisionado.

az aksarc show --name
               --resource-group

Exemplos

GetProvisionedCluster

az aksarc show --name "sample-aksarccluster" --resource-group "sample-rg"

Parâmetros Obrigatórios

--name -n

Nome do cluster provisionado.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor predefinido: False

az aksarc undeploy

Desmontar um cluster de AKS baremetal anteriormente criado pelo 'az aksarc deploy'.

Desmonta um cluster AKS baremetal anteriormente criado pelo 'az aksarc deploy', removendo todos os seus recursos associados. Se a desmontagem ficar incompleta, reexecute o comando para tentar novamente.

az aksarc undeploy --arc-machine-name --arc-machine-names --machine-names
                   --resource-group
                   [--acquire-policy-token]
                   [--change-reference]
                   [--yes]

Exemplos

Desimplantar os recursos do ARK AKS para as máquinas Arc em questão

az aksarc undeploy --resource-group sample-rg --arc-machine-names host1 host2 host3

Parâmetros Obrigatórios

--arc-machine-name --arc-machine-names --machine-names -m

Nomes separados por espaço das máquinas Arc cuja implementação do AKS Arc devem ser desmontados. Os nomes dos recursos são automaticamente derivados a partir deles.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--yes -y

Não solicite confirmação.

Propriedade Valor
Valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor predefinido: False

az aksarc update

Atualiza o cluster provisionado.

az aksarc update --name
                 --resource-group
                 [--aad-admin-group-object-ids]
                 [--acquire-policy-token]
                 [--ca-certs --custom-ca-trust-certificates]
                 [--ca-profile --cluster-autoscaler-profile]
                 [--change-reference]
                 [--control-plane-count --control-plane-node-count]
                 [--control-plane-vm-size]
                 [--disable-ahub]
                 [--disable-ai-toolchain-operator --disable-kaito]
                 [--disable-cluster-autoscaler]
                 [--disable-gateway]
                 [--disable-nfs-driver]
                 [--disable-smb-driver]
                 [--enable-ahub]
                 [--enable-ai-toolchain-operator --enable-kaito]
                 [--enable-cluster-autoscaler]
                 [--enable-nfs-driver]
                 [--enable-smb-driver]
                 [--gateway-id]
                 [--max-count]
                 [--min-count]
                 [--tags]
                 [--update-cluster-autoscaler]
                 [--yes]

Exemplos

UpdateProvisionedCluster

az aksarc update --tags additionalProperties="sample" --name "sample-aksarccluster" --resource-group "sample-rg"

Ative a funcionalidade Azure Hybrid User Benefits para um cluster provisionado.

az aksarc update --name "sample-aksarccluster" --resource-group "sample-rg" --enable-ahub

Desative a funcionalidade Azure Hybrid User Benefits para um cluster provisionado.

az aksarc update --name "sample-aksarccluster" --resource-group "sample-rg"--disable-ahub

Aumente a escala dos nós do plano de controle.

az aksarc update --name "sample-aksarccluster" --resource-group "sample-rg" --control-plane-node-count 5

Parâmetros Obrigatórios

--name -n

Nome do cluster provisionado.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--aad-admin-group-object-ids -i

Lista separada por vírgulas de IDs de objeto de grupo aad que serão definidas como administrador de cluster no cluster provisionado.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--ca-certs --custom-ca-trust-certificates

Caminho para um ficheiro contendo certificados de confiança CA personalizados para o perfil de segurança. O ficheiro pode conter vários certificados em formato PEM (até 10). Cada certificado será codificado em base64 e adicionado ao trust store em todos os nós.

--ca-profile --cluster-autoscaler-profile

Lista separada por espaço de pares key=value para configurar o autoscaler de cluster. Passe uma cadeia de caracteres vazia para limpar o perfil.

--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--control-plane-count --control-plane-node-count

Número de nós para o qual dimensionar o Plano de Controle.

--control-plane-vm-size

VM Tamanho do plano de controle.

--disable-ahub

Desative o Azure Hybrid User Benefits (AHUB) para o cluster provisionado.

Propriedade Valor
Valor predefinido: False
--disable-ai-toolchain-operator --disable-kaito

Desative o AI Toolchain Operator para o cluster provisionado.

Propriedade Valor
Valor predefinido: False
--disable-cluster-autoscaler -d

Desative o dimensionador automático de cluster para o cluster provisionado.

Propriedade Valor
Valor predefinido: False
--disable-gateway

Desative o gateway para o cluster provisionado.

Propriedade Valor
Valor predefinido: False
--disable-nfs-driver

Desative o driver NFS para o cluster provisionado.

Propriedade Valor
Valor predefinido: False
--disable-smb-driver

Desative o driver SMB para o cluster provisionado.

Propriedade Valor
Valor predefinido: False
--enable-ahub

Ative o Azure Hybrid User Benefits (AHUB) para o cluster provisionado.

Propriedade Valor
Valor predefinido: False
--enable-ai-toolchain-operator --enable-kaito

Habilite o AI Toolchain Operator para o cluster provisionado.

Propriedade Valor
Valor predefinido: False
--enable-cluster-autoscaler -e

Habilite o dimensionador automático de cluster para o cluster provisionado.

Propriedade Valor
Valor predefinido: False
--enable-nfs-driver

Habilite o driver NFS para o cluster provisionado.

Propriedade Valor
Valor predefinido: False
--enable-smb-driver

Habilite o driver SMB para o cluster provisionado.

Propriedade Valor
Valor predefinido: False
--gateway-id

ID do braço do gateway do cluster provisionado.

--max-count

O número máximo de nós para dimensionamento automático.

--min-count

O número mínimo de nós para dimensionamento automático.

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags existentes.

--update-cluster-autoscaler -u

Atualize o dimensionador automático do cluster para o cluster provisionado.

Propriedade Valor
Valor predefinido: False
--yes -y

Não solicite confirmação.

Propriedade Valor
Valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor predefinido: False

az aksarc upgrade

Atualiza o cluster provisionado.

az aksarc upgrade --name
                  --resource-group
                  [--acquire-policy-token]
                  [--change-reference]
                  [--kubernetes-version]
                  [--no-wait]
                  [--yes]

Exemplos

UpgradeProvisionedCluster

az aksarc upgrade --name "sample-aksarccluster" --resource-group "sample-rg" --kubernetes-version "1.22.2"

Parâmetros Obrigatórios

--name -n

Nome do cluster provisionado.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--kubernetes-version -k

A versão kubernetes do cluster provisionado.

--no-wait

Não espere que a operação de longa duração termine.

Propriedade Valor
Valor predefinido: False
--yes

Sinalize para desativar os prompts de confirmação.

Propriedade Valor
Valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor predefinido: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor predefinido: False
--output -o

Formato de saída.

Propriedade Valor
Valor predefinido: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor predefinido: False