AddVodDomain - ApsaraVideo VOD

Menambahkan nama domain yang dipercepat di ApsaraVideo VOD.

Deskripsi operasi

Operasi ini hanya tersedia di wilayah China (Shanghai).
Sebelum menambahkan nama domain yang dipercepat, Anda harus mengaktifkan ApsaraVideo VOD dan mengajukan pengarsipan Penyedia konten internet (ICP) untuk nama domain tersebut. Untuk informasi selengkapnya tentang cara mengaktifkan ApsaraVideo VOD, lihat Activate ApsaraVideo VOD.
Jika konten pada server origin tidak disimpan di Alibaba Cloud, konten tersebut harus ditinjau oleh Alibaba Cloud. Tinjauan akan selesai paling lambat pada akhir hari kerja berikutnya setelah permohonan diajukan.
Anda hanya dapat menambahkan satu nama domain yang dipercepat dalam satu permintaan. Maksimal 20 nama domain yang dipercepat dapat ditambahkan dalam satu Akun Alibaba Cloud.

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

vod:AddVodDomain

create

*All Resource

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
DomainName	string	Yes	Nama domain yang ingin Anda percepat. Nama domain wildcard yang diawali dengan titik (.) didukung. Contoh: .example.com.	example.com
Sources	string	Yes	Informasi tentang alamat server origin. Untuk informasi selengkapnya, lihat tabel Sources dalam topik ini.	[{"content":"1.1.1.1","type":"ipaddr","priority":"20","port":80}]
CheckUrl	string	No	URL yang digunakan untuk Pemeriksaan kesehatan.	www.example.com/test.html
Scope	string	No	Parameter ini berlaku untuk pengguna level 3 atau lebih tinggi di Daratan Tiongkok dan pengguna di luar Daratan Tiongkok. Nilai default: domestic. Nilai yang valid: domestic: Daratan Tiongkok overseas: luar Daratan Tiongkok global: wilayah di dalam dan luar Daratan Tiongkok	domestic
TopLevelDomain	string	No	Domain tingkat atas.	example.com

Sources

Parameter	Type	Required	Description
type	String	Yes	Jenis server origin. Nilai yang valid: ipaddr: alamat IP. domain: nama domain. oss: domain bucket Object Storage Service (OSS).
content	String	Yes	Alamat server origin. Anda dapat menentukan alamat IP atau nama domain.
port	Integer	No	Nomor port. Nilai yang valid: 443 dan 80. Nilai default: 80. Jika Anda menentukan 443, permintaan akan dialihkan ke server origin melalui HTTPS. Anda juga dapat menentukan port kustom.
priority	String	No	Prioritas server origin jika beberapa server origin ditentukan. Nilai yang valid: 20 dan 30. Nilai default: 20. 20 menunjukkan bahwa server origin adalah server asal utama. 30 menunjukkan bahwa server origin adalah server asal sekunder.

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	15C66C7B-671A-4297-****-2C4477247A74

Contoh

Respons sukses

JSONformat

{
  "RequestId": "15C66C7B-671A-4297-****-2C4477247A74"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	InvalidDomainName.Malformed	Specified DomainName is malformed.
400	MissingParameter	The input parameter cdnType that is mandatory for processing this request is not supplied.
400	InvalidCdnType.Malformed	Specified CdnType is malformed.
400	InvalidSources.Malformed	Specified Sources is malformed.	The origin information is in an invalid format.
400	InvalidSourceStr.Malformed	Specified SourceStr is malformed.	The format of the incoming source information is incorrect.
400	InvalidSourceType.Malformed	Specified CdnType is malformed.
400	InvalidSource.Priority.Malformed	The specified Source Priority is invalid.
400	InvalidTypeAndContent.MissMatch	The specified source type does not match the specified source content.
400	InvalidScope.Malformed	Specified Scope is malformed.
400	DomainOverLimit	The Number of Domain is over the limit
400	DomainAlreadyExist	This domain name is exist already
400	DomainNotRegistration	The Domain name is not registered
400	InvaildParameter	Source name can not equal to domain name
400	IllegalSources	The specified origin site information is invalid.	The origin information of the accelerated domain name is incorrect.
400	SourceIp.Exceed	The Certificate you provided is malformed!
400	InvalidCertificate	The Certificate you provided is malformed!
400	InvalidCertificate.TooLong	The Certificate you provided is over the max length!
400	InnerAddDomainDenied	Your account haven't bind aoneId, can not add domain.
400	CheckSourceHealthFailed	sources ip or source domain check health failed，please input right source.
400	ExtensiveAndAllBothExist	Extensive domain and the domain begins with 'all.' can not exist at the same time.
400	CdnTypeNotSupportExtensiveDomain	Extensive domain not supported for this cdn type.
400	ExtensiveAndSpecificDomainConflict	Extensive domain and corresponding specific domain are mutually exclusive.	Wildcard domain names and specific domain names of the same level as the wildcard domain names are mutually exclusive. Enter another domain name.
400	DomainReserved	The root domain of your domain is reserved by another account. Submit a ticket to contact customer support.	The root domain name is already in use. Submit a ticket.
400	InvalidDomainNameLevel	Domain name suffixed with alicdn.com only support third level.
400	InvalidTopLevelDomain.Malformed	Specified TopLevelDomain is malformed.
400	TopLevelDomain.NotFound	The specified TopLevelDomain does not exist.
400	EntityNotExists.ResourceGroup	The resource group does not exist.
400	InvalidStatus.ResourceGroup	It's now allowed to do this operation because of the current status of resource-group.
400	NotInternationRealIdentity	You need to do real name authentication when you use Chinese mainland resources.	You have not passed real-name verification. According to the regulations issued by MIIT, you must pass real-name verification if you want to purchase IT services in the Chinese mainland.
400	TopLevelDomain.Mismatch	The specified TopLevelDomain does not match webSiteType.
400	DomainOwnerVerifyFail	Owner verification of the root domain failed.	Failed to verify domain ownership.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.