az arcdata dc

Nota

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

Crie, exclua e gerencie controladores de dados.

Comandos

Name	Description	Tipo	Estado
az arcdata dc config	Comandos de configuração.	Extensão	GA
az arcdata dc config add	Adicione um valor para um caminho json em um arquivo de configuração.	Extensão	GA
az arcdata dc config init	Inicialize um perfil de configuração do controlador de dados que possa ser usado com az arcdata dc createo .	Extensão	GA
az arcdata dc config list	Liste as opções de perfil de configuração disponíveis.	Extensão	GA
az arcdata dc config patch	Corrija um arquivo de configuração com base em um arquivo de patch json.	Extensão	GA
az arcdata dc config remove	Remova um valor para um caminho json em um arquivo de configuração.	Extensão	GA
az arcdata dc config replace	Substitua um valor para um caminho json em um arquivo de configuração.	Extensão	GA
az arcdata dc config show	Retornar a configuração do recurso personalizado do controlador de dados.	Extensão	GA
az arcdata dc create	Criar controlador de dados.	Extensão	GA
az arcdata dc debug	Depurar controlador de dados.	Extensão	GA
az arcdata dc debug controldb-cdc	Habilite/desabilite o CDC no banco de dados e tabelas do controlador de dados - apenas para fins de solução de problemas.	Extensão	GA
az arcdata dc debug copy-logs	Copie logs.	Extensão	GA
az arcdata dc debug dump	Disparar despejo de memória.	Extensão	GA
az arcdata dc debug restore-controldb-snapshot	Restaura uma cópia exclusiva do ControlDB do backup - apenas para fins de solução de problemas.	Extensão	GA
az arcdata dc delete	Excluir controlador de dados.	Extensão	GA
az arcdata dc endpoint	Comandos de ponto final.	Extensão	GA
az arcdata dc endpoint list	Liste o ponto de extremidade do controlador de dados.	Extensão	GA
az arcdata dc export	Exporte métricas, logs ou uso.	Extensão	GA
az arcdata dc list	Liste os controladores de dados do Azure Arc por grupo de recursos ou assinatura.	Extensão	GA
az arcdata dc list-upgrades	Liste as versões de atualização disponíveis.	Extensão	GA
az arcdata dc status	Comandos de status.	Extensão	GA
az arcdata dc status show	Mostrar o status do controlador de dados.	Extensão	GA
az arcdata dc update	Atualizar controlador de dados.	Extensão	GA
az arcdata dc upgrade	Atualize o controlador de dados.	Extensão	GA
az arcdata dc upload	Carregue o arquivo de dados exportado.	Extensão	GA

az arcdata dc create

Criar controlador de dados.

Criar controlador de dados - kube config é necessário em seu sistema, juntamente com credenciais para os painéis de monitoramento fornecidos pelas seguintes variáveis de ambiente - AZDATA_LOGSUI_USERNAME e AZDATA_LOGSUI_PASSWORD para o Painel de Logs, e AZDATA_METRICSUI_USERNAME e AZDATA_METRICSUI_PASSWORD para o Painel de Métricas. Como alternativa, AZDATA_USERNAME e AZDATA_PASSWORD serão usados como um fallback se algum conjunto de variáveis de ambiente estiver faltando. Ao usar argumentos direcionados a ARM, as seguintes variáveis de ambiente opcionais também são possíveis - WORKSPACE_ID para ID do Espaço de Trabalho do Log Analytics e WORKSPACE_SHARED_KEY para a Chave Primária do Log Analytics.

az arcdata dc create --connectivity-mode
                     --name
                     --resource-group
                     [--annotations]
                     [--auto-upload-logs {false, true}]
                     [--auto-upload-metrics {false, true}]
                     [--cluster-name]
                     [--custom-location]
                     [--image-tag]
                     [--infrastructure]
                     [--k8s-namespace]
                     [--labels]
                     [--location]
                     [--logs-ui-private-key-file]
                     [--logs-ui-public-key-file]
                     [--metrics-ui-private-key-file]
                     [--metrics-ui-public-key-file]
                     [--no-wait]
                     [--path]
                     [--profile-name]
                     [--service-annotations]
                     [--service-labels]
                     [--storage-annotations]
                     [--storage-class]
                     [--storage-labels]
                     [--use-k8s]

Exemplos

Implante um controlador de dados Arc por meio da API do Kubernetes (somente modo de conectividade indireta).

az arcdata dc create --name dc-name --k8s-namespace arc --connectivity-mode indirect --resource-group rg-name  --location eastasia --subscription subscription --use-k8s

Implante um controlador de dados Arc por meio do Azure Resource Manager (somente no modo de conectividade direta).

az arcdata dc create --name dc-name  --connectivity-mode direct --resource-group rg-name --location eastasia --subscription subscription  --custom-location arc-cl

Implante um controlador de dados Arc em um determinado cluster Kubernetes habilitado para Arc por meio de ARM (somente modo de conectividade direta). Este comando implantará a extensão de serviços de dados Arc e o local personalizado, caso ainda não existam.

az arcdata dc create --name dc-name --subscription subscription --resource-group rg-name  --cluster-name arc-cluster --connectivity-mode direct --custom-location arc-cl

Parâmetros Obrigatórios

--connectivity-mode

A conectividade com o Azure - indireta ou direta - na qual o controlador de dados deve operar.

--name -n

O nome do controlador de dados.

--resource-group -g

O grupo de recursos do Azure no qual o recurso do controlador de dados deve ser adicionado.

Parâmetros Opcionais

--annotations

Lista de anotações separadas por vírgulas para aplicar todos os recursos do controlador de dados.

--auto-upload-logs

Habilite os logs de upload automático.

valores aceites: false, true

--auto-upload-metrics

Habilite as métricas de carregamento automático.

valores aceites: false, true

--cluster-name

Nome do cluster Kubernetes.

--custom-location

O nome do local personalizado.

--image-tag

Arc data services image tag para usar para o controlador de dados.

--infrastructure

A infraestrutura na qual o controlador de dados será executado. Valores permitidos: ['aws', 'gcp', 'azure', 'alibaba', 'onpremises', 'other', 'auto'].

--k8s-namespace -k

O namespace Kubernetes no qual implantar o controlador de dados. Se já existir, será utilizado. Se não existir, será feita uma tentativa de criá-lo primeiro.

--labels

Lista de rótulos separados por vírgulas a serem aplicados a todos os recursos do controlador de dados.

--location -l

O local do Azure no qual os metadados do controlador de dados serão armazenados (por exemplo, eastus).

--logs-ui-private-key-file

Caminho para o arquivo que contém uma chave privada de certificado formatada PEM a ser usada para o ponto de extremidade do painel Logs UI.

--logs-ui-public-key-file

Caminho para o arquivo que contém um certificado formatado PEM a ser usado para o ponto de extremidade do painel Logs UI.

--metrics-ui-private-key-file

Caminho para o arquivo que contém uma chave privada de certificado formatada PEM a ser usada para o ponto de extremidade do painel Metrics UI.

--metrics-ui-public-key-file

Caminho para o arquivo que contém um certificado formatado PEM a ser usado para o ponto de extremidade do painel Metrics UI.

--no-wait

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

valor predefinido: False

--path -p

O caminho para um diretório que contém um perfil de configuração personalizado a ser usado. Execute az arcdata dc config init para criar um perfil de configuração personalizado.

--profile-name

O nome de um perfil de configuração existente. Execute az arcdata dc config list para ver as opções disponíveis. Um dos seguintes: ['azure-arc-ake', 'azure-arc-aks-default-storage', 'azure-arc-aks-hci', 'azure-arc-aks-premium-storage', 'azure-arc-azure-openshift', 'azure-arc-eks', 'azure-arc-gke', 'azure-arc-kubeadm', 'azure-arc-openshift', 'azure-arc-unit-test'].

--service-annotations

Lista de anotações separadas por vírgulas a aplicar a todos os serviços externos do controlador de dados.

--service-labels

Lista de etiquetas separadas por vírgulas a aplicar a todos os serviços externos do controlador de dados.

--storage-annotations

Lista de anotações separadas por vírgulas a serem aplicadas a todos os PVCs criados pelo controlador de dados.

--storage-class

A classe de armazenamento a ser usada para todos os dados e registra volumes persistentes para todos os pods do controlador de dados que os exigem.

--storage-labels

Lista de etiquetas separadas por vírgulas a aplicar a todos os PVC criados pelo controlador de dados.

--use-k8s

Crie um controlador de dados usando APIs locais do Kubernetes.

Parâmetros de Globais

--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

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

--verbose

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

az arcdata dc delete

Excluir controlador de dados.

Excluir controlador de dados - kube config é necessário no seu sistema.

az arcdata dc delete --name
                     [--force]
                     [--k8s-namespace]
                     [--no-wait]
                     [--resource-group]
                     [--use-k8s]
                     [--yes]

Exemplos

Exclua um controlador de dados por meio da API do Kubernetes.

az arcdata dc delete --name dc-name --k8s-namespace arc --use-k8s

Exclua um controlador de dados por meio do Azure Resource Manager (ARM).

az arcdata dc delete --name dc-name --resource-group rg-name

Parâmetros Obrigatórios

--name -n

Nome do controlador de dados.

Parâmetros Opcionais

--force -f

Forçar a exclusão do controlador de dados e todos os seus serviços de dados.

--k8s-namespace -k

O namespace Kubernetes no qual o controlador de dados existe.

--no-wait

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

valor predefinido: False

--resource-group -g

O grupo de recursos do Azure no qual o controlador de dados existe.

--use-k8s

Use APIs locais do Kubernetes para executar essa ação.

--yes -y

Exclua o controlador de dados sem solicitação de confirmação.

Parâmetros de Globais

--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

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

--verbose

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

az arcdata dc export

Exporte métricas, logs ou uso.

Exporte métricas, logs ou uso para um arquivo.

az arcdata dc export --k8s-namespace
                     --path
                     --type
                     [--force]
                     [--use-k8s]

Parâmetros Obrigatórios

--k8s-namespace -k

O namespace Kubernetes no qual o controlador de dados existe.

--path -p

O caminho completo ou relativo, incluindo o nome do arquivo a ser exportado.

--type -t

O tipo de dados a serem exportados. Opções: logs, métricas e uso.

Parâmetros Opcionais

--force -f

Forçar a criação do arquivo de saída. Substitui qualquer arquivo existente no mesmo caminho.

--use-k8s

Use APIs locais do Kubernetes para executar essa ação.

Parâmetros de Globais

--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

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

--verbose

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

az arcdata dc list

Liste os controladores de dados do Azure Arc por grupo de recursos ou assinatura.

az arcdata dc list [--resource-group]

Exemplos

Lista todos os controladores de dados Arc em um determinado grupo de recursos.

az arcdata dc list --resource-group rg-name

Lista todos os controladores de dados Arc na assinatura fornecida.

az arcdata dc list --subscription subscriptionId

Parâmetros Opcionais

--resource-group -g

O grupo de recursos do Azure que contém o(s) controlador(es) de dados Arc.

Parâmetros de Globais

--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

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

--verbose

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

az arcdata dc list-upgrades

Liste as versões de atualização disponíveis.

Tenta listar versões que estão disponíveis no registro de imagem do docker para atualização. - kube config é necessário no seu sistema, juntamente com as seguintes variáveis de ambiente ['AZDATA_USERNAME', 'AZDATA_PASSWORD'].

az arcdata dc list-upgrades --k8s-namespace
                            [--use-k8s]

Exemplos

Lista de atualização do controlador de dados.

az arcdata dc list-upgrades --k8s-namespace namespace --use-k8s

Parâmetros Obrigatórios

--k8s-namespace -k

O namespace Kubernetes no qual o controlador de dados existe.

Parâmetros Opcionais

--use-k8s

Liste as versões disponíveis do controlador de dados usando APIs locais do Kubernetes.

Parâmetros de Globais

--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

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

--verbose

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

az arcdata dc update

Atualizar controlador de dados.

Atualiza o controlador de dados para ativar/desativar o carregamento automático de logs e métricas.

az arcdata dc update [--auto-upload-logs {false, true}]
                     [--auto-upload-metrics {false, true}]
                     [--desired-version]
                     [--k8s-namespace]
                     [--maintenance-duration]
                     [--maintenance-enabled {false, true}]
                     [--maintenance-recurrence]
                     [--maintenance-start]
                     [--maintenance-time-zone]
                     [--name]
                     [--no-wait]
                     [--resource-group]
                     [--use-k8s]

Exemplos

Habilite o carregamento automático de logs por meio do Azure Resource Manager (ARM).

az arcdata dc update --auto-upload-logs true --name dc-name --resource-group rg-name

Habilite o upload automático de métricas por meio do ARM.

az arcdata dc update --auto-upload-metrics true --name dc-name --resource-group rg-name

Parâmetros Opcionais

--auto-upload-logs

Habilite os logs de upload automático.

valores aceites: false, true

--auto-upload-metrics

Habilite as métricas de carregamento automático.

valores aceites: false, true

--desired-version -v

A tag de versão desejada para a qual o controlador de dados será atualizado, ou vazia para usar a versão válida mais recente.

--k8s-namespace -k

O namespace Kubernetes com um controlador de dados implantado.

--maintenance-duration

Pré-visualizar

Duração da janela de manutenção padrão.

--maintenance-enabled

Pré-visualizar

Defina o sinalizador ativado na janela de manutenção padrão.

valores aceites: false, true

--maintenance-recurrence

Pré-visualizar

Intervalo recorrente para a janela de manutenção padrão.

--maintenance-start

Pré-visualizar

Data hora do início da primeira janela de manutenção padrão.

--maintenance-time-zone

Pré-visualizar

Fuso horário usado para calcular a janela de manutenção padrão.

--name -n

Nome do controlador de dados.

--no-wait

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

valor predefinido: False

--resource-group -g

O grupo de recursos do Azure no qual o controlador de dados existe.

--use-k8s

Use APIs locais do Kubernetes para executar essa ação.

Parâmetros de Globais

--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

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

--verbose

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

az arcdata dc upgrade

Atualize o controlador de dados.

Atualize o controlador de dados para a versão desejada especificada. Se a versão desejada não for especificada, será feita uma tentativa de atualização para a versão mais recente. Se não tiver certeza da versão desejada, você pode usar o comando list-upgrades para exibir as versões disponíveis ou usar o argumento --dry-run para mostrar qual versão seria usada.

az arcdata dc upgrade [--desired-version]
                      [--dry-run]
                      [--k8s-namespace]
                      [--name]
                      [--no-wait]
                      [--resource-group]
                      [--target]
                      [--use-k8s]

Exemplos

Atualização do controlador de dados.

az arcdata dc upgrade --k8s-namespace arc --use-k8s

Parâmetros Opcionais

--desired-version -v

A tag de versão desejada para a qual o controlador de dados será atualizado, ou vazia para usar a versão válida mais recente.

--dry-run -d

Indica qual instância seria atualizada, mas não atualiza as instâncias.

--k8s-namespace -k

O namespace Kubernetes no qual o controlador de dados existe.

--name -n

O nome do controlador de dados.

--no-wait

Se fornecido, o comando iniciará a atualização, mas não esperará que toda a atualização seja concluída. A atualização continuará em segundo plano.

valor predefinido: False

--resource-group -g

O grupo de recursos do Azure no qual o controlador de dados existe.

--target

Preterido

A opção '--target' foi preterida e será removida em uma versão futura. Use '--desired-version' em vez disso.

A tag de versão desejada para a qual o controlador de dados será atualizado, ou vazia para usar a versão válida mais recente.

--use-k8s

Atualize o controlador de dados usando APIs locais do Kubernetes.

Parâmetros de Globais

--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

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

--verbose

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

az arcdata dc upload

Carregue o arquivo de dados exportado.

Carregue o arquivo de dados exportado de um controlador de dados para o Azure.

az arcdata dc upload --path

Parâmetros Obrigatórios

--path -p

O caminho completo ou relativo, incluindo o nome do arquivo a ser carregado.

Parâmetros de Globais

--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

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

--verbose

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