SetLiveDomainCertificate - ApsaraVideo Live

Mengaktifkan atau menonaktifkan sertifikat untuk nama domain dan memperbarui informasinya.

Deskripsi operasi

Pertama, peroleh nama domain streaming langsung. Kemudian, panggil operasi ini untuk mengaktifkan atau menonaktifkan sertifikat pada nama domain tersebut serta memperbarui informasi sertifikatnya.

Batas QPS

Operasi ini memiliki batas pengguna tunggal sebesar 30 permintaan per detik (QPS). Permintaan yang melebihi batas ini akan dikenai pengendalian aliran, yang dapat memengaruhi bisnis Anda. Pastikan untuk memanggil operasi ini dengan laju yang wajar.

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

live:SetLiveDomainCertificate

update

*Domain

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

None

Parameter permintaan

Parameter	Type	Required	Description	Example
DomainName	string	Yes	Nama domain yang dipercepat untuk sertifikat. Nama domain ini harus menggunakan akselerasi HTTPS.	developer.aliyundoc.com
CertName	string	No	Nama sertifikat.	Cert-****
CertType	string	No	Jenis sertifikat. Nilai yang valid: upload: Sertifikat yang diunggah. cas: Sertifikat dari Certificate Management Service. free: Sertifikat uji pribadi (Edisi Gratis).	free
SSLProtocol	string	Yes	Menentukan apakah sertifikat HTTPS diaktifkan. Nilai yang valid: on: Mengaktifkan sertifikat. Jika Anda mengatur parameter ini ke on, Anda juga harus mengatur parameter SSLPub dan SSLPri. off (default): Menonaktifkan sertifikat.	off
SSLPub	string	No	Konten kunci publik. Catatan Parameter ini hanya diperlukan ketika SSLProtocol diatur ke on.	****
SSLPri	string	No	Konten kunci privat. Catatan Parameter ini hanya diperlukan ketika SSLProtocol diatur ke on.	****
ForceSet	string	No	Atur nilainya ke 1 untuk mengabaikan pemeriksaan duplikat nama sertifikat dan menimpa sertifikat yang sudah ada dengan nama yang sama.	1

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

Contoh

Respons sukses

JSONformat

{
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	InvalidSSLProtocol.ValueNotSupported	The specified value of parameter SSLProtocol is not supported.
400	SSLPub.MissingParameter	An input parameter "SSLPub" that is mandatory for processing the request is not supplied.
400	SSLPri.MissingParameter	An input parameter "SSLPri" that is mandatory for processing the request is not supplied.
400	InvalidSSLPub	The SSLPub you provided is malformed!
400	InvalidSSLPri	The SSLPri you provided is malformed!
400	Certificate.MissMatch	The SSLPri does not math the specified Certificate!
400	InvalidCertificate.TooLong	The Certificate you provided is over the max length!
400	InvalidCertName.TooLong	The Certificate name you provided is over the max length 128!
400	IllegalOperationDomain	You are not authorized to operate the domain.
400	Certificate.NotPermittedOff	Turn off certificate will change domain scheduling, please contact customer service
400	Certificate.SettedNotEffect	Certificate was successfully setted but does't take effect for protecting current service, please contact customer service
400	Certificate.NotFind	Not find the certificate info.
400	AuthenticationFailed	Authentication failed.
400	SetDomainCertificate.ParameterError	Parameters have error.
400	InvalidSSLPubOrInvalidSSLPri	The SSLPri or SSLPub you provided is malformed!
400	Certificate.StatusError	Certificate is not exist or its status is error.
400	DeleteFailed	Delete certificate is failed.
400	Certificate.Duplicated	The certificate name is duplicated.
400	Certificate.FormatError	The certificate format is error.
400	Certificate.KeyNull	The private key is not null.
400	Key.Malformed	The private key format is error.
400	CertStorage.failed	The certificate storage failed.
400	CertificateContent.Duplicated	The certificate is already uploaded, please don't upload again.
400	Certificate.Expired	The certificate is expired.
400	InvalidDomain.notOnline	The domain is not online, please check the domain status and try again later.
400	Decode.Error	The certificate sslpub or sslpri decode error.
400	sslPub.Error	The SSLPub encoded failed.
400	sslPri.Error	The SSLPri encoded failed.
400	DomainInSafeMode	This domain is in the safe mode. if you want to do this operation, please contact us!
400	DomainInProtectedMode	This domain is in the protected mode. if you want to do this operation, please contact us!
400	FunctionMutex	Function is mutex with other function.
400	DomainOffline	The domain is not online, please check the domain status and try again later.	The domain is not online, please check the domain status and try again later.
403	IllegalOperation	Illegal domain operate is not permitted.
404	CertName.MissingParameter	The CertName parameter is required.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.