GetRecord - Edge Security Acceleration - Alibaba Cloud Documentation Center

Mengambil konfigurasi detail satu Rekaman DNS, termasuk nilai Catatan, prioritas, dan konfigurasi otentikasi back-to-origin (khusus untuk Rekaman CNAME).

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

esa:GetRecord

get

*All Resource

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RecordId	integer	Yes	ID Catatan. Anda dapat memperoleh nilai ini dengan memanggil ListRecords.	1234567890123

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	F32C57AA-7BF8-49AE-A2CC-9F42390F5A19
RecordModel	object	Informasi tentang Catatan yang dikueri.
BizName	string	Skenario bisnis saat Catatan dipercepat. Nilai valid: image_video: video dan gambar. api: API. web: halaman web.	image_video
Data	object	Informasi DNS Catatan. Konten yang dikembalikan di bidang ini bervariasi berdasarkan Tipe catatan.	{"value":"1.1.1.1"}
Value	string	Nilai Rekaman atau konten parsial. Maknanya bervariasi berdasarkan tipe rekaman: A/AAAA: Alamat IP yang ditunjuk oleh Rekaman. Pisahkan beberapa alamat IP dengan koma (,). Diperlukan setidaknya satu alamat IPv4. CNAME: Nama domain tujuan yang ditunjuk oleh Rekaman. NS: Name server untuk nama domain yang ditentukan. MX: Nama domain valid dari server mail tujuan. TXT: String teks valid. CAA: Nama domain Otoritas Sertifikat valid. SRV: Nama domain valid dari host tujuan. URI: String URI valid.	example.com
Priority	integer	Prioritas Rekaman. Nilai valid: 0 hingga 65535. Nilai yang lebih kecil menunjukkan prioritas yang lebih tinggi.	10
Flag	integer	Flag Rekaman. Flag Rekaman CAA menunjukkan prioritas dan metode pemrosesannya. Nilai valid: 0 hingga 255.	128
Tags	object	Tag Rekaman.	{\"test\": \"test val1\"}
Weight	integer	Bobot Rekaman. Nilai valid: 0 hingga 65535.	0
Port	integer	Port Rekaman. Nilai valid: 0 hingga 65535.	8707
Type	integer	Tipe sertifikat Rekaman (untuk Rekaman CERT) atau tipe kunci publik (untuk Rekaman SSHFP).	0
KeyTag	integer	Pengidentifikasi kunci publik Rekaman. Nilai valid: 0 hingga 65535.	1
Algorithm	integer	Algoritma enkripsi yang digunakan oleh Rekaman. Nilai valid: 0 hingga 255.	1
Certificate	string	Informasi sertifikat kunci publik Rekaman.	dGVzdGFkYWxrcw==
Usage	integer	Pengidentifikasi penggunaan Rekaman. Nilai valid: 0 hingga 255.	0
Selector	integer	Tipe sertifikat atau kunci publik yang digunakan oleh Rekaman. Nilai valid: 0 hingga 255.	1
MatchingType	integer	Kebijakan algoritma yang digunakan untuk mencocokkan atau memverifikasi sertifikat. Nilai valid: 0 hingga 255.	1
Fingerprint	string	Nilai sidik jari kunci publik Rekaman.	abcdef1234567890
Tag	string	Tag Rekaman. Tag Rekaman CAA menunjukkan tipe dan tujuan spesifiknya.	issue
CreateTime	string	Waktu pembuatan Catatan. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.	2023-03-10T13:30:39Z
UpdateTime	string	Waktu pembaruan Catatan. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.	2023-01-27T02:26:22Z
Proxied	boolean	Apakah percepatan proxy diaktifkan untuk Catatan. Hanya Rekaman CNAME dan A/AAAA yang mendukung percepatan proxy. Nilai valid: true: Percepatan proxy diaktifkan. false: Percepatan proxy dinonaktifkan.	true
RecordId	integer	ID Catatan.	1234567890123
RecordName	string	Nama Catatan.	a.example.com
RecordType	string	Tipe DNS Catatan, seperti A/AAAA, Nama Domain CNAME, atau TXT.	A/AAAA
SiteId	integer	ID situs.	1234567890123
SiteName	string	Nama situs.	example.com
Ttl	integer	Time-to-Live (TTL) Catatan, dalam detik. Nilai 1 menunjukkan bahwa TTL diatur ke Otomatis.	20
RecordSourceType	string	Tipe asal Rekaman CNAME. Nilai valid: OSS: asal OSS. S3: asal S3. LB: asal load balancing. OP: asal Kolam IPAM. Domain: asal Nama domain standar. Jika parameter ini tidak ditentukan atau dikosongkan, nilai default adalah Domain, yang menunjukkan tipe asal Nama domain standar.	OSS
RecordCname	string	Nama Domain CNAME Catatan.	a.example.com.cnamezone.com
Comment	string	Komentar Catatan.	Remarks
AuthConf	object	Informasi otentikasi back-to-origin Rekaman CNAME.
AuthType	string	Tipe otentikasi asal. Nilai valid: public: Baca publik. Pilih nilai ini saat tipe asal adalah OSS atau S3 dan asal mengizinkan akses baca publik. private: Baca privat. Pilih nilai ini saat tipe asal adalah S3 dan asal hanya mengizinkan akses baca privat. private_same_account: Baca privat dalam akun yang sama. Pilih nilai ini saat tipe asal adalah OSS, asal berada di akun Alibaba Cloud yang sama, dan asal hanya mengizinkan akses baca privat. private_cross_account: Baca privat lintas akun. Pilih nilai ini saat tipe asal adalah OSS, asal berada di akun Alibaba Cloud yang berbeda, dan asal hanya mengizinkan akses baca privat.	public
SecretKey	string	Rahasia AccessKey akun tempat asal berada.	u0Nkg5gBK*******QF5wvKMM504JUHt
AccessKey	string	AccessKey ID akun tempat asal berada.	VIxuvJSA2S03f******kp208dy5w7
Version	string	Versi algoritma tanda tangan. Nilai valid: v2 v4 Nilai default: v4.	v2
Region	string	Wilayah tempat asal berada. Dapatkan wilayah dari situs web resmi S3.	us-east-1
HostPolicy	string	Kebijakan HOST back-to-origin. Parameter ini berlaku saat Tipe catatan adalah Nama Domain CNAME. Parameter ini menentukan kebijakan Header HOST untuk permintaan back-to-origin. Nilai valid: follow_hostname: mengikuti Catatan Host. follow_origin_domain: mengikuti Nama domain asal.	follow_origin_domain

Contoh

Respons sukses

JSONformat

{
  "RequestId": "F32C57AA-7BF8-49AE-A2CC-9F42390F5A19",
  "RecordModel": {
    "BizName": "image_video",
    "Data": {
      "Value": "example.com",
      "Priority": 10,
      "Flag": 128,
      "Tags": {
        "test": "test",
        "test2": 1
      },
      "Weight": 0,
      "Port": 8707,
      "Type": 0,
      "KeyTag": 1,
      "Algorithm": 1,
      "Certificate": "dGVzdGFkYWxrcw==",
      "Usage": 0,
      "Selector": 1,
      "MatchingType": 1,
      "Fingerprint": "abcdef1234567890",
      "Tag": "issue"
    },
    "CreateTime": "2023-03-10T13:30:39Z",
    "UpdateTime": "2023-01-27T02:26:22Z",
    "Proxied": true,
    "RecordId": 1234567890123,
    "RecordName": "a.example.com",
    "RecordType": "A/AAAA",
    "SiteId": 1234567890123,
    "SiteName": "example.com",
    "Ttl": 20,
    "RecordSourceType": "OSS ",
    "RecordCname": "a.example.com.cnamezone.com",
    "Comment": "Remarks",
    "AuthConf": {
      "AuthType": "public",
      "SecretKey": "u0Nkg5gBK*******QF5wvKMM504JUHt",
      "AccessKey": "VIxuvJSA2S03f******kp208dy5w7",
      "Version": "v2",
      "Region": "us-east-1"
    },
    "HostPolicy": "follow_origin_domain"
  }
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	InternalException	Failed to call the service. Try again later or contact technical support.
404	Record.NotFound	The record does not exist. Check your configurations and try again.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.