Call SetVodDomainCertificate to configure an HTTPS certificate for a domain - ApsaraVideo VOD - Alibaba Cloud - ApsaraVideo VOD

Configures whether the certificate feature is enabled for a specified domain name and modifies certificate information.

Operation description

Currently, the service address supports only China (Shanghai).

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

vod:SetVodDomainCertificate

create

*All Resource

*

None

Request parameters

Parameter	Type	Required	Description	Example
DomainName	string	Yes	The accelerated domain name to which the certificate belongs. The domain name must be of the HTTPS acceleration type.	example.com
CertName	string	No	The certificate name.	cert_name
SSLProtocol	string	Yes	Specifies whether to enable the HTTPS certificate. Valid values: on: enabled. off (default): disabled.	off
SSLPub	string	No	The content of the security certificate. If you do not enable the certificate, you do not need to enter this parameter. If you configure a certificate, enter the certificate content.	****
SSLPri	string	No	The content of the private key. If you do not enable the certificate, you do not need to enter this parameter. If you configure a certificate, enter the private key content.	****

Response elements

Element	Type	Description	Example
	object
RequestId	string	The request ID.	04F0F334-1335-436C-****-6C044FE73368

Examples

Success response

JSON format

{
  "RequestId": "04F0F334-1335-436C-****-6C044FE73368"
}

Error codes

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	Certificate.NotPermittedOff	Turn off certificate will change domain scheduling, please contact customer service
400	Certificate.SetNotEffect	Certificate was successfully set but doesn't take effect for protecting current service. Please contact customer service.
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.NotFind	Not find the certificate info.
400	Certificate.Duplicated	The certificate name is duplicated.	The certificate name already exists.
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!
403	IllegalOperation	Illegal domain operate is not permitted.
403	ServiceBusy	The specified Domain is configuring, please retry later

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.