DescribeUserDomains - CDN

Mengambil semua nama domain yang dipercepat dalam Akun Alibaba Cloud Anda beserta statusnya. Anda dapat memfilter nama domain berdasarkan nama atau status, dengan dukungan pencocokan fuzzy.

Deskripsi operasi

Operasi ini dapat dipanggil hingga 100 kali per detik per akun.
Anda dapat menentukan hingga 50 nama domain dalam satu permintaan, dipisahkan dengan koma (,).

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

cdn:DescribeUserDomains

get

*Domain

acs:cdn:*:{#accountId}:domain/*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
PageSize	integer	No	Jumlah entri yang ditampilkan per halaman. Nilai yang valid: 1 hingga 500. Nilai default: 20. Nilai maksimum: 500.	5
PageNumber	integer	No	Nomor halaman. Nilai yang valid: 1 hingga 100000.	1
DomainName	string	No	Nama domain yang dipercepat. Jika Anda tidak menetapkan parameter ini, semua nama domain yang sesuai kondisi akan dikembalikan.	example.com
DomainStatus	string	No	Status nama domain. Nilai yang valid: online offline configuring configure_failed checking check_failed stopping deleting Jika Anda tidak menetapkan parameter ini, nama domain dalam semua status akan diambil.	configure_failed
DomainSearchType	string	No	Mode pencarian. Nilai yang valid: fuzzy_match: pencocokan fuzzy pre_match: pencocokan awalan suf_match: pencocokan akhiran full_match (default): pencocokan eksak Catatan Jika Anda menentukan nama domain yang akan diambil tetapi tidak menetapkan parameter DomainSearchType, mode pencocokan eksak akan digunakan.	fuzzy_match
CdnType	string	No	Jenis workload yang dipercepat oleh Alibaba Cloud CDN. Pisahkan jenis dengan koma (,). Nilai yang valid: web: citra dan file kecil download: file besar video: streaming video dan audio on-demand Jika Anda tidak menetapkan parameter ini, semua jenis layanan akan diambil.	download,web,video
CheckDomainShow	boolean	No	Menentukan apakah akan menampilkan nama domain yang sedang dalam proses peninjauan, gagal dalam peninjauan, atau gagal dikonfigurasi. Nilai yang valid: true false	false
ResourceGroupId	string	No	ID kelompok sumber daya. Secara default, semua ID akan diambil.	abcd1234abcd1234
ChangeStartTime	string	No	Awal rentang waktu untuk kueri. Tentukan waktu dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.	2019-10-10T12:14:55Z
ChangeEndTime	string	No	Akhir rentang waktu untuk kueri. Tentukan waktu dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC. Catatan Waktu akhir harus lebih lambat dari waktu mulai.	2019-10-10T12:14:58Z
Coverage	string	No	Wilayah akselerasi. Secara default, semua wilayah akselerasi akan diambil. Nilai yang valid: domestic: daratan Tiongkok global: global overseas: luar daratan Tiongkok	domestic
Source	string	No	Informasi mengenai server origin.	example.source.com
Tag	array<object>	No	Daftar tag. Jumlah maksimum elemen dalam daftar: 20
	object	No	Detail mengenai tag.
Key	string	No	Kunci tag. Secara default, semua kunci tag akan diambil.	key
Value	string	No	Nilai tag. Secara default, semua nilai tag akan diambil.	value

Elemen respons

Element	Type	Description	Example
	object	Deskripsi data yang dikembalikan.
RequestId	string	ID permintaan.	BDA62CE4-3477-439A-B52E-D2D7C829D7C1
PageNumber	integer	Nomor halaman yang dikembalikan.	1
PageSize	integer	Jumlah entri yang dikembalikan per halaman.	20
TotalCount	integer	Total jumlah entri yang dikembalikan.	2
Domains	object
PageData	array<object>	Daftar nama domain yang dipercepat yang dikembalikan.
	array<object>	Informasi mengenai nama domain yang dipercepat.
SslProtocol	string	Menunjukkan apakah HTTPS diaktifkan. Nilai yang valid: on off	on
Sandbox	string	Menunjukkan apakah nama domain yang dipercepat berada dalam sandbox.	true
GmtModified	string	Waktu ketika nama domain yang dipercepat dimodifikasi.	2015-10-28T11:05:52Z
DomainName	string	Nama domain yang dipercepat.	example.com
DomainId	integer	ID nama domain yang dipercepat.	11223344
GmtCreated	string	Waktu ketika nama domain yang dipercepat ditambahkan.	2015-10-28T09:32:51Z
Description	string	Informasi mengenai pendaftaran Internet Content Provider (ICP).	filing description
Coverage	string	Wilayah akselerasi. Nilai yang valid: domestic: daratan Tiongkok global: global overseas: luar daratan Tiongkok	domestic
ResourceGroupId	string	ID kelompok sumber daya.	abcd1234abcd1234
Cname	string	Nama Domain CNAME yang ditetapkan untuk nama domain yang dipercepat.	example.com.w.alikunlun.net
DomainStatus	string	Status nama domain yang dipercepat. Nilai yang valid: online offline configuring configure_failed checking check_failed stopping deleting	configure_failed
CdnType	string	Jenis workload yang dipercepat oleh Alibaba Cloud CDN. Nilai yang valid: web: citra dan file kecil download: file besar video: streaming video dan audio on-demand	download
Sources	object
Source	array<object>	Informasi mengenai server origin.
	object	Detail mengenai server origin.
Type	string	Jenis server origin.	oss
Weight	string	Bobot server origin jika beberapa server origin telah ditentukan.	15
Priority	string	Prioritas.	20
Port	integer	Port server origin.	80
Content	string	Alamat server origin.	***.oss-cn-hangzhou.aliyuncs.com

Contoh

Respons sukses

JSONformat

{
  "RequestId": "BDA62CE4-3477-439A-B52E-D2D7C829D7C1",
  "PageNumber": 1,
  "PageSize": 20,
  "TotalCount": 2,
  "Domains": {
    "PageData": [
      {
        "SslProtocol": "on",
        "Sandbox": "true",
        "GmtModified": "2015-10-28T11:05:52Z",
        "DomainName": "example.com",
        "DomainId": 11223344,
        "GmtCreated": "2015-10-28T09:32:51Z",
        "Description": "filing description",
        "Coverage": "domestic",
        "ResourceGroupId": "abcd1234abcd1234",
        "Cname": "example.com.w.alikunlun.net",
        "DomainStatus": "configure_failed",
        "CdnType": "download",
        "Sources": {
          "Source": [
            {
              "Type": "oss",
              "Weight": "15",
              "Priority": "20",
              "Port": 80,
              "Content": "***.oss-cn-hangzhou.aliyuncs.com"
            }
          ]
        }
      }
    ]
  }
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	InvalidPageNumber.ValueNotSupported	The specified value of PageNumber is not supported.
400	InvalidPageSize.ValueNotSupported	The specified value of PageSize is invalid.
400	InvalidDomainStatus.ValueNotSupported	The specified value of DomainStatus is invalid.
400	InvalidDomainName.Malformed	The specified DomainName is invalid.	The specified domain name is invalid.
400	InvalidDomainSearchType.ValueNotSupported	The specified value of DomainSearchType is invalid.
400	InvalidChangeStartTime.Malformed	The specified ChangeStartTime is invalid.
400	InvalidChangeEndTime.Malformed	The specified ChangeEndTime is invalid.
400	InvalidCdnType.Malformed	The specified CdnType is invalid.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.