Inisialisasi SDK Python SLS | Simple Log Service - Simple Log Service

LogClient adalah klien SDK Python SLS untuk mengelola proyek, Logstore, menulis log, dan membaca log. Inisialisasi instance LogClient untuk mulai mengirim permintaan, lalu sesuaikan konfigurasi default sesuai kebutuhan.

Prasyarat

Instal SDK Python Simple Log Service.
Konfigurasikan kredensial akses.
Dapatkan titik akhir (endpoint).
Endpoint adalah URL yang digunakan klien Anda untuk mengakses layanan Alibaba Cloud. SLS menyediakan jenis endpoint berikut:
- Titik akhir publik (Public endpoint): Menarik data melalui titik akhir publik menghasilkan lalu lintas keluar (outbound traffic) yang ditagih berdasarkan Item yang dapat ditagih dalam mode bayar berdasarkan data yang diingest dan Item yang dapat ditagih dalam mode bayar berdasarkan fitur. Endpoint.
- Titik akhir VPC (VPC endpoint): Gunakan titik akhir VPC untuk mengakses SLS dari layanan Alibaba Cloud lainnya di wilayah yang sama dengan proyek Anda. Endpoint.
- Acceleration endpoint: Gunakan titik akhir percepatan (acceleration endpoint) ketika server Anda dan proyek SLS berada di wilayah berbeda—misalnya, satu di Tiongkok Daratan dan yang lain di luar Tiongkok Daratan—untuk menghindari latensi tinggi dan ketidakstabilan melalui jaringan publik. Kelola akselerasi transfer.

Inisialisasi LogClient

API

class LogClient(object):
    """ Buat LogClient dengan endpoint, accessKeyId, dan accessKey.

    :type endpoint: string
    :param endpoint: nama host layanan log, contohnya ch-hangzhou.log.aliyuncs.com atau https://cn-beijing.log.aliyuncs.com

    :type accessKeyId: string
    :param accessKeyId: accessKeyId aliyun

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

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

Parameter permintaan

Variabel	Type	Wajib	Deskripsi	Contoh
endpoint	String	Ya	Endpoint SLS. Dapatkan dari bagian Prasyarat.	`cn-hangzhou.log.aliyuncs.com`
accessKeyId	String	Ya	Jika Anda menggunakan pasangan AccessKey, ini adalah ID AccessKey dari Akun Alibaba Cloud atau Pengguna RAM, yang digunakan untuk mengidentifikasi pemanggil. Konfigurasikan kredensial akses. Peringatan Pasangan AccessKey Akun Alibaba Cloud memiliki izin penuh atas semua sumber daya. Jika bocor, sistem Anda menghadapi risiko tinggi. Gunakan pasangan AccessKey Pengguna RAM dengan izin minimum yang diperlukan. Jika Anda menggunakan token STS, ini adalah `AccessKeyId` dalam `Credentials` yang dikembalikan oleh AssumeRole.	LTAI****************
accessKey	String	Ya	Jika Anda menggunakan pasangan AccessKey, ini adalah rahasia AccessKey (AccessKey secret) dari Akun Alibaba Cloud atau Pengguna RAM, yang digunakan untuk memverifikasi ID AccessKey. Konfigurasikan kredensial akses. Jika Anda menggunakan token STS, ini adalah `AccessKeySecret` dalam `Credentials` yang dikembalikan oleh AssumeRole.	yourAccessKeySecret
securityToken	String	Tidak	Kredensial temporary untuk Peran RAM. Hanya diperlukan saat menggunakan token STS. Sesuai dengan `SecurityToken` dalam `Credentials` yang dikembalikan oleh AssumeRole. Panjang token keamanan bersifat variabel. Jangan memberlakukan batas panjang maksimum. AssumeRole - Dapatkan kredensial identitas temporary untuk Peran RAM.	****************
source	String	Tidak	Identifikasi sumber log. Nilai default-nya adalah alamat IP server lokal jika Anda tidak mengisi atau tidak menentukan parameter ini.	`10.105.214.**`
auth_version	String	Tidak	Versi protokol otentikasi. Nilai yang valid: `AUTH_VERSION_1` dan `AUTH_VERSION_4`. Nilai default: `AUTH_VERSION_1`. `AUTH_VERSION_4` lebih aman. Jika Anda menggunakannya, Anda juga harus menentukan `region`.	`AUTH_VERSION_1`
region	String	Tidak	Wilayah proyek. Wilayah yang didukung.	`cn-hangzhou`

Contoh

Inisialisasi menggunakan pasangan AccessKey (signature V4)

# Impor paket sls.
from aliyun.log import *
from aliyun.log.auth import AUTH_VERSION_4

# Untuk mendapatkan pasangan AccessKey dari variabel lingkungan, impor library os.
import os

# Dapatkan ID AccessKey dan rahasia AccessKey dari variabel lingkungan.
access_key_id = os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_ID', '')
access_key_secret = os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_SECRET', '')

# Endpoint Simple Log Service.
endpoint = "yourEndpoint"

# Buat instans LogClient. Gunakan signature V4 dan tentukan wilayah sesuai kebutuhan Anda. Contoh ini menggunakan wilayah Tiongkok (Hangzhou).
client = LogClient(endpoint, access_key_id, access_key_secret, auth_version=AUTH_VERSION_4, region='cn-hangzhou')

Inisialisasi menggunakan pasangan AccessKey (signature V1)

# Impor paket sls.
from aliyun.log import *

# Untuk mendapatkan pasangan AccessKey dari variabel lingkungan, impor library os.
import os

# Dapatkan ID AccessKey dan rahasia AccessKey dari variabel lingkungan.
access_key_id = os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_ID', '')
access_key_secret = os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_SECRET', '')

# Endpoint Simple Log Service.
endpoint = "yourEndpoint"

# Buat instans LogClient.
client = LogClient(endpoint, access_key_id, access_key_secret)

Inisialisasi dengan STS

# Impor paket sls.
from aliyun.log import *

# Untuk mendapatkan kredensial dari variabel lingkungan, impor library os.
import os

# Dapatkan ID AccessKey, rahasia AccessKey, dan token STS dari variabel lingkungan.
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')
# Endpoint Simple Log Service.
endpoint = "yourEndpoint"

# Buat instans LogClient.
client = LogClient(endpoint, access_key_id, access_key_secret, securityToken)

Langkah berikutnya

Setelah Anda menginisialisasi LogClient, gunakan operasi API untuk membuat proyek dan menulis log. Panduan Cepat untuk SDK Python.