Erste Schritte

Zugangsdaten konfigurieren

Zuerst müssen Sie Ihre Zugangsdaten und die Konfigurationsdatei einrichten. Anweisungen hierzu finden Sie unter SDK- und CLI-Konfigurationsdatei.

Als Nächstes müssen Sie den Client so einrichten, dass er die Zugangsdaten verwendet. Die Zugangsdaten werden über eine AuthenticationDetailsProvider-Schnittstelle abstrahiert. Clients können dies jedoch implementieren. Wir haben eine einfache POJO/Builder-Klasse aufgenommen, die Sie bei dieser Aufgabe unterstützt (SimpleAuthenticationDetailsProvider).

• Sie können eine Konfiguration mit oder ohne Profil laden:

  ConfigFile config 
      = ConfigFileReader.parse("~/.oci/config");
  ConfigFile configWithProfile 
      = ConfigFileReader.parse("~/.oci/config", "DEFAULT");

• Der Private-Key-Lieferant kann direkt mit dem Dateipfad oder mit der Konfigurationsdatei erstellt werden:

  Supplier<InputStream> privateKeySupplier 
      = new SimplePrivateKeySupplier("~/.oci/oci_api_key.pem");
  Supplier<InputStream> privateKeySupplierFromConfigEntry 
      = new SimplePrivateKeySupplier(config.get("key_file"));

• So erstellen Sie einen Authentifizierungsprovider mit dem Builder:

  AuthenticationDetailsProvider provider 
      = SimpleAuthenticationDetailsProvider.builder()
          .tenantId("myTenantId")
          .userId("myUserId")
          .fingerprint("myFingerprint")
          .privateKeySupplier(privateKeySupplier)
          .build();

• So erstellen Sie einen Authentifizierungsprovider mit dem Builder mit einer Konfigurationsdatei:

  AuthenticationDetailsProvider provider 
      = SimpleAuthenticationDetailsProvider.builder()
          .tenantId(config.get("tenancy"))
          .userId(config.get("user"))
          .fingerprint(config.get("fingerprint"))
          .privateKeySupplier(privateKeySupplier)
          .build();

• Wenn Sie schließlich die Standardkonfigurationsdateischlüssel und den Standardspeicherort der Konfigurationsdatei verwenden, können Sie dies mit ConfigFileAuthenticationDetailsProvider noch weiter vereinfachen:

  AuthenticationDetailsProvider provider 
      = new ConfigFileAuthenticationDetailsProvider("ADMIN_USER");

Clientseitige Optionen konfigurieren

Erstellen Sie eine clientseitige Konfiguration über die Klasse ClientConfiguration. Wenn Sie keine eigene Konfiguration angeben, verwendet das SDK für Java eine Standardkonfiguration. Um Ihre eigene Konfiguration anzugeben, verwenden Sie:

ClientConfiguration clientConfig 
    = ClientConfiguration.builder()
        .connectionTimeoutMillis(3000)
        .readTimeoutMillis(60000)
        .build();

Wenn sowohl eine Zugangsdatenkonfiguration als auch die optionale Clientkonfiguration vorhanden sind, können Sie mit dem Erstellen von Serviceinstanzen beginnen.

Ein Codebeispiel, das zeigt, wie Verbindungs- und Lesetimeouts in der Clientkonfiguration eingerichtet und verwendet werden, finden Sie im Beispiel für Clientkonfigurationstimeout auf GitHub.

Benutzerdefinierte Optionen konfigurieren

In der Konfigurationsdatei können Sie benutzerdefinierte Schlüssel/Wert-Paare einfügen, die Sie definieren, und diese dann nach Bedarf referenzieren. Sie können beispielsweise eine häufig verwendete Compartment-ID in der Konfigurationsdatei angeben:

[DEFAULT]
user=ocid1.user.oc1..aaaaaaaat5nvwcna5j6aqzjcmdy5eqbb6qt2jvpkanghtgdaqedqw3rynjq
fingerprint=20:3b:97:13:55:1c:5b:0d:d3:37:d8:50:4e:c5:3a:34
key_file=~/.oci/oci_api_key.pem
tenancy=ocid1.tenancy.oc1..<unique_ID>


custom_compartment_id=ocid1.compartment.oc1..<unique_ID>

Dann können Sie den Wert abrufen:

ConfigFile config 
    = ConfigFileReader.parse("~/.oci/config");

String compartmentId = config.get("custom_compartment_id");