api grupo de comando

Observação

Esta informação se aplica às versões 0.205 e acima do Databricks CLI, que estão em Public Preview. Para encontrar sua versão da CLI do Databricks, execute databricks -v.

O grupo de comandos api na CLI do Databricks permite chamar qualquer API REST do Databricks disponível.

Você deve executar o comando api apenas para cenários avançados, como versões de visualização de APIs REST específicas do Databricks para as quais a CLI do Databricks ainda não envolve a API REST do Databricks de destino em um comando relacionado. Para obter uma lista de grupos de comandos agrupados, consulte Comando CLI do Databricks.

Importante

Antes de usar a CLI do Databricks, certifique-se de configurar a CLI do Databricks e configurar a autenticação para a CLI do Databricks.

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

Você executa api comandos anexando-os a databricks api. Para exibir ajuda para o comando api , execução 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 para a API REST do Databricks que você deseja chamar, como delete, get, head, path, post ou put. Por exemplo, para retornar a lista de clusters disponíveis para um workspace, use get. Para obter o método HTTP correto para a API REST do Databricks que você deseja chamar, consulte a documentação da API REST do Databricks.

  • Substitua <rest-api-path> pelo caminho para a API REST do Databricks que você deseja chamar. Não inclua https:// ou o nome da instância workspace . Por exemplo, para retornar a lista de clusters disponíveis para um workspace, use /api/2.0/clusters/list. Para obter a sintaxe correta para a API REST do Databricks que você deseja chamar, consulte a documentação da API REST do Databricks.

  • Se a API REST do Databricks que você 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, você pode armazenar o corpo da solicitação em um arquivo JSON separado. Para fazer isso, inclua --json e @<filename>, substituindo <filename> pelo nome do arquivo JSON. Para obter a sintaxe correta para o corpo da solicitação que você deseja incluir, consulte a documentação da API REST do Databricks.

Exemplos

Obtenha a lista de clusters disponíveis no workspace.

databricks api get /api/2.0/clusters/list

Obtenha informações sobre os clusters especificados no workspace.

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

Atualize as configurações para os clusters especificados no workspace.

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": "i3.xlarge"
}'

Atualize as configurações para os clusters especificados no workspace. Obtenha o corpo da solicitação de um arquivo denominado edit-cluster.json no diretório de trabalho atual.

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

edit-cluster.json:

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