Documentation sur Oracle Cloud Infrastructure

Variables d'environnement de l'interface de ligne de commande

L'interface de ligne de commande Oracle Cloud Infrastructure prend également en charge l'utilisation de variables d'environnement pour spécifier les valeurs par défaut de certaines options.

Variables d'environnement

Le tableau suivant répertorie les variables d'environnement disponibles et leurs options d'interface de ligne de commande ou entrées ~/.oci/config correspondantes.

Variable d'environnement Option d'interface de ligne de commande Entrée de configuration OCI Description
OCI_CLI_PROFILE --profile Spécifié par [DEFAULT] Profil du fichier de configuration OCI à charger. Ce profil servira également à localiser les valeurs de paramètre par défaut qui ont été spécifiées dans le fichier de configuration propre à OCI CLI.
OCI_CLI_USER s.o. user

OCID de l'utilisateur appelant l'API. Pour obtenir la valeur, voir Clés et OCID requis.

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

Une région d'Oracle Cloud Infrastructure. Voir Régions et domaines de disponibilité.

Exemple : us-ashburn-1
OCI_CLI_FINGERPRINT s.o. fingerprint

Empreinte numérique de la clé publique qui a été ajoutée à cet utilisateur. Pour obtenir la valeur, voir Clés et OCID requis.

Exemple : 20:3b:97:13:55:1c:5b:0d:d3:37:d8:50:4e:c5:3a:34
OCI_CLI_KEY_FILE s.o. key_file

Chemin complet et nom du fichier de la clé privée.

Important : La paire de clés doit être au format PEM. Pour des instructions sur la génération d'une paire de clés dans le format PEM, voir Clés et OCID requis.

Si vous avez chiffré la clé avec une phrase secrète, vous devez également inclure l'entrée pass_phrase dans le fichier de configuration.

Exemple : ~/.oci/oci_api_key.pem
OCI_CLI_KEY_CONTENT s.o. n/a Contenu complet de la clé privée entre apostrophes. Important : La paire de clés doit être au format PEM.

Exemple : $ export OCI_CLI_KEY_CONTENT="$(</path/to/oci_api_key.pem)"
OCI_CLI_TENANCY s.o. tenancy

OCID de votre location. Pour obtenir la valeur, voir Clés et OCID requis.

Exemple : ocid1.tenancy.oc1..<unique_ID>
OCI_CLI_ENDPOINT --endpoint

Cette valeur peut être définie dans le fichier de configuration propre à l'interface de ligne de commande OCI. Voir Configuration de l'interface de ligne de commande.

Valeur à utiliser comme point d'extrémité de service, y compris tout chemin de version d'API requis.

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

Note : Le paramètre --region est le moyen recommandé pour cibler différentes régions.
OCI_CLI_CONFIG_FILE --config-file s.o. Chemin d'accès au fichier de configuration OCI.
OCI_CLI_RC_FILE --cli-rc-file s.o. Chemin d'accès au fichier de configuration propre à l'interface de ligne de commande OCI, contenant les valeurs par défaut des paramètres et d'autres informations de configuration telles que les alias de commandes et les interrogations prédéfinies. Pour plus d'informations, voir Configuration de l'interface de ligne de commande.
OCI_CLI_CERT_BUNDLE --cert-bundle s.o. Chemin d'accès complet à un ensemble de certificats d'autorité de certification à utiliser pour la vérification SSL.
OCI_CLI_AUTH --auth s.o.

Type d'autorisation à utiliser pour la demande d'API. Par défaut, la clé d'API de votre fichier de configuration sera utilisée.

Les valeurs acceptées sont : api_key, instance_obo_user, instance_principal, resource_principal, security_token
OCI_CLI_SECURITY_TOKEN_FILE s.o. security_token_file Emplacement du fichier utilisé pour l'authentification basée sur des jetons pour l'interface de ligne de commande.
HTTP_PROXY --proxy Cette valeur peut être définie dans le fichier de configuration propre à l'interface de ligne de commande OCI. Voir Définition d'un serveur mandataire. URL du serveur mandataire HTTP à utiliser pour les demandes d'interface de ligne de commande sortantes.
HTTPS_PROXY --proxy Cette valeur peut être définie dans le fichier de configuration propre à l'interface de ligne de commande OCI. Voir Définition d'un serveur mandataire. URL du serveur mandataire HTTPS à utiliser pour les demandes d'interface de ligne de commande sortantes.

Ordre de priorité

L'interface de ligne de commande respecte et applique les configurations spécifiées par une option, une variable d'environnement ou une entrée de fichier de configuration OCI dans l'ordre de priorité suivant :

  1. Valeur spécifiée dans l'option de commande.
  2. Valeur spécifiée dans la variable d'environnement.
  3. Valeur spécifiée dans le fichier de configuration OCI.