Inicializar o SLS Python SDK | Simple Log Service - Simple Log Service: Central de Documentação do Alibaba Cloud

Pré-requisitos

Instale o Simple Log Service Python SDK.
Configure credenciais de acesso.
Obter um endpoint.
Um endpoint é a URL que o cliente usa para acessar um serviço da Alibaba Cloud. O SLS oferece os seguintes tipos de endpoint:
- Endpoint público: A extração de dados por um endpoint público gera tráfego de saída cobrado conforme os Itens faturáveis no modo de pagamento por dados ingeridos e os Itens faturáveis no modo de pagamento por recurso. Consulte Endpoints.
- Endpoint de VPC: Use um endpoint de VPC para acessar o SLS a partir de outros serviços da Alibaba Cloud na mesma região do projeto. Consulte Endpoints.
- Endpoint de aceleração: Use um endpoint de aceleração quando o servidor e o projeto do SLS estiverem em regiões diferentes (por exemplo, uma na China continental e outra fora da China continental) para evitar alta latência e instabilidade na rede pública. Consulte Gerencie aceleração de transferência.

Inicializar um 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 da solicitação

Variável	Tipo	Obrigatório	Descrição	Exemplo
endpoint	String	Sim	Endpoint do SLS. Obtenha-o na seção Pré-requisitos.	`cn-hangzhou.log.aliyuncs.com`
accessKeyId	String	Sim	Para pares de AccessKey, corresponde ao AccessKey ID da conta Alibaba Cloud ou do usuário RAM usado para identificar o chamador. Consulte Configure credenciais de acesso. Aviso O par de AccessKey da conta Alibaba Cloud tem permissões totais sobre todos os recursos. Em caso de vazamento, o sistema corre alto risco. Use um par de AccessKey de usuário RAM com as permissões mínimas necessárias. Para tokens STS, corresponde ao `AccessKeyId` em `Credentials` retornado por AssumeRole.	LTAI
accessKey	String	Sim	Para pares de AccessKey, corresponde ao AccessKey Secret da conta Alibaba Cloud ou do usuário RAM usado para verificar o AccessKey ID. Consulte Configure credenciais de acesso. Para tokens STS, corresponde ao `AccessKeySecret` em `Credentials` retornado por AssumeRole.	yourAccessKeySecret
securityToken	String	Não	Credencial temporária para uma função RAM. Obrigatório apenas com tokens STS. Corresponde a `SecurityToken` em `Credentials` retornado por AssumeRole. O comprimento do token de segurança é variável. Não imponha limite máximo de comprimento. Consulte AssumeRole - Obter uma credencial de identidade temporária para uma função RAM.
source	String	Não	Identificador da origem do log. Se este parâmetro estiver vazio ou não for especificado, o padrão será o endereço IP do servidor local.	`10.105.214.**`
auth_version	String	Não	Versão do protocolo de autenticação. Valores válidos: `AUTH_VERSION_1` e `AUTH_VERSION_4`. Valor padrão: `AUTH_VERSION_1`. O `AUTH_VERSION_4` é mais seguro. Ao utilizá-lo, especifique também `region`.	`AUTH_VERSION_1`
region	String	Não	Região do projeto. Consulte Regiões suportadas.	`cn-hangzhou`

Exemplos

Inicializar usando um par de AccessKey (assinatura 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')

Inicializar usando um par de AccessKey (assinatura 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)

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

Próximos passos

Após inicializar o LogClient, use operações de API para criar projetos e gravar logs. Consulte o Guia de início rápido do Python SDK.