Initialize Simple Log Service SDK for Java - Simple Log Service

Prérequis

Vous avez terminé l'installation du SDK Java.

Procédure

Deux méthodes d'initialisation sont disponibles. Choisissez celle qui correspond à votre scénario :

Initialisation par AccessKey : une paire AccessKey est un identifiant permanent utilisable directement pour les appels API. Cette méthode convient aux environnements stables ne nécessitant pas de rotation fréquente des identifiants.
Initialisation par STS : Security Token Service (STS) génère des identifiants d'accès temporaires. Cette méthode est adaptée aux scénarios exigeant une autorisation dynamique et éphémère.

Initialiser à l'aide d'une paire AccessKey

Initialiser le client

 public Client(String endpoint, String  accessKeyId, String accessKeySecret)

Paramètres de la requête

Variable	Type	Obligatoire	Description	Valeur d'exemple
endpoint	String	Oui	L'endpoint utilisé pour accéder à Simple Log Service. Un endpoint est une URL qui spécifie le protocole d'accès, le nom d'hôte, le port et le chemin pour la communication entre le client et le service. Simple Log Service propose les types d'endpoints suivants : Endpoint public : Le téléchargement de données depuis un endpoint public entraîne des frais de trafic sortant. Pour plus d'informations sur la facturation, consultez les Éléments facturables pour le mode de paiement selon les données ingérées et les Éléments facturables pour le mode de paiement selon les fonctionnalités. Pour obtenir la liste des endpoints, consultez les Endpoints. Endpoint VPC : Pour accéder à Simple Log Service depuis d'autres services Alibaba Cloud situés dans la même région que votre projet, nous vous recommandons d'utiliser un endpoint VPC. Pour plus d'informations, consultez les Endpoints. Endpoint d'accélération : Si votre serveur d'application et votre projet Simple Log Service se trouvent dans des régions différentes, par exemple l'un en Chine continentale et l'autre à l'étranger, la transmission des données sur le réseau public peut subir une latence élevée et une instabilité. Dans ce cas, utilisez un endpoint d'accélération. Pour plus d'informations, consultez Gérer l'accélération de transfert.	`cn-hangzhou.log.aliyuncs.com`
accessKeyId	String	Oui	Si vous utilisez une paire AccessKey pour configurer les identifiants d'accès, il s'agit de l'AccessKey ID d'un compte Alibaba Cloud ou d'un utilisateur Resource Access Management (RAM). L'AccessKey ID identifie l'appelant. Pour plus d'informations, consultez Configurer les identifiants d'accès. Avertissement Une paire AccessKey de compte Alibaba Cloud dispose de toutes les autorisations sur l'ensemble des ressources. En cas de fuite de cette paire, vos ressources sont exposées. Nous vous recommandons d'utiliser la paire AccessKey d'un utilisateur RAM disposant uniquement des autorisations nécessaires.	LTAI
accessKeySecret	String	Oui	Si vous utilisez une paire AccessKey pour configurer les identifiants d'accès, il s'agit de l'AccessKey Secret d'un compte Alibaba Cloud ou d'un utilisateur RAM. L'AccessKey Secret permet d'authentifier l'AccessKey ID. Pour plus d'informations, consultez Configurer les identifiants d'accès.	yourAccessKeySecret

Exemple de code

L'algorithme de signature V4 offre une sécurité accrue grâce à un chiffrement et une signature plus complexes. L'algorithme de signature V1 est plus simple. Sélectionnez un algorithme de signature en fonction de vos exigences :

Signature V4

package com.test.controller;

import com.aliyun.openservices.log.Client;
import com.aliyun.openservices.log.http.client.ClientConfiguration;
import com.aliyun.openservices.log.http.signer.SignVersion;

public class Sample {

    public static void main(String[] args) throws Exception {
        // The endpoint of Simple Log Service. This example uses the endpoint of the China (Beijing) region. Replace it with the actual endpoint.
        String endpoint = "cn-beijing.log.aliyuncs.com";
        // This example obtains the AccessKey ID and AccessKey secret from environment variables.
        String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
        String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
        ClientConfiguration clientConfiguration = new ClientConfiguration();
        clientConfiguration.setRegion("cn-beijing");
        clientConfiguration.setSignatureVersion(SignVersion.V4);
        Client client = new Client(endpoint,
                accessKeyId,
                accessKeySecret,
                clientConfiguration);
    }
}

