Documentazione dell'infrastruttura Oracle Cloud

Variabili d'ambiente CLI

L'interfaccia CLI di Oracle Cloud Infrastructure supporta l'uso di variabili di ambiente per specificare i valori predefiniti per alcune opzioni.

Variabili di ambiente

Nella tabella seguente sono elencate le variabili di ambiente disponibili e le opzioni CLI corrispondenti o le voci ~/.oci/config.

Variabile d'ambiente opzione CLI Voce di configurazione OCI Descrizione
OCI_CLI_PROFILE --profile Specificata da [DEFAULT] Profilo nel file di configurazione OCI da caricare. Questo profilo verrà utilizzato anche per individuare i valori dei parametri predefiniti specificati nel file di configurazione specifico dell'interfaccia CLI OCI.
OCI_CLI_USER n/d user

OCID dell'utente che chiama l'API. Per ottenere il valore, vedere Chiavi e OCID obbligatori.

Esempio: ocid1.user.oc1..<unique_ID>
OCI_CLI_REGION --region region

Un'area Oracle Cloud Infrastructure. Vedere Region and Availability Domains.

Esempio: us-ashburn-1
OCI_CLI_FINGERPRINT n/d fingerprint

L'impronta digitale della chiave pubblica aggiunta a questo utente. Per ottenere il valore, vedere Chiavi e OCID obbligatori.

Esempio: 20:3b:97:13:55:1c:5b:0d:d3:37:d8:50:4e:c5:3a:34
OCI_CLI_KEY_FILE n/d key_file

Il percorso completo e il nome file della chiave privata.

Importante: la coppia di chiavi deve essere in formato PEM. Per istruzioni sulla generazione di una coppia di chiavi in formato PEM, vedere Chiavi e OCID richiesti.

Se la chiave è stata cifrata con una passphrase, è necessario includere anche la voce pass_phrase nel file di configurazione.

Esempio: ~/.oci/oci_api_key.pem
OCI_CLI_KEY_CONTENT n/d n/a Il contenuto completo della chiave privata racchiuso tra apici. Importante: la coppia di chiavi deve essere in formato PEM.

Esempio: $ export OCI_CLI_KEY_CONTENT="$(</path/to/oci_api_key.pem)"
OCI_CLI_TENANCY n/d tenancy

OCID della tenancy. Per ottenere il valore, vedere Chiavi e OCID obbligatori.

Esempio: ocid1.tenancy.oc1..<unique_ID>
OCI_CLI_PASSPHRASE n/d pass_phrase

Passphrase utilizzata per la chiave, se cifrata.
OCI_CLI_ENDPOINT --endpoint

Questo valore può essere impostato nel file di configurazione specifico dell'interfaccia CLI OCI. Vedere Configuring the CLI.

Valore da utilizzare come endpoint del servizio, incluso qualsiasi percorso di versione API richiesto.

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

Nota: il parametro --region è il metodo consigliato per indirizzare aree diverse.
OCI_CLI_CONFIG_FILE --config-file n/d Il percorso del file di configurazione OCI.
OCI_CLI_RC_FILE --cli-rc-file n/d Percorso del file di configurazione specifico dell'interfaccia CLI OCI, contenente i valori predefiniti dei parametri e altre informazioni di configurazione, come gli alias dei comandi e le query predefinite. Per ulteriori informazioni, vedere Configuring the CLI.
OCI_CLI_CERT_BUNDLE --cert-bundle n/d Percorso completo di un bundle di certificati CA da utilizzare per la verifica SSL.
OCI_CLI_AUTH --auth n/d

Il tipo di autenticazione da utilizzare per la richiesta API. Per impostazione predefinita, verrà utilizzata la chiave API nel file di configurazione.

I valori accettati sono: api_key, instance_obo_user, instance_principal, resource_principal, security_token
OCI_CLI_SECURITY_TOKEN_FILE n/d security_token_file Posizione del file utilizzato per l'autenticazione basata su token per l'interfaccia CLI.
HTTP_PROXY --proxy Questo valore può essere impostato nel file di configurazione specifico dell'interfaccia CLI OCI. Vedere Specifica di un server proxy. URL del server proxy HTTP da utilizzare per le richieste dell'interfaccia CLI in uscita.
HTTPS_PROXY --proxy Questo valore può essere impostato nel file di configurazione specifico dell'interfaccia CLI OCI. Vedere Specifica di un server proxy. URL del server proxy HTTPS da utilizzare per le richieste della CLI in uscita.

Ordine di prevalenza

L'interfaccia CLI rispetta e applica le configurazioni specificate dall'opzione, dalla variabile di ambiente o dall'immissione del file di configurazione OCI nel seguente ordine di precedenza:

  1. Il valore specificato nell'opzione di comando.
  2. Il valore specificato nella variabile di ambiente.
  3. Il valore specificato nel file di configurazione OCI.