Initialiser le SDK Python SLS | Simple Log Service - Simple Log Service

Prérequis

Installer le SDK Python Simple Log Service.
Configurer les identifiants d'accès.
Obtenir un endpoint.
Un endpoint est l'URL utilisée par votre client pour accéder à un service Alibaba Cloud. SLS propose les types d'endpoints suivants :
- Public endpoint : L'extraction de données via un public endpoint génère un trafic sortant facturé selon les Éléments facturables en mode paiement selon les données ingérées et les Éléments facturables en mode paiement par fonctionnalité. Consultez la rubrique Endpoints.
- VPC endpoint : Utilisez un VPC endpoint pour accéder à SLS depuis d'autres services Alibaba Cloud situés dans la même région que votre projet. Consultez la rubrique Endpoints.
- Acceleration endpoint : Utilisez un acceleration endpoint lorsque votre serveur et votre projet SLS se trouvent dans des régions différentes (par exemple, l'un en Chine continentale et l'autre hors de Chine continentale) afin d'éviter une latence élevée et une instabilité sur le réseau public. Consultez la rubrique Gérer l'accélération de transfert.

Initialiser un LogClient

API

class LogClient(object):
    """ Construct the LogClient with endpoint, accessKeyId, accessKey.

    :type endpoint: string
    :param endpoint: log service host name, for example, ch-hangzhou.log.aliyuncs.com or https://cn-beijing.log.aliyuncs.com

    :type accessKeyId: string
    :param accessKeyId: aliyun accessKeyId

    :type accessKey: string
    :param accessKey: aliyun accessKey
    """

    __version__ = API_VERSION
    Version = __version__

    def __init__(self, endpoint, accessKeyId=None, accessKey=None, securityToken=None, source=None,
                 auth_version=AUTH_VERSION_1, region='', credentials_provider=None):

Paramètres de requête

Variable	Type	Obligatoire	Description	Exemple
endpoint	String	Oui	L'endpoint SLS. Obtenez-en un dans la section Prérequis.	`cn-hangzhou.log.aliyuncs.com`
accessKeyId	String	Oui	Si vous utilisez une paire AccessKey, il s'agit de l'AccessKey ID d'un compte Alibaba Cloud ou d'un utilisateur RAM, utilisé pour identifier l'appelant. Consultez la rubrique Configurer les identifiants d'accès. Avertissement Une paire AccessKey de compte Alibaba Cloud dispose de toutes les autorisations sur toutes les ressources. En cas de fuite, votre système est exposé à un risque élevé. Utilisez une paire AccessKey d'utilisateur RAM avec les autorisations minimales requises. Si vous utilisez un jeton STS, il s'agit de l'`AccessKeyId` dans `Credentials` renvoyé par AssumeRole.	LTAI
accessKey	String	Oui	Si vous utilisez une paire AccessKey, il s'agit du secret AccessKey d'un compte Alibaba Cloud ou d'un utilisateur RAM, utilisé pour vérifier l'AccessKey ID. Consultez la rubrique Configurer les identifiants d'accès. Si vous utilisez un jeton STS, il s'agit de l'`AccessKeySecret` dans `Credentials` renvoyé par AssumeRole.	yourAccessKeySecret
securityToken	String	Non	Identifiant temporaire pour un rôle RAM. Requis uniquement avec les jetons STS. Correspond au `SecurityToken` dans `Credentials` renvoyé par AssumeRole. La longueur du jeton de sécurité est variable. N'imposez pas de limite de longueur maximale. Consultez la rubrique AssumeRole - Obtenir un identifiant d'identité temporaire pour un rôle RAM.
source	String	Non	Identifiant de source de journal. Par défaut, l'adresse IP du serveur local est utilisée si vous laissez ce paramètre vide ou ne le spécifiez pas.	`10.105.214.**`
auth_version	String	Non	Version du protocole d'authentification. Valeurs valides : `AUTH_VERSION_1` et `AUTH_VERSION_4`. Valeur par défaut : `AUTH_VERSION_1`. `AUTH_VERSION_4` est plus sécurisé. Si vous l'utilisez, vous devez également spécifier `region`.	`AUTH_VERSION_1`
region	String	Non	Région du projet. Consultez la rubrique Régions prises en charge.	`cn-hangzhou`

Exemples

Initialisation à l'aide d'une paire AccessKey (signature V4)

# Import the sls package.
from aliyun.log import *
from aliyun.log.auth import AUTH_VERSION_4

# To obtain the AccessKey pair from environment variables, import the os library.
import os

# Obtain the AccessKey ID and AccessKey secret from environment variables.
access_key_id = os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_ID', '')
access_key_secret = os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_SECRET', '')

# The endpoint of Simple Log Service.
endpoint = "yourEndpoint"

# Create a LogClient instance. Use V4 signature and specify the region based on your requirements. This example uses the China (Hangzhou) region.
client = LogClient(endpoint, access_key_id, access_key_secret, auth_version=AUTH_VERSION_4, region='cn-hangzhou')

Initialisation à l'aide d'une paire AccessKey (signature V1)

# Import the sls package.
from aliyun.log import *

# To obtain the AccessKey pair from environment variables, import the os library.
import os

# Obtain the AccessKey ID and AccessKey secret from environment variables.
access_key_id = os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_ID', '')
access_key_secret = os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_SECRET', '')

# The endpoint of Simple Log Service.
endpoint = "yourEndpoint"

# Create a LogClient instance.
client = LogClient(endpoint, access_key_id, access_key_secret)

Initialisation avec STS

# Import the sls package.
from aliyun.log import *

# To obtain credentials from environment variables, import the os library.
import os

# Obtain the AccessKey ID, AccessKey secret, and STS token from environment variables.
access_key_id = os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_ID', '')
access_key_secret = os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_SECRET', '')
securityToken = os.environ.get('ALIBABA_CLOUD_STS_TOKEN')
# The endpoint of Simple Log Service.
endpoint = "yourEndpoint"

# Create a LogClient instance.
client = LogClient(endpoint, access_key_id, access_key_secret, securityToken)

Étapes suivantes

Après avoir initialisé LogClient, utilisez les opérations API pour créer des projets et écrire des journaux. Consultez le Démarrage rapide du SDK Python.