Documentation Oracle Cloud Infrastructure

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

L'interface de ligne de commande Oracle Cloud Infrastructure prend 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, ainsi que les options et les 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 à charger. Ce profil servira également à rechercher les valeurs de paramètre par défaut qui ont été spécifiées dans le fichier de configuration propre à l'interface de ligne de commande OCI.
OCI_CLI_USER N/A user

OCID de l'utilisateur appelant l'API. Pour obtenir la valeur, reportez-vous à Clés et OCID requis.

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

Région Oracle Cloud Infrastructure. Reportez-vous à Régions et domaines de disponibilité.

Exemple : us-ashburn-1
OCI_CLI_FINGERPRINT N/A fingerprint

Empreinte de la clé publique ajoutée à cet utilisateur. Pour obtenir la valeur, reportez-vous à 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 N/A key_file

Nom de fichier et chemin complet de la clé privée.

Important : la paire de clés doit être au format PEM. Pour obtenir des instructions sur la génération d'une paire de clés au format PEM, reportez-vous à Clés et OCID requis.

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

Exemple : ~/.oci/oci_api_key.pem
OCI_CLI_KEY_CONTENT N/A 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 N/A tenancy

OCID de votre location. Pour obtenir la valeur, reportez-vous à Clés et OCID requis.

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

Vous pouvez définir cette valeur dans le fichier de configuration propre à l'interface de ligne de commande OCI. Reportez-vous à Configuration de l'interface de ligne de commande.

Valeur à utiliser comme adresse de service, y compris tout chemin de version d'API requis.

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

Remarque: Nous vous recommandons d'utiliser le paramètre --region pour cibler plusieurs régions.
OCI_CLI_CONFIG_FILE --config-file N/A Chemin du fichier de configuration OCI.
OCI_CLI_RC_FILE --cli-rc-file N/A Chemin du fichier de configuration propre à l'interface de ligne de commande OCI, contenant les valeurs par défaut des paramètres ainsi que d'autres informations de configuration, telles que les alias de commande et les requêtes prédéfinies. Pour plus d'informations, reportez-vous à Configuration de l'interface de ligne de commande.
OCI_CLI_CERT_BUNDLE --cert-bundle N/A Chemin complet d'un groupe de certificats de l'autorité de certification à utiliser pour la vérification SSL.
OCI_CLI_AUTH --auth N/A

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

Valeurs acceptées : api_key, instance_obo_user, instance_principal, resource_principal, security_token
OCI_CLI_SECURITY_TOKEN_FILE N/A security_token_file Emplacement du fichier utilisé pour l'authentification basée sur un jeton pour l'interface de ligne de commande.
HTTP_PROXY --proxy Vous pouvez définir cette valeur dans le fichier de configuration propre à l'interface de ligne de commande OCI. Reportez-vous à Spécification d'un serveur proxy. URL du serveur proxy HTTP à utiliser pour les demandes d'interface de ligne de commande sortantes.
HTTPS_PROXY --proxy Vous pouvez définir cette valeur dans le fichier de configuration propre à l'interface de ligne de commande OCI. Reportez-vous à Spécification d'un serveur proxy. URL du serveur proxy 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 indiquée dans l'option de commande.
  2. Valeur indiquée dans la variable d'environnement.
  3. Valeur indiquée dans le fichier de configuration OCI.