api grupo de comando

nota

Essas informações se aplicam ao site Databricks CLI versões 0.205 e superiores. A CLI da Databricks está em visualização pública.

Databricks CLI O uso está sujeito à LicençaDatabricks e ao Aviso de PrivacidadeDatabricks, incluindo qualquer provisionamento de Dados de Uso.

O grupo de comando api dentro do Databricks CLI permite que o senhor chame qualquer Databricks REST API disponível.

O senhor deve executar o comando api somente para cenários avançados, como versões prévias de Databricks REST APIs específicos para os quais o Databricks CLI ainda não envolve o alvo Databricks REST API dentro de um comando relacionado. Para obter uma lista de grupos de comando agrupados, consulte Databricks CLI comando.

Para instalar a CLI da Databricks, consulte Instalar ou atualizar a CLI da Databricks. Para configurar a autenticação para a CLI do Databricks, consulte Autenticação para a CLI do Databricks.

execução api comando (somente para cenários avançados)

O senhor executa api comando anexando-os a databricks api. Para exibir a ajuda do comando api, execute databricks api -h.

Para chamar o comando api, use o seguinte formato:

databricks api <http-method> <rest-api-path> [--json {<request-body> | @<filename>}]

Na chamada anterior:

• Substitua <http-method> pelo método HTTP da API REST da Databricks que o senhor deseja chamar, como delete, get, head, path, post, ou put. Por exemplo, para retornar a lista de clustering disponível para um workspace, use get. Para obter o método HTTP correto para a API REST da Databricks que o senhor deseja chamar, consulte a documentação da API REST da Databricks.
• Substitua <rest-api-path> pelo caminho para a API REST da Databricks que o senhor deseja chamar. Não inclua https:// ou o nome da instância workspace. Por exemplo, para retornar a lista de clustering disponível para um workspace, use /api/2.0/clusters/list. Para obter a sintaxe correta para a API REST da Databricks que o senhor deseja chamar, consulte a documentação da API REST da Databricks.
• Se a API REST da Databricks que o senhor deseja chamar exigir um corpo de solicitação, inclua --json e <request-body>, substituindo <request-body> pelo corpo da solicitação no formato JSON. Como alternativa, o senhor pode armazenar o corpo da solicitação em um arquivo JSON separado. Para isso, inclua --json e @<filename>, substituindo <filename> pelo nome do arquivo JSON. Para obter a sintaxe correta para o corpo da solicitação que o senhor deseja incluir, consulte a documentação da API REST da Databricks.

Exemplos

Obtenha a lista de clusters disponíveis no site workspace.

Bash

databricks api get /api/2.0/clusters/list

Obtenha informações sobre o clustering especificado no site workspace.

Bash

databricks api post /api/2.0/clusters/get --json '{
   "cluster_id": "1234-567890-abcde123"
}'

Atualizar as configurações do clustering especificado no site workspace.

Bash

databricks api post /api/2.0/clusters/edit --json '{
  "cluster_id": "1234-567890-abcde123",
  "cluster_name": "my-changed-cluster",
  "num_workers": 1,
  "spark_version": "11.3.x-scala2.12",
  "node_type_id": "n2-highmem-4"
}'

Atualizar as configurações do clustering especificado no site workspace. Obtenha o corpo da solicitação de um arquivo chamado edit-cluster.json no diretório de trabalho atual.

Bash

databricks api post /api/2.0/clusters/edit --json @edit-cluster.json

edit-cluster.json:

JSON

{
  "cluster_id": "1234-567890-abcde123",
  "cluster_name": "my-changed-cluster",
  "num_workers": 1,
  "spark_version": "11.3.x-scala2.12",
  "node_type_id": "n2-highmem-4"
}