Inicializar el SDK de Python de SLS - Simple Log Service - Centro de documentación de Alibaba Cloud

LogClient es el cliente del SDK de Python de SLS que permite gestionar proyectos y Logstores, así como escribir y leer registros. Inicialice una instancia de LogClient para comenzar a enviar solicitudes y modifique las configuraciones predeterminadas según sus necesidades.

Requisitos previos

Install the Simple Log Service Python SDK.
Configure access credentials.
Obtener un endpoint.
Un endpoint es la URL que utiliza su cliente para acceder a un servicio de Alibaba Cloud. SLS ofrece los siguientes tipos de endpoint:
- Endpoint público: extraer datos mediante un endpoint público genera tráfico de salida. Este tráfico se factura por Billable items in pay-by-ingested-data mode y Billable items in pay-by-feature mode. Endpoints.
- Endpoint de VPC: utilice un endpoint de VPC para acceder a SLS desde otros servicios de Alibaba Cloud ubicados en la misma región que su proyecto. Endpoints.
- Endpoint de aceleración: use este tipo de endpoint cuando su servidor y el proyecto de SLS estén en regiones distintas. Por ejemplo, si uno se encuentra en China continental y el otro fuera de esta zona, evitará latencias altas e inestabilidad en la red pública. Manage transfer acceleration.

Inicializar 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):

Parámetros de solicitud

Variable	Tipo	Obligatorio	Descripción	Ejemplo
endpoint	String	Sí	El endpoint de SLS. Obtenga uno en la sección Requisitos previos.	`cn-hangzhou.log.aliyuncs.com`
accessKeyId	String	Sí	Si utiliza un par de AccessKey, corresponde al AccessKey ID de una cuenta de Alibaba Cloud o de un usuario de RAM. Sirve para identificar al solicitante. Configure access credentials. Aviso El par de AccessKey de una cuenta de Alibaba Cloud tiene permisos totales sobre todos los recursos. Si se filtra, el sistema queda expuesto a un riesgo alto. Utilice un par de AccessKey de un usuario de RAM con los permisos mínimos necesarios. Si utiliza un token de STS, corresponde al valor `AccessKeyId` dentro de `Credentials` que devuelve AssumeRole.	LTAI
accessKey	String	Sí	Si utiliza un par de AccessKey, corresponde al secreto de AccessKey de una cuenta de Alibaba Cloud o de un usuario de RAM. Se usa para comprobar el AccessKey ID. Configure access credentials. Si utiliza un token de STS, corresponde al valor `AccessKeySecret` dentro de `Credentials` que devuelve AssumeRole.	yourAccessKeySecret
securityToken	String	No	Credencial temporal para un rol de RAM. Solo es obligatoria cuando se usan tokens de STS. Corresponde al valor `SecurityToken` dentro de `Credentials` que devuelve AssumeRole. La longitud del token de seguridad es variable. No establezca un límite máximo de longitud. AssumeRole - Obtain a temporary identity credential for a RAM role.
source	String	No	Identificador del origen del registro. Si deja este parámetro vacío o no lo especifica, toma de forma predeterminada la dirección IP del servidor local.	`10.105.214.**`
auth_version	String	No	Versión del protocolo de autenticación. Valores válidos: `AUTH_VERSION_1` y `AUTH_VERSION_4`. Valor predeterminado: `AUTH_VERSION_1`. `AUTH_VERSION_4` es más seguro. Si lo utiliza, también debe especificar `region`.	`AUTH_VERSION_1`
region	String	No	La región del proyecto. Supported regions.	`cn-hangzhou`

Ejemplos

Inicialización con un par de AccessKey (firma 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')

Inicialización con un par de AccessKey (firma 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)

Inicialización con 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)

Pasos siguientes

Una vez que inicialice LogClient, utilice las operaciones de la API para crear proyectos y escribir registros. Quick Start for Python SDK.