Variáveis de Ambiente da CLI

A CLI do Oracle Cloud Infrastructure suporta o uso de variáveis de ambiente para especificar os valores padrão de algumas opções.

Variáveis de Ambiente

A tabela a seguir lista as variáveis de ambiente disponíveis e suas opções de CLI correspondentes ou entradas ~/.oci/config.

Variável de Ambiente Opção da CLI Entrada de configuração do OCI Descrição
OCI_CLI_PROFILE --profile Especificado por [DEFAULT] O perfil no arquivo de configuração do OCI a ser carregado. Esse perfil também será usado para localizar qualquer valor de parâmetro padrão que tenha sido especificado no arquivo de configuração específico da CLI do OCI.
OCI_CLI_USER n/a user

O OCID do usuário que chama a API. Para obter o valor, consulte Chaves e OCIDs Necessários.

Exemplo: ocid1.user.oc1..<unique_ID>

OCI_CLI_REGION --region region

Uma região do Oracle Cloud Infrastructure. Consulte Regiões e Domínios de Disponibilidade.

Exemplo: us-ashburn-1

OCI_CLI_FINGERPRINT n/a fingerprint

A impressão digital da chave pública que foi adicionada a este usuário. Para obter o valor, consulte Chaves e OCIDs Necessários.

Exemplo: 20:3b:97:13:55:1c:5b:0d:d3:37:d8:50:4e:c5:3a:34

OCI_CLI_KEY_FILE n/a key_file

O caminho completo e o nome do arquivo da chave privada.

Importante: O par de chaves deve estar no formato PEM. Para obter instruções sobre como gerar um par de chaves no formato PEM, consulte Chaves e OCIDs Necessários.

Se você tiver criptografado a chave com uma frase-senha, inclua também a entrada pass_phrase no arquivo de configuração.

Exemplo: ~/.oci/oci_api_key.pem

OCI_CLI_KEY_CONTENT n/a n/a O conteúdo completo da chave privada entre aspas simples. Importante: O par de chaves deve estar no formato PEM.

Exemplo: $ export OCI_CLI_KEY_CONTENT="$(</path/to/oci_api_key.pem)"

OCI_CLI_TENANCY n/a tenancy

O OCID da tenancy. Para obter o valor, consulte Chaves e OCIDs Necessários.

Exemplo: ocid1.tenancy.oc1..<unique_ID>

OCI_CLI_ENDPOINT --endpoint

Esse valor pode ser definido no arquivo de configuração específico da CLI do OCI. Consulte Configurando a CLI.

O valor a ser usado como ponto final de serviço, incluindo qualquer caminho obrigatório de versão da API.

Exemplo: https://iaas.us-phoenix-1.oracle.com/20160918

Observação: O parâmetro --region é a maneira recomendada de direcionar diferentes regiões.

OCI_CLI_CONFIG_FILE --config-file n/a O caminho para o arquivo de configuração do OCI.
OCI_CLI_RC_FILE --cli-rc-file n/a O caminho para o arquivo de configuração específico da CLI do OCI, contendo valores padrão de parâmetro e outras informações de configuração, como aliases de comando e consultas predefinidas. Para obter mais informações, consulte Configurando a CLI.
OCI_CLI_CERT_BUNDLE --cert-bundle n/a O caminho completo para um pacote de certificados da CA a ser usado para verificação de SSL.
OCI_CLI_AUTH --auth n/a

O tipo de autenticação a ser usada para a solicitação de API. Por padrão, a chave da API no arquivo de configuração será usada.

Os valores aceitos são: api_key, instance_obo_user, instance_principal, resource_principal, security_token

OCI_CLI_SECURITY_TOKEN_FILE n/a security_token_file O local do arquivo usado para autenticação baseada em token para a CLI.
HTTP_PROXY --proxy Esse valor pode ser definido no arquivo de configuração específico da CLI do OCI. Consulte Especificando um Servidor Proxy. O URL do servidor proxy HTTP a ser usado para enviar solicitações da CLI.
HTTPS_PROXY --proxy Esse valor pode ser definido no arquivo de configuração específico da CLI do OCI. Consulte Especificando um Servidor Proxy. O URL do servidor proxy HTTPS a ser usado para enviar solicitações da CLI.

Ordem de precedência

A CLI respeita e aplica configurações especificadas pela opção, variável de ambiente ou entrada do arquivo de configuração do OCI na seguinte ordem de precedência:

  1. O valor especificado na opção de comando.
  2. O valor especificado na variável de ambiente.
  3. O valor especificado no arquivo de configuração do OCI.