Parameter umum - - 阿里云

Topik ini menjelaskan parameter yang umum digunakan dalam semua permintaan dan respons API.

Parameter permintaan umum

Parameter	Tipe	Diperlukan	Deskripsi
Format	String	Tidak	Format respons. Nilai yang valid: JSON(default) XML
Versi	String	Ya	Nomor versi API. Nilainya harus dalam format YYYY-MM-DD. Atur nilai menjadi 2016-01-20.
AccessKeyId	String	Ya	ID AccessKey yang diberikan kepada Anda oleh Alibaba Cloud.
Signature	String	Ya	String tanda tangan dari permintaan saat ini.
SignatureMethod	String	Ya	Metode enkripsi string tanda tangan. Atur nilainya menjadi HMAC-SHA1.
Timestamp	String	Ya	Cap waktu permintaan. Tentukan waktu dalam standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC. Sebagai contoh, gunakan 2022-01-10T12:00:00Z untuk menunjukkan 10 Januari 2022, 20:00:00 (UTC+8).
SignatureVersion	String	Ya	Versi algoritma enkripsi tanda tangan. Atur nilainya menjadi 1.0.

Contoh Permintaan

https://kms.cn-hangzhou.aliyuncs.com/?Action=CreateKey
&Format=json
&Version=2016-01-20
&AccessKeyId=te****
&Signature=YlrFhyqDZQ1ThNYARrv3Ptaxqf****
&SignatureMethod=HMAC-SHA1
&Timestamp=2022-01-10T12:00:00Z
&SignatureVersion=1.0

Parameter respons umum

Respons dapat dikembalikan dalam format JSON atau XML. Anda dapat menentukan format respons dalam permintaan. Format respons default adalah JSON. Setiap respons mengembalikan RequestId yang unik, terlepas dari apakah panggilan berhasil atau tidak.

Kode status HTTP 2xx menunjukkan panggilan berhasil.
Kode status HTTP 4xx atau 5xx menunjukkan panggilan gagal.

Contoh Respons

Format XML

<?xml version="1.0" encoding="utf-8"?> 
    <!--Node Root Hasil-->
    <KMS>
        <!--Tag Permintaan Kembali-->
        <RequestId>4C467B38-3910-447D-87BC-AC049166F216</RequestId>
        <!--Data Hasil Kembali-->
    </KMS>

Format JSON

{
    "RequestId":"4C467B38-3910-447D-87BC-AC049166F216"
    /*Data Hasil Kembali*/
}