Compartilhar via

az arcdata dc config

Note

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

Comandos de configuração.

Comandos

Nome Description Tipo Status
az arcdata dc config add

Adicione um valor para um caminho json em um arquivo de configuração.

 Extension GA
az arcdata dc config init

Inicialize um perfil de configuração do controlador de dados que pode ser usado com az arcdata dc create.

 Extension GA
az arcdata dc config list

Listar opções de perfil de configuração disponíveis.

 Extension GA
az arcdata dc config patch

Corrija um arquivo de configuração com base em um arquivo de patch json.

 Extension GA
az arcdata dc config remove

Remova um valor para um caminho json em um arquivo de configuração.

 Extension GA
az arcdata dc config replace

Substitua um valor por um caminho json em um arquivo de configuração.

 Extension GA
az arcdata dc config show

Retorne a configuração do recurso personalizado do controlador de dados.

 Extension GA

az arcdata dc config add

Adicione um valor para um caminho json em um arquivo de configuração.

Adicione o valor no caminho json no arquivo de configuração. Todos os exemplos abaixo são dados no Bash. Se estiver usando outra linha de comando, talvez seja necessário executar escapequotations adequadamente. Como alternativa, você pode usar a funcionalidade de arquivo de patch.

az arcdata dc config add --config-file
                         --json-values
                         --path

Exemplos

Adicionar armazenamento do controlador de dados.

az arcdata dc config add --path custom/control.json --json-values 'spec.storage={"accessMode":"ReadWriteOnce","className":"managed-premium","size":"10Gi"}'

Parâmetros Exigidos

--config-file -c
Preterido

A opção '-c' foi preterida e será removida em uma versão futura. Em vez disso, use '-p'.

Caminho do arquivo de configuração do controlador de dados da configuração que você gostaria de definir, ou seja, personalizado/control.json.

--json-values -j

Uma lista de pares de valores chave de caminhos json para valores: key1.subkey1=value1,key2.subkey2=value2. Você pode fornecer valores json embutidos, como: key='{"kind":"cluster","name":"test-cluster"}' ou fornecer um caminho de arquivo, como key=./values.json. O comando add não dá suporte a condicionales. Se o valor embutido que você está fornecendo for um par de valor de chave em si com "=" e "", escape desses caracteres. Por exemplo, key1="key2=val2,key3=val3". Consulte http://jsonpatch.com/ para obter exemplos de como seu caminho deve ser. Se você quiser acessar uma matriz, deverá fazer isso indicando o índice, como key.0=value.

--path -p

Caminho do arquivo de configuração do controlador de dados da configuração que você gostaria de definir, ou seja, personalizado/control.json.

Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az arcdata dc config init

Inicialize um perfil de configuração do controlador de dados que pode ser usado com az arcdata dc create.

Inicialize um perfil de configuração do controlador de dados que pode ser usado com az arcdata dc create. A origem específica do perfil de configuração pode ser especificada nos argumentos.

az arcdata dc config init [--force]
                          [--path]
                          [--source]
                          [--target]

Exemplos

Experiência de configuração de configuração do controlador de dados guiada – você receberá prompts para os valores necessários.

az arcdata dc config init

arcdata dc config init com argumentos, cria um perfil de configuração do aks-dev-test em ./custom.

az arcdata dc config init --source azure-arc-kubeadm --path custom

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--force -f

Force a substituição do arquivo de destino.

--path -p

O caminho do arquivo de onde você gostaria que o perfil de configuração fosse colocado, é padrão para cwd/custom.

--source -s

Fonte do perfil de configuração: ['azure-arc-ake', 'azure-arc-aks-default-storage', 'azure-arc-aks-dev-test', 'azure-arc-aks-hci', 'azure-arc-aks-premium-storage', 'azure-arc-azure-openshift', 'azure-arc-eks', 'azure-arc-gke', 'azure-arc-kubeadm', 'azure-arc-kubeadm-dev-test', 'azure-arc-openshift', 'azure-arc-unit-test'].

--target -t
Preterido

A opção '-t' foi preterida e será removida em uma versão futura. Em vez disso, use '-p'.

O caminho do arquivo de onde você gostaria que o perfil de configuração fosse colocado, é padrão para cwd/custom.

Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az arcdata dc config list

Listar opções de perfil de configuração disponíveis.

Listar opções de perfil de configuração disponíveis para uso no arcdata dc config init.

az arcdata dc config list [--config-profile]

Exemplos

Mostra todos os nomes de perfil de configuração disponíveis.

az arcdata dc config list

Mostra o json de um perfil de configuração específico.

az arcdata dc config list --config-profile aks-dev-test

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--config-profile -c

Perfil de configuração padrão: ['azure-arc-ake', 'azure-arc-aks-default-storage', 'azure-arc-aks-dev-test', 'azure-arc-aks-hci', 'azure-arc-aks-premium-storage', 'azure-arc-azure-openshift', 'azure-arc-eks', 'azure-arc-gke', 'azure-arc-kubeadm', 'azure-arc-kubeadm-dev-test', 'azure-arc-openshift', 'azure-arc-unit-test'].

Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az arcdata dc config patch

Corrija um arquivo de configuração com base em um arquivo de patch json.

Corrija o arquivo de configuração de acordo com o arquivo de patch especificado. Consulte http://jsonpatch.com/ para obter uma melhor compreensão de como os caminhos devem ser compostos. A operação de substituição pode usar condicionalmente em seu caminho devido à biblioteca jsonpath https://jsonpath.com/. Todos os arquivos json de patch devem começar com uma chave de "patch" que tenha uma matriz de patches com sua operação correspondente (adicionar, substituir, remover), caminho e valor. A operação "remove" não requer um valor, apenas um caminho. Veja os exemplos abaixo.

az arcdata dc config patch --config-file
                           --patch-file
                           --path

Exemplos

Ex 1 - Substitua a porta de um único ponto de extremidade (Ponto de Extremidade do Controlador de Dados) por um arquivo de patch.

az arcdata dc config patch --path custom/control.json --patch ./patch.json

    Patch File Example (patch.json):
        {"patch":[{"op":"replace","path":"$.spec.endpoints[?(@.name=='Controller')].port","value":30080}]}

Ex 2 – Substituir o armazenamento do controlador de dados por um arquivo de patch.

az arcdata dc config patch --path custom/control.json --patch ./patch.json

    Patch File Example (patch.json):
        {"patch":[{"op":"replace","path":".spec.storage","value":{"accessMode":"ReadWriteMany","className":"managed-premium","size":"10Gi"}}]}

Parâmetros Exigidos

--config-file -c
Preterido

A opção '-c' foi preterida e será removida em uma versão futura. Em vez disso, use '--path'.

Caminho do arquivo de configuração do controlador de dados da configuração que você gostaria de definir, ou seja, personalizado/control.json.

--patch-file -p

Caminho para um arquivo json de patch baseado na biblioteca jsonpatch: http://jsonpatch.com/. Você deve iniciar o arquivo json do patch com uma chave chamada "patch", cujo valor é uma matriz de operações de patch que você pretende fazer. Para o caminho de uma operação de patch, você pode usar a notação de ponto, como key1.key2 para a maioria das operações. Se você quiser fazer uma operação de substituição e estiver substituindo um valor em uma matriz que exija uma condicional, use a notação jsonpath iniciando seu caminho por $. Isso permitirá que você faça uma condicional como $.key1.key2[?( @.key3=="someValue"].key4. Veja os exemplos abaixo. Para obter ajuda adicional com condicionais, consulte: https://jsonpath.com/.

--path

Caminho do arquivo de configuração do controlador de dados da configuração que você gostaria de definir, ou seja, personalizado/control.json.

Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az arcdata dc config remove

Remova um valor para um caminho json em um arquivo de configuração.

Remova o valor no caminho json no arquivo de configuração. Todos os exemplos abaixo são dados no Bash. Se estiver usando outra linha de comando, talvez seja necessário executar escapequotations adequadamente. Como alternativa, você pode usar a funcionalidade de arquivo de patch.

az arcdata dc config remove --config-file
                            --json-path
                            --path

Exemplos

Ex 1 – Remover o armazenamento do controlador de dados.

az arcdata dc config remove --path custom/control.json --json-path '.spec.storage'

Parâmetros Exigidos

--config-file -c
Preterido

A opção '-c' foi preterida e será removida em uma versão futura. Em vez disso, use '-p'.

Caminho do arquivo de configuração do controlador de dados da configuração que você gostaria de definir, ou seja, personalizado/control.json.

--json-path -j

Uma lista de caminhos json com base na biblioteca jsonpatch que indica quais valores você gostaria de remover, como: key1.subkey1,key2.subkey2. O comando remove não dá suporte a condicionales. Consulte http://jsonpatch.com/ para obter exemplos de como seu caminho deve ser. Se você quiser acessar uma matriz, deverá fazer isso indicando o índice, como key.0=value.

--path -p

Caminho do arquivo de configuração do controlador de dados da configuração que você gostaria de definir, ou seja, personalizado/control.json.

Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az arcdata dc config replace

Substitua um valor por um caminho json em um arquivo de configuração.

Substitua o valor no caminho json no arquivo de configuração. Todos os exemplosbelow são dados no Bash. Se estiver usando outra linha de comando, talvez seja necessário executar escapequotations adequadamente. Como alternativa, você pode usar a funcionalidade de arquivo de patch.

az arcdata dc config replace --config-file
                             --json-values
                             --path

Exemplos

Ex 1 – substituir a porta de um único ponto de extremidade (ponto de extremidade do controlador de dados).

az arcdata dc config replace --path custom/control.json --json-values '$.spec.endpoints[?(@.name=="Controller")].port=30080'

Ex 2 – Substituir o armazenamento do controlador de dados.

az arcdata dc config replace --path custom/control.json --json-values 'spec.storage={"accessMode":"ReadWriteOnce","className":"managed-premium","size":"10Gi"}'

Parâmetros Exigidos

--config-file -c
Preterido

A opção '-c' foi preterida e será removida em uma versão futura. Em vez disso, use '-p'.

Caminho do arquivo de configuração do controlador de dados da configuração que você gostaria de definir, ou seja, personalizado/control.json.

--json-values -j

Uma lista de pares de valores chave de caminhos json para valores: key1.subkey1=value1,key2.subkey2=value2. Você pode fornecer valores json embutidos, como: key='{"kind":"cluster","name":"test-cluster"}' ou fornecer um caminho de arquivo, como key=./values.json. O comando replace dá suporte a condicionales por meio da biblioteca jsonpath. Para usar isso, inicie seu caminho com um $. Isso permitirá que você faça uma condicional, como -j $.key1.key2[?( @.key3=="someValue"].key4=value. Se o valor embutido que você está fornecendo for um par de valor de chave em si com "=" e "", escape desses caracteres. Por exemplo, key1="key2=val2,key3=val3". Você pode ver exemplos abaixo. Para obter ajuda adicional, consulte: https://jsonpath.com/.

--path -p

Caminho do arquivo de configuração do controlador de dados da configuração que você gostaria de definir, ou seja, personalizado/control.json.

Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az arcdata dc config show

Retorne a configuração do recurso personalizado do controlador de dados.

az arcdata dc config show [--k8s-namespace]
                          [--use-k8s]

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--k8s-namespace -k

O namespace do Kubernetes no qual o controlador de dados existe.

--use-k8s

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

Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False