SDK Java OUTSCALE

Le SDK Java OUTSCALE vous permet d’interagir en Java avec les services du Cloud OUTSCALE. Il apporte une méthode simple pour configurer l’authentification, créer un client, et appeler les API OUTSCALE.

Installation

Avant de commencer : Pour générer la bibliothèque cliente de l’API, assurez-vous que Java 1.8+ et Maven 3.8.3+ sont installés sur votre machine.

Installation du SDK Java OUTSCALE avec Maven

Pour installer la bibliothèque cliente de l’API dans votre dépôt Maven local, exécutez la commande suivante :

$ mvn clean install

Pour la publier dans un dépôt Maven distant, configurez les paramètres du dépôt, puis exécutez la commande suivante :

$ mvn clean deploy

Pour en savoir plus, voir le guide OSSRH.

Une fois le SDK publié, ajoutez la dépendance suivante au fichier POM (Project Object Model) de votre projet :

<dependency>
  <groupId>io.github.outscale</groupId>
  <artifactId>osc-sdk-java</artifactId>
  <version>0.8.0</version>
  <scope>compile</scope>
</dependency>

Installation du SDK Java OUTSCALE avec Gradle

Avant de commencer : Assurez-vous que Gradle 7.2+ est installé sur votre machine.

Si vous utilisez Gradle, ajoutez la dépendance suivante au fichier de build de votre projet :

repositories {
    mavenCentral()     // Nécessaire si le JAR 'osc-sdk-java' a été publié sur Maven Central.
    mavenLocal()       // Nécessaire si le JAR 'osc-sdk-java' a été publié dans le dépôt Maven local.
}

dependencies {
    implementation "io.github.outscale:osc-sdk-java:0.8.0"
}

Installation manuelle du SDK Java OUTSCALE

Commencez par générer le fichier JAR en exécutant la commande suivante :

$ mvn clean package

Installez ensuite manuellement les fichiers JAR suivants :

  • target/osc-sdk-java-0.8.0.jar

  • target/lib/*.jar

Bien démarrer

Une fois l’installation terminée, exécutez le code Java suivant :

// Importer les classes :
import io.github.outscale.osc_sdk_java.client.ApiClient;
import io.github.outscale.osc_sdk_java.client.ApiException;
import io.github.outscale.osc_sdk_java.client.Configuration;
import io.github.outscale.osc_sdk_java.client.auth.*;
import io.github.outscale.osc_sdk_java.client.models.*;
import io.github.outscale.osc_sdk_java.client.api.AccessKeyApi;

public class Example {
  public static void main(String[] args) {
    ApiClient defaultClient = Configuration.getDefaultApiClient();
    defaultClient.setBasePath("https://api.eu-west-2.outscale.com/api/v1");

    // Configurer l'autorisation par clé API : ApiKeyAuthSec
    ApiKeyAuth ApiKeyAuthSec = (ApiKeyAuth) defaultClient.getAuthentication("ApiKeyAuthSec");
    ApiKeyAuthSec.setApiKey("YOUR API KEY");
    // Décommentez la ligne suivante pour définir un préfixe pour la clé API, par exemple "Token" (null par défaut)
    //ApiKeyAuthSec.setApiKeyPrefix("Token");

    // Configurer l'autorisation HTTP de base : BasicAuth
    HttpBasicAuth BasicAuth = (HttpBasicAuth) defaultClient.getAuthentication("BasicAuth");
    BasicAuth.setUsername("YOUR USERNAME");
    BasicAuth.setPassword("YOUR PASSWORD");

    AccessKeyApi apiInstance = new AccessKeyApi(defaultClient);
    CreateAccessKeyRequest createAccessKeyRequest = new CreateAccessKeyRequest(); // CreateAccessKeyRequest |
    try {
      CreateAccessKeyResponse result = apiInstance.createAccessKey(createAccessKeyRequest);
      System.out.println(result);
    } catch (ApiException e) {
      System.err.println("Exception when calling AccessKeyApi#createAccessKey");
      System.err.println("Status code: " + e.getCode());
      System.err.println("Reason: " + e.getResponseBody());
      System.err.println("Response headers: " + e.getResponseHeaders());
      e.printStackTrace();
    }
  }
}

Pour en savoir plus, voir le dépôt GitHub du SDK Java OUTSCALE.

Pages connexes

AWS™ et Amazon Web Services™ sont des marques de commerce d'Amazon Technologies, Inc. ou de ses affiliées aux États-Unis et/ou dans les autres pays.

Exporter en PDF