Signature V1

package com.test.controller;

import com.aliyun.openservices.log.Client;

public class Sample {

    public static void main(String[] args) throws Exception {
        // The endpoint of Simple Log Service. This example uses the endpoint of the China (Beijing) region. Replace it with the actual endpoint.
        String endpoint = "cn-beijing.log.aliyuncs.com";
        // This example obtains the AccessKey ID and AccessKey secret from environment variables.
        String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
        String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
        Client client = new Client(endpoint, accessKeyId, accessKeySecret);
    }
}

Initialiser à l'aide de STS

Initialiser le client

Client(String endpoint, CredentialsProvider credentialsProvider) ;

Paramètres de la requête

Variable	Type	Obligatoire	Description	Exemple
endpoint	String	Oui	L'endpoint utilisé pour accéder à Simple Log Service. Un endpoint est une URL qui spécifie le protocole d'accès, le nom d'hôte, le port et le chemin pour la communication entre le client et le service. Simple Log Service propose les types d'endpoints suivants : Endpoint public : Le téléchargement de données depuis un endpoint public entraîne des frais de trafic sortant. Pour plus d'informations sur la facturation, consultez les Éléments facturables pour le mode de paiement selon les données ingérées et les Éléments facturables pour le mode de paiement selon les fonctionnalités. Pour obtenir la liste des endpoints, consultez les Endpoints. Endpoint VPC : Pour accéder à Simple Log Service depuis d'autres services Alibaba Cloud situés dans la même région que votre projet, nous vous recommandons d'utiliser un endpoint VPC. Pour plus d'informations, consultez les Endpoints. Endpoint d'accélération : Si votre serveur d'application et votre projet Simple Log Service se trouvent dans des régions différentes, par exemple l'un en Chine continentale et l'autre à l'étranger, la transmission des données sur le réseau public peut subir une latence élevée et une instabilité. Dans ce cas, utilisez un endpoint d'accélération. Pour plus d'informations, consultez Gérer l'accélération de transfert.	`cn-hangzhou.log.aliyuncs.com`
accessKeyId	String	Oui	Si vous utilisez STS pour configurer les identifiants d'accès, il s'agit de l'AccessKeyId issu du paramètre Credentials renvoyé par l'opération API AssumeRole.	LTAI
accessKeySecret	String	Oui	Si vous utilisez STS pour configurer les identifiants d'accès, il s'agit de l'AccessKeySecret issu du paramètre Credentials renvoyé par l'opération API AssumeRole.	yourAccessKeySecret
securityToken	String	Oui	Si vous utilisez STS pour configurer les identifiants d'accès, il s'agit du SecurityToken issu du paramètre Credentials renvoyé par l'opération API AssumeRole.

Exemple de code

package com.test.controller;

import com.aliyun.openservices.log.Client;
import com.aliyun.openservices.log.common.auth.DefaultCredentials;
import com.aliyun.openservices.log.common.auth.StaticCredentialsProvider;

public class Sample {

    public static void main(String[] args) throws Exception {
        // The endpoint of Simple Log Service. This example uses the endpoint of the China (Beijing) region. Replace it with the actual endpoint.
        String endpoint = "cn-beijing.log.aliyuncs.com";
        // This example obtains the AccessKeyId from the Credentials parameter returned by the AssumeRole operation from an environment variable.
        String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
        // This example obtains the AccessKeySecret from the Credentials parameter returned by the AssumeRole operation from an environment variable.
        String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
        // This example obtains the SecurityToken from the Credentials parameter returned by the AssumeRole operation from an environment variable.
        String securityToken = System.getenv("ALIBABA_CLOUD_STS_TOKEN");

        Client client = new Client(endpoint, new StaticCredentialsProvider(
                new DefaultCredentials(accessKeyId, accessKeySecret, securityToken)
        ));
    }
}

Références

Après avoir initialisé le client, vous pouvez appeler des opérations API pour créer des projets, écrire des journaux ou effectuer d'autres actions. Pour plus d'informations, consultez le Démarrage rapide du SDK Java.