Oracle Cloud Infrastructure - Dokumentation

CLI-Umgebungsvariablen

Die Oracle Cloud Infrastructure-CLI unterstützt die Verwendung von Umgebungsvariablen zur Angabe von Standardwerten für einige Optionen.

Umgebungsvariablen

In der folgenden Tabelle werden die verfügbaren Umgebungsvariablen und die entsprechenden CLI-Optionen bzw. ~/.oci/config-Einträge aufgeführt.

Umgebungsvariable CLI-Option OCI-Konfigurationseintrag Beschreibung
OCI_CLI_PROFILE --profile Angegeben von [DEFAULT] Das Profil in der zu ladenden OCI-Konfigurationsdatei. Dieses Profil wird auch verwendet, um Standardparameterwerte zu suchen, die in der OCI-CLI-spezifischen Konfigurationsdatei angegeben wurden.
OCI_CLI_USER n/v user

Die OCID des Benutzers, der die API aufruft. Die Werte finden Sie unter Erforderliche Schlüssel und OCIDs.

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

Eine Oracle Cloud Infrastructure-Region. Siehe Regionen und Availability-Domains.

Beispiel: us-ashburn-1
OCI_CLI_FINGERPRINT n/v fingerprint

Der Fingerprint für den Public Key, der diesem Benutzer hinzugefügt wurde. Die Werte finden Sie unter Erforderliche Schlüssel und OCIDs.

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

Vollständiger Pfad und Dateiname des Private Keys.

Wichtig: Das Schlüsselpaar muss im PEM-Format vorliegen. Anweisungen zum Generieren eines Schlüsselpaares im PEM-Format finden Sie unter Erforderliche Schlüssel und OCIDs.

Wenn Sie den Schlüssel mit einer Passphrase verschlüsselt haben, müssen Sie auch den Eintrag pass_phrase in die Konfigurationsdatei aufnehmen.

Beispiel: ~/.oci/oci_api_key.pem
OCI_CLI_KEY_CONTENT n/v n/a Vollständiger Inhalt des Private Keys in einfachen Anführungszeichen. Wichtig: Das Schlüsselpaar muss im PEM-Format vorliegen.

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

Die OCID Ihres Mandanten. Die Werte finden Sie unter Erforderliche Schlüssel und OCIDs.

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

Dieser Wert kann in der OCI-CLI-spezifischen Konfigurationsdatei festgelegt werden. Siehe CLI konfigurieren.

Der Wert, der als Serviceendpunkt verwendet werden soll, einschließlich aller erforderlichen API-Versionspfade.

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

Hinweis: Der Parameter --region ist die empfohlene Methode, um unterschiedliche Regionen als Ziele festzulegen.
OCI_CLI_CONFIG_FILE --config-file n/v Der Pfad zur OCI-Konfigurationsdatei.
OCI_CLI_RC_FILE --cli-rc-file n/v Der Pfad zur OCI-CLI-spezifischen Konfigurationsdatei mit Parameterstandardwerten und anderen Konfigurationsinformationen wie Befehlsaliasnamen und vordefinierten Abfragen. Weitere Informationen finden Sie unter CLI konfigurieren.
OCI_CLI_CERT_BUNDLE --cert-bundle n/v Vollständiger Pfad zu einem CA-Zertifikats-Bundle, das zur SSL-Überprüfung verwendet werden soll.
OCI_CLI_AUTH --auth n/v

Der Authentifizierungstyp, der für die API-Anforderung verwendet werden soll. Standardmäßig wird der API-Schlüssel in der Konfigurationsdatei verwendet.

Zulässige Werte sind: api_key, instance_obo_user, instance_principal, resource_principal, security_token
OCI_CLI_SECURITY_TOKEN_FILE n/v security_token_file Der Speicherort der Datei, die für die tokenbasierte Authentifizierung für die CLI verwendet wird.
HTTP_PROXY --proxy Dieser Wert kann in der OCI-CLI-spezifischen Konfigurationsdatei festgelegt werden. Siehe Proxyserver angeben. Die URL des HTTP-Proxyservers, der für ausgehende CLI-Anforderungen verwendet werden soll.
HTTPS_PROXY --proxy Dieser Wert kann in der OCI-CLI-spezifischen Konfigurationsdatei festgelegt werden. Siehe Proxyserver angeben. Die URL des HTTPS-Proxyservers, der für ausgehende CLI-Anforderungen verwendet werden soll.

Prioritätsfolge

Die CLI beachtet und übernimmt Konfigurationen, die durch Option, Umgebungsvariable oder OCI-Konfigurationsdateieintrag angegeben werden, in der folgenden Prioritätsfolge:

  1. Wert, der in der Befehlsoption angegeben ist.
  2. Wert, der in der Umgebungsvariablen angegeben ist.
  3. Wert, der in der OCI-Konfigurationsdatei angegeben ist.