Tous les produits
Search
Centre de documentation

:SetVodDomainSSLCertificate

Dernière mise à jour :Aug 05, 2026

Configure l'activation de la fonctionnalité de certificat pour un nom de domaine spécifié et met à jour les informations du certificat.

Description de l'opération

  • Cette opération prend actuellement en charge uniquement la région China East 2 (Shanghai).

  • Nombre maximal d'appels par utilisateur : 30 appels par seconde.

  • Méthode de requête : POST.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

  • Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.

  • API : l'API que vous pouvez appeler pour exécuter l'action.

  • Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.

  • Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.

    • Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.

    • Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.

  • Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.

  • Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

vod:SetVodDomainSSLCertificate

update

*All Resource

*

Aucune Aucune

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

DomainName

string

Oui

Le nom de domaine accéléré pour ApsaraVideo VOD.

example.com

CertName

string

Non

Le nom du certificat.

cert_name

CertId

integer

Non

L'identifiant du certificat.

12342707

CertType

string

Non

Le type de certificat. Valeurs valides :

  • upload : un certificat téléchargé.

  • cas : un certificat provenant de SSL Certificates Service.

cas

SSLProtocol

string

Oui

Indique si le certificat HTTPS doit être activé. Valeurs valides :

  • on : activé.

  • off : désactivé.

off

SSLPub

string

Non

Le contenu du certificat de sécurité. Si vous n'activez pas le certificat, vous n'avez pas besoin de spécifier ce paramètre. Si vous configurez un certificat, saisissez le contenu du certificat.

****

SSLPri

string

Non

Le contenu de la clé privée. Si vous n'activez pas le certificat, vous n'avez pas besoin de spécifier ce paramètre. Si vous configurez un certificat, saisissez le contenu de la clé privée.

****

CertRegion

string

Non

La région du certificat. Valeurs valides :

  • ap-southeast-1 (Singapour)

  • cn-hangzhou (Hangzhou)

Valeur par défaut : cn-hangzhou.

cn-hangzhou

Env

string

Non

Indique si le certificat doit être distribué dans un environnement de déploiement canari. Valeurs valides :

  • staging : distribue le certificat dans un environnement de déploiement canari.

Si ce paramètre n'est pas spécifié ou s'il est défini sur une autre valeur, le certificat est distribué officiellement.

staging

Éléments de réponse

Élément

Type

Description

Exemple

object

RequestId

string

L'identifiant de la requête.

F4C6D5BE-BF13-45*****6C-516EA8906DCD

Exemples

JSON format

{
  "RequestId": "F4C6D5BE-BF13-45*****6C-516EA8906DCD"
}

Codes d'erreur

Code de statut HTTP

Code d'erreur

Message d'erreur

Description

400 InvalidSSLProtocol.ValueNotSupported The specified SSLProtocol is invalid.
400 SSLPub.MissingParameter The SSLPub parameter is required.
400 SSLPri.MissingParameter The SSLPri parameter is required.
400 InvalidSSLPub The specified SSLPub is invalid.
400 InvalidSSLPri The specified SSLPri is invalid.
400 Certificate.MissMatch The SSLPri does not match the certificate.
400 InvalidCertificate.TooLong The maximum length of the certificate is exceeded.
400 InvalidCertName.TooLong The length of the certificate name cannot exceed 128 characters.
400 AuthenticationFailed Error performing verification.
400 SetDomainCertificate.ParameterError The specified parameters are invalid.
400 Certificate.StatusError The status of the certificate is invalid.
400 DeleteFailed Error deleting the certificate.
400 Certificate.NotFind The certificate does not exist.
400 Certificate.Duplicated The certificate name already exists.
400 Certificate.FormatError The format of the certificate is invalid.
400 Certificate.KeyNull The private key is required.
400 Key.Malformed The specified Key format is invalid.
400 CertStorage.failed Error saving the certificate.
400 CertificateContent.Duplicated The certificate has been uploaded; do not upload again.
400 Certificate.Expired The certificate has expired.
400 InvalidDomain.notOnline The domain is offline. Check the status of the domain and try again later.
400 Decode.Error Error decoding the SSLPub or SSLPri certificate.
400 sslPub.Error Error encoding SSLPub.
400 sslPri.Error Error encoding SSLPri.
400 DomainInSafeMode The domain is in safe mode. To request permission, contact Customer Service.
400 CreateCertificateFailed Create certificate failed,please try again.
400 Abs.CertRegion.ValueNotSupported CertRegion is not supported.
400 CertNameAlreadyExists The CertName already exists.
400 InvalidDomain.Offline The domain provided is offline.
400 DomainOwnerVerifyFail Owner verification of the root domain failed. Failed to verify domain ownership.
403 DomainInProtectedMode The domain is in protection mode. To request permission, contact Customer Service.
404 CertName.MissingParameter You must specify CertName.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.