Menginisialisasi Simple Log Service SDK untuk Python - Simple Log Service

LogClient adalah klien SDK yang digunakan untuk mengakses Layanan Log Sederhana. Klien ini menyediakan berbagai metode untuk membuat Proyek, menyiapkan penyimpanan log, menulis log, dan membaca log. Untuk menggunakan Simple Log Service SDK untuk Python, Anda perlu menginisialisasi instance LogClient dan menyesuaikan pengaturan default sesuai kebutuhan bisnis Anda.

Prasyarat

Simple Log Service SDK untuk Python telah diinstal. Untuk informasi lebih lanjut, lihat Instal Simple Log Service SDK untuk Python.
Kredensial akses telah dikonfigurasi. Untuk informasi lebih lanjut, lihat Konfigurasikan kredensial akses.
Titik akhir yang diperlukan telah diperoleh.
Titik akhir digunakan untuk mengakses layanan Alibaba Cloud. Dalam banyak kasus, titik akhir merupakan URL yang mencakup protokol akses, nama host, port, dan jalur. Informasi ini memungkinkan klien untuk terhubung dengan layanan tersebut. Untuk informasi lebih lanjut, lihat Titik Akhir. Layanan Log Sederhana mendukung titik akhir publik, titik akhir virtual private cloud (VPC), dan titik akhir percepatan.
- Titik akhir publik: Jika data diambil melalui titik akhir publik Layanan Log Sederhana, lalu lintas baca melalui Internet akan dihasilkan. Untuk detail penagihan, lihat Item tagihan dari model bayar-per-data-ingest dan Item tagihan dari model bayar-per-fitur. Untuk informasi lebih lanjut tentang titik akhir, lihat Titik Akhir.
- VPC endpoints: Jika Anda ingin mengakses Layanan Log Sederhana dari layanan Alibaba Cloud lainnya dalam wilayah yang sama dengan proyek Anda, disarankan untuk menggunakan titik akhir VPC. Untuk informasi lebih lanjut, lihat Titik Akhir.
- Percepatan titik akhir: Jika server Anda dan Layanan Log Sederhana berada di wilayah yang berbeda, seperti di dalam dan luar Tiongkok, latensi jaringan tinggi dan transmisi tidak stabil dapat terjadi ketika data ditransmisikan melalui Internet. Dalam hal ini, Anda dapat menggunakan titik akhir percepatan. Untuk informasi lebih lanjut, lihat Gunakan fitur percepatan transfer.

Inisialisasi instance LogClient

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

Parameter permintaan

Parameter	Tipe	Diperlukan	Deskripsi	Contoh
endpoint	String	Ya	Titik akhir. Untuk informasi lebih lanjut, lihat Prasyarat.	`cn-hangzhou.log.aliyuncs.com`
accessKeyId	String	Ya	Jika Anda menggunakan pasangan AccessKey untuk mengonfigurasi kredensial akses, atur parameter ini ke ID AccessKey dari akun Alibaba Cloud atau Pengguna Resource Access Management (RAM). ID AccessKey digunakan untuk mengidentifikasi pengguna. Untuk informasi lebih lanjut, lihat Konfigurasikan kredensial akses. Peringatan Pasangan AccessKey dari akun Alibaba Cloud memiliki izin penuh atas sumber daya. Kami sarankan Anda tidak menggunakan pasangan AccessKey dari akun Alibaba Cloud untuk menghindari risiko yang disebabkan oleh kebocoran pasangan AccessKey. Kami sarankan Anda menggunakan pasangan AccessKey dari pengguna RAM yang diberi izin berdasarkan prinsip hak istimewa minimal. Jika Anda menggunakan Security Token Service (STS) untuk mengonfigurasi kredensial akses, atur parameter ini ke nilai parameter AccessKeyId di bawah parameter Credentials yang dikembalikan oleh operasi AssumeRole.	LTAI****************
accessKey	String	Ya	Jika Anda menggunakan pasangan AccessKey untuk mengonfigurasi kredensial akses, atur parameter ini ke Rahasia AccessKey dari akun Alibaba Cloud atau pengguna RAM. Rahasia AccessKey digunakan untuk memverifikasi ID AccessKey Anda. Untuk informasi lebih lanjut, lihat Konfigurasikan kredensial akses. Jika Anda menggunakan STS untuk mengonfigurasi kredensial akses, atur parameter ini ke nilai parameter AccessKeySecret di bawah parameter Credentials yang dikembalikan oleh operasi AssumeRole.	yourAccessKeySecret
securityToken	String	Tidak	Parameter ini hanya diperlukan jika Anda menggunakan STS untuk mengonfigurasi kredensial akses. Atur parameter ini ke nilai parameter SecurityToken di bawah parameter Credentials yang dikembalikan oleh operasi AssumeRole. Alibaba Cloud STS tidak memberlakukan batasan pada panjang token STS. Kami sarankan Anda tidak menentukan panjang maksimum untuk token STS. Untuk informasi lebih lanjut tentang cara mendapatkan token STS, lihat AssumeRole.	****************
source	String	Tidak	Sumber. Jika Anda tidak mengonfigurasi parameter ini, alamat IP server Anda akan digunakan secara otomatis.	`10.105.214.**`
auth_version	String	Tidak	Parameter ini menentukan versi protokol autentikasi. Nilai valid: `AUTH_VERSION_1` dan `AUTH_VERSION_4`. Nilai default: `AUTH_VERSION_1`. Kami sarankan Anda mengatur parameter ini ke `AUTH_VERSION_4`, yang memberikan keamanan lebih baik. Jika Anda menggunakan `AUTH_VERSION_4`, Anda juga harus mengonfigurasi parameter region.	`AUTH_VERSION_1`
region	String	Tidak	Wilayah proyek. Untuk informasi lebih lanjut tentang wilayah yang didukung oleh Layanan Log Sederhana, lihat Wilayah yang didukung.	`cn-hangzhou`

Contoh

Inisialisasi berbasis pasangan AccessKey (AUTH_VERSION_4 untuk penandatanganan)

# Impor paket Simple Log Service SDK untuk Python. 
from aliyun.log import *
from aliyun.log.auth import AUTH_VERSION_4

# Jika Anda memperoleh pasangan AccessKey dari variabel lingkungan, Anda harus mengimpor perpustakaan sistem operasi (OS).
import os

# Peroleh 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', '')

# Tentukan titik akhir Layanan Log Sederhana.
endpoint = "yourEndpoint"

# Buat instance LogClient. Dalam contoh ini, gunakan AUTH_VERSION_4 untuk penandatanganan dan wilayah China (Hangzhou).
client = LogClient(endpoint, access_key_id, access_key_secret, auth_version=AUTH_VERSION_4, region='cn-hangzhou')

Inisialisasi berbasis pasangan AccessKey (AUTH_VERSION_1 untuk penandatanganan)

# Impor paket Simple Log Service SDK untuk Python. 
from aliyun.log import *

# Jika Anda memperoleh pasangan AccessKey dari variabel lingkungan, Anda harus mengimpor perpustakaan OS. 
import os

# Peroleh 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', '')

# Tentukan titik akhir Layanan Log Sederhana.
endpoint = "yourEndpoint"

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

Inisialisasi berbasis STS

# Impor paket Simple Log Service SDK untuk Python. 
from aliyun.log import *

# Jika Anda memperoleh pasangan AccessKey dari variabel lingkungan, Anda harus mengimpor perpustakaan OS. 
import os

# Peroleh 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', '')
securityToken = os.environ.get('ALIBABA_CLOUD_STS_TOKEN')
# Tentukan titik akhir Layanan Log Sederhana.
endpoint = "yourEndpoint"

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

Referensi

Setelah menginisialisasi instance LogClient, Anda dapat menggunakan Simple Log Service SDK untuk Python guna membuat proyek dan menulis log. Untuk informasi lebih lanjut, lihat Memulai dengan Simple Log Service SDK untuk Python.