forked from docs/doc-exports
Reviewed-by: Hajba, László Antal <laszlo-antal.hajba@t-systems.com> Co-authored-by: zhoumeng <zhoumeng35@huawei.com> Co-committed-by: zhoumeng <zhoumeng35@huawei.com>
346 lines
30 KiB
HTML
346 lines
30 KiB
HTML
<a name="UpdateCertificate"></a><a name="UpdateCertificate"></a>
|
|
|
|
<h1 class="topictitle1">Updating a Certificate</h1>
|
|
<div id="body162894481414"><div class="section" id="UpdateCertificate__section16289144201418"><h4 class="sectiontitle">Function</h4><p id="UpdateCertificate__p428954181410">This API is used to update an SSL certificate.</p>
|
|
</div>
|
|
<div class="section" id="UpdateCertificate__section02894491413"><h4 class="sectiontitle">Constraints</h4><p id="UpdateCertificate__p728912471415">If a certificate wth a domain name is used by a listener, the domain name cannot be updated to an empty string (""), and the system returns the 409 Conflict status code.</p>
|
|
</div>
|
|
<div class="section" id="UpdateCertificate__section328919416141"><h4 class="sectiontitle">URI</h4><p id="UpdateCertificate__p16289442144">PUT /v3/{project_id}/elb/certificates/{certificate_id}</p>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="UpdateCertificate__table6290144101418" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Path Parameters</caption><thead align="left"><tr id="UpdateCertificate__row329004121417"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.1"><p id="UpdateCertificate__p6290104131412">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.2"><p id="UpdateCertificate__p8290124131419">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.3"><p id="UpdateCertificate__p112901416143">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.3.2.5.1.4"><p id="UpdateCertificate__p129094131420">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="UpdateCertificate__row829054121419"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="UpdateCertificate__p429020411146">certificate_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="UpdateCertificate__p829011471412">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="UpdateCertificate__p129119411414">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="UpdateCertificate__p1929117419145">Specifies a certificate ID.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="UpdateCertificate__row3290134141416"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="UpdateCertificate__p429119421410">project_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="UpdateCertificate__p42915411414">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="UpdateCertificate__p22919481418">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="UpdateCertificate__p142915419148">Specifies the project ID of the certificate.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="UpdateCertificate__section1729119401413"><h4 class="sectiontitle">Request Parameters</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="UpdateCertificate__HeaderParameter" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request header parameters</caption><thead align="left"><tr id="UpdateCertificate__row6291546148"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.2.5.1.1"><p id="UpdateCertificate__p152912491417">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.2.5.1.2"><p id="UpdateCertificate__p62923411418">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.2.5.1.3"><p id="UpdateCertificate__p1729244131420">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.4.2.2.5.1.4"><p id="UpdateCertificate__p129284181410">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="UpdateCertificate__row629194131412"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.5.1.1 "><p id="UpdateCertificate__p2029210412142">X-Auth-Token</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.5.1.2 "><p id="UpdateCertificate__p10292164141410">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.2.5.1.3 "><p id="UpdateCertificate__p162925451417">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.2.2.5.1.4 "><p id="UpdateCertificate__p16292184201420">Specifies the token used for IAM authentication.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="UpdateCertificate__request_UpdateCertificateRequestBody" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Request body parameters</caption><thead align="left"><tr id="UpdateCertificate__row4292164191417"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.3.2.5.1.1"><p id="UpdateCertificate__p3293174151412">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.3.2.5.1.2"><p id="UpdateCertificate__p5293184121414">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.3.2.5.1.3"><p id="UpdateCertificate__p9293245143">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.4.3.2.5.1.4"><p id="UpdateCertificate__p129320461411">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="UpdateCertificate__row12292104171416"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.1 "><p id="UpdateCertificate__p42931948144">certificate</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.2 "><p id="UpdateCertificate__p929354181416">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.3.2.5.1.3 "><p id="UpdateCertificate__p3293104121418"><a href="#UpdateCertificate__request_UpdateCertificateOption">UpdateCertificateOption</a> object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.3.2.5.1.4 "><p id="UpdateCertificate__p22931943142">Specifies the certificate.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="UpdateCertificate__request_UpdateCertificateOption"></a><a name="request_UpdateCertificateOption"></a><table cellpadding="4" cellspacing="0" summary="" id="UpdateCertificate__request_UpdateCertificateOption" frame="border" border="1" rules="all"><caption><b>Table 4 </b>UpdateCertificateOption</caption><thead align="left"><tr id="UpdateCertificate__row029317481414"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.4.2.5.1.1"><p id="UpdateCertificate__p18294546148">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.4.2.5.1.2"><p id="UpdateCertificate__p1294164141417">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.4.2.5.1.3"><p id="UpdateCertificate__p122946413149">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.4.4.2.5.1.4"><p id="UpdateCertificate__p729410411144">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="UpdateCertificate__row162933471415"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.1 "><p id="UpdateCertificate__p429414419144">certificate</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.2 "><p id="UpdateCertificate__p1329413471413">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.3 "><p id="UpdateCertificate__p329414131412">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.4.2.5.1.4 "><p id="UpdateCertificate__p152942413141">Specifies the private key of the certificate. The value must be PEM encoded.</p>
|
|
<p id="UpdateCertificate__p1229410411412">Maximum 65,536 character length is allowed, supports certificate chains with a maximum of 11 layers (including certificates and certificate chains).</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="UpdateCertificate__row4293246144"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.1 "><p id="UpdateCertificate__p829413417149">description</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.2 "><p id="UpdateCertificate__p429514417149">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.3 "><p id="UpdateCertificate__p1829517419144">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.4.2.5.1.4 "><p id="UpdateCertificate__p929516441411">Provides supplementary information about the certificate.</p>
|
|
<p id="UpdateCertificate__p6295444147">Minimum: <strong id="UpdateCertificate__b129544201411">0</strong></p>
|
|
<p id="UpdateCertificate__p172957421411">Maximum: <strong id="UpdateCertificate__b429518413145">255</strong></p>
|
|
</td>
|
|
</tr>
|
|
<tr id="UpdateCertificate__row13293844142"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.1 "><p id="UpdateCertificate__p132952411415">name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.2 "><p id="UpdateCertificate__p132951543146">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.3 "><p id="UpdateCertificate__p42951048143">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.4.2.5.1.4 "><p id="UpdateCertificate__p729594171413">Specifies the certificate name.</p>
|
|
<p id="UpdateCertificate__p19295144171411">Minimum: <strong id="UpdateCertificate__b1129512461415">0</strong></p>
|
|
<p id="UpdateCertificate__p1529519419143">Maximum: <strong id="UpdateCertificate__b162951040145">255</strong></p>
|
|
</td>
|
|
</tr>
|
|
<tr id="UpdateCertificate__row42931346141"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.1 "><p id="UpdateCertificate__p4295244147">private_key</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.2 "><p id="UpdateCertificate__p132956471411">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.3 "><p id="UpdateCertificate__p9296154101410">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.4.2.5.1.4 "><p id="UpdateCertificate__p2296242143">Specifies the private key of the server certificate. The value must be PEM encoded. Maximum 8,192 character length is allowed.</p>
|
|
<ul id="UpdateCertificate__ul11296244143"><li id="UpdateCertificate__li42961145147">This parameter is valid and mandatory only when <strong id="UpdateCertificate__b15296114141419">type</strong> is set to <strong id="UpdateCertificate__b132961048145">server</strong>.</li><li id="UpdateCertificate__li11296194181418">This parameter will not take effect and an error will be returned if <strong id="UpdateCertificate__b829713451420">type</strong> is set to <strong id="UpdateCertificate__b1429712418142">client</strong>.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="UpdateCertificate__row15294164191412"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.1 "><p id="UpdateCertificate__p12970420144">domain</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.2 "><p id="UpdateCertificate__p1629784181416">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.3 "><p id="UpdateCertificate__p1729711471418">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.4.2.5.1.4 "><p id="UpdateCertificate__p087184191416">Specifies the domain names used by the server certificate.</p>
|
|
<p id="UpdateCertificate__p20872417143">Note the following when using domain names:</p>
|
|
<ul id="UpdateCertificate__ul1787542148"><li id="UpdateCertificate__li58724181414">The value can contain 0 to 10,000 characters and consists of multiple common domain names or wildcard domain names separated by commas. A maximum of 100 domain names are allowed.</li><li id="UpdateCertificate__li1988547141">A common domain name consists of several labels separated by periods (.). Each label can contain a maximum of 63 characters, including letters, digits, and hyphens (-), and must start and end with a letter or digit. Example: www.test.com</li><li id="UpdateCertificate__li10880451419">A wildcard domain name is a domain name starts with an asterisk (*). Example: *.test.com</li><li id="UpdateCertificate__li1442815511198">This parameter will take effect only when **type** is set to **server**.</li><li id="UpdateCertificate__li814153711913">SNI certificates of a dedicated load balancer's listener can have up to 200 domain names.</li><li id="UpdateCertificate__li16397631015">SNI certificates of a shared load balancer's listener can have up to 30 domain names.</li></ul>
|
|
<p id="UpdateCertificate__p17297144101415">Minimum: <strong id="UpdateCertificate__b1329717416146">0</strong></p>
|
|
<p id="UpdateCertificate__p329714418147">Maximum: <strong id="UpdateCertificate__b13241172361511">10000</strong></p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="UpdateCertificate__section122978411414"><h4 class="sectiontitle">Response Parameters</h4><p id="UpdateCertificate__p8298246146"><strong id="UpdateCertificate__b429834171416">Status code: 200</strong></p>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="UpdateCertificate__response_UpdateCertificateResponseBody" frame="border" border="1" rules="all"><caption><b>Table 5 </b>Response body parameters</caption><thead align="left"><tr id="UpdateCertificate__row1729884171415"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.5.3.2.4.1.1"><p id="UpdateCertificate__p229818491412">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.5.3.2.4.1.2"><p id="UpdateCertificate__p142989410149">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.5.3.2.4.1.3"><p id="UpdateCertificate__p32986431416">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="UpdateCertificate__row82983418149"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.3.2.4.1.1 "><p id="UpdateCertificate__p1429810411418">request_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.3.2.4.1.2 "><p id="UpdateCertificate__p32991145144">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.3.2.4.1.3 "><p id="UpdateCertificate__p4299174181410">Specifies the request ID. The value is automatically generated.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="UpdateCertificate__row4298164201410"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.3.2.4.1.1 "><p id="UpdateCertificate__p629917418142">certificate</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.3.2.4.1.2 "><p id="UpdateCertificate__p102991421413"><a href="#UpdateCertificate__response_CertificateInfo">CertificateInfo</a> object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.3.2.4.1.3 "><p id="UpdateCertificate__p12995419148">Specifies the certificate.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="UpdateCertificate__response_CertificateInfo"></a><a name="response_CertificateInfo"></a><table cellpadding="4" cellspacing="0" summary="" id="UpdateCertificate__response_CertificateInfo" frame="border" border="1" rules="all"><caption><b>Table 6 </b>CertificateInfo</caption><thead align="left"><tr id="UpdateCertificate__row5299547144"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.5.4.2.4.1.1"><p id="UpdateCertificate__p14300174151412">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.5.4.2.4.1.2"><p id="UpdateCertificate__p17300164101415">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.5.4.2.4.1.3"><p id="UpdateCertificate__p163009416149">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="UpdateCertificate__row8299154191415"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.1 "><p id="UpdateCertificate__p1030015461418">admin_state_up</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.2 "><p id="UpdateCertificate__p030015451413">Boolean</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.4.2.4.1.3 "><p id="UpdateCertificate__p23002043140">Specifies the administrative status of the certificate.</p>
|
|
<p id="UpdateCertificate__p4300843143">This parameter is unsupported. Please do not use it.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="UpdateCertificate__row19299104141411"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.1 "><p id="UpdateCertificate__p13300446143">certificate</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.2 "><p id="UpdateCertificate__p16301144101416">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.4.2.4.1.3 "><p id="UpdateCertificate__p16301049144">Specifies the certificate content. The value must be PEM encoded.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="UpdateCertificate__row029910414145"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.1 "><p id="UpdateCertificate__p16301846142">description</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.2 "><p id="UpdateCertificate__p12301548145">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.4.2.4.1.3 "><p id="UpdateCertificate__p630119416140">Provides supplementary information about the certificate.</p>
|
|
<p id="UpdateCertificate__p230113413145">Minimum: <strong id="UpdateCertificate__b113019419148">1</strong></p>
|
|
<p id="UpdateCertificate__p1130117471415">Maximum: <strong id="UpdateCertificate__b1430114151410">255</strong></p>
|
|
</td>
|
|
</tr>
|
|
<tr id="UpdateCertificate__row729914412145"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.1 "><p id="UpdateCertificate__p23015411415">domain</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.2 "><p id="UpdateCertificate__p630113411146">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.4.2.4.1.3 "><p id="UpdateCertificate__p967441451319">Specifies the domain names used by the server certificate.</p>
|
|
<p id="UpdateCertificate__p7674214101319">Note the following when using domain names:</p>
|
|
<ul id="UpdateCertificate__ul2674814181310"><li id="UpdateCertificate__li167414143138">The value can contain 0 to 10,000 characters and consists of multiple common domain names or wildcard domain names separated by commas. A maximum of 100 domain names are allowed.</li><li id="UpdateCertificate__li126746146136">A common domain name consists of several labels separated by periods (.). Each label can contain a maximum of 63 characters, including letters, digits, and hyphens (-), and must start and end with a letter or digit. Example: www.test.com</li><li id="UpdateCertificate__li96741142134">A wildcard domain name is a domain name starts with an asterisk (*). Example: *.test.com</li><li id="UpdateCertificate__li19674914111317">This parameter will take effect only when **type** is set to **server**.</li><li id="UpdateCertificate__li12674014131315">SNI certificates of a dedicated load balancer's listener can have up to 200 domain names.</li><li id="UpdateCertificate__li18424527141019">SNI certificates of a shared load balancer's listener can have up to 30 domain names.</li></ul>
|
|
<p id="UpdateCertificate__p10302194151411">Minimum: <strong id="UpdateCertificate__b123027421418">1</strong></p>
|
|
<p id="UpdateCertificate__p143021444142">Maximum: <strong id="UpdateCertificate__b191491538131516">10000</strong></p>
|
|
</td>
|
|
</tr>
|
|
<tr id="UpdateCertificate__row92997491414"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.1 "><p id="UpdateCertificate__p1730215420148">id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.2 "><p id="UpdateCertificate__p193021643142">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.4.2.4.1.3 "><p id="UpdateCertificate__p1430219421410">Specifies the certificate ID.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="UpdateCertificate__row729917471410"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.1 "><p id="UpdateCertificate__p1330212491418">name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.2 "><p id="UpdateCertificate__p630217412144">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.4.2.4.1.3 "><p id="UpdateCertificate__p123021945142">Specifies the certificate name.</p>
|
|
<p id="UpdateCertificate__p1830274101417">Minimum: <strong id="UpdateCertificate__b73026441414">1</strong></p>
|
|
<p id="UpdateCertificate__p193021448143">Maximum: <strong id="UpdateCertificate__b3302164121419">255</strong></p>
|
|
</td>
|
|
</tr>
|
|
<tr id="UpdateCertificate__row72996441418"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.1 "><p id="UpdateCertificate__p7302154191416">private_key</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.2 "><p id="UpdateCertificate__p153021144140">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.4.2.4.1.3 "><p id="UpdateCertificate__p1930324151420">Specifies the private key of the certificate used by HTTPS listeners. The value can contain up to 8,192 PEM encoded characters.</p>
|
|
<ul id="UpdateCertificate__ul330315421417"><li id="UpdateCertificate__li3303144161417">This parameter is valid and mandatory only when <strong id="UpdateCertificate__b530334201414">type</strong> is set to <strong id="UpdateCertificate__b2303549148">server</strong>.</li><li id="UpdateCertificate__li193031746141">This parameter will be ignored even if <strong id="UpdateCertificate__b1530344151418">type</strong> is set to <strong id="UpdateCertificate__b03032413149">client</strong>. A CA certificate can still be created and used normally.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="UpdateCertificate__row15300446143"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.1 "><p id="UpdateCertificate__p63031418142">type</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.2 "><p id="UpdateCertificate__p1530344171417">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.4.2.4.1.3 "><p id="UpdateCertificate__p12303346145">Specifies the certificate type. The value can be <strong id="UpdateCertificate__b143031641141">server</strong> or <strong id="UpdateCertificate__b1730318420141">client</strong>. <strong id="UpdateCertificate__b10303442142">server</strong> indicates server certificates, and <strong id="UpdateCertificate__b130317415148">client</strong> indicates CA certificates. The default value is <strong id="UpdateCertificate__b9303144101419">server</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="UpdateCertificate__row1730010431414"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.1 "><p id="UpdateCertificate__p14303441143">created_at</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.2 "><p id="UpdateCertificate__p830304141415">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.4.2.4.1.3 "><p id="UpdateCertificate__p830364121416">Specifies the time when the certificate was created.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="UpdateCertificate__row183003413148"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.1 "><p id="UpdateCertificate__p23036431411">updated_at</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.2 "><p id="UpdateCertificate__p1330354181416">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.4.2.4.1.3 "><p id="UpdateCertificate__p73042461416">Specifies the time when the certificate was updated.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="UpdateCertificate__row0300194141417"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.1 "><p id="UpdateCertificate__p830410410141">expire_time</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.2 "><p id="UpdateCertificate__p13304104161410">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.4.2.4.1.3 "><p id="UpdateCertificate__p1304846144">Specifies the time when the certificate expires.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="UpdateCertificate__row4300164111412"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.1 "><p id="UpdateCertificate__p330414441410">project_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.5.4.2.4.1.2 "><p id="UpdateCertificate__p33045413144">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.5.4.2.4.1.3 "><p id="UpdateCertificate__p9304194181412">Specifies the project ID of the certificate.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="UpdateCertificate__section10304842141"><h4 class="sectiontitle">Example Requests</h4><pre class="screen" id="UpdateCertificate__screen43044421420">PUT https://{ELB_Endponit}/v3/99a3fff0d03c428eac3678da6a7d0f24/elb/certificates/233a325e5e3e4ce8beeb320aa714cc12
|
|
|
|
{
|
|
"certificate" : {
|
|
"name" : "My Certificate",
|
|
"description" : "Update my Certificate."
|
|
}
|
|
}</pre>
|
|
</div>
|
|
<div class="section" id="UpdateCertificate__section430516441414"><h4 class="sectiontitle">Example Responses</h4><p id="UpdateCertificate__p630518414149"><strong id="UpdateCertificate__b103051421415">Status code: 200</strong></p>
|
|
<p id="UpdateCertificate__p13059471416">Successful request.</p>
|
|
<pre class="screen" id="UpdateCertificate__screen1430514491420">{
|
|
"certificate" : {
|
|
"private_key" : "-----BEGIN PRIVATE KEY-----MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQDQVAbOLe5xNf4M253Wn9vhdUzojetjv4J+B7kYwsMhRcgdcJ8KCnX1nfzTvI2ksXlTQ2o9BkpStnPetB4s32ZiJRMlk+61iUUMNsHwK2WBX57JT3JgmyVbH8GbmRY0+H3sH1i72luna7rMMD30gLh6QoP3cq7PGWcuZKV7hjd1tjCTQukwMvqV8Icq39buNpIgDOWzEP5AzqXtCOFYn6RTH5SRug4hKNN7sT1eYMslHu7wtEBDKVgrLjOCe/W2f8rLT1zEsoAW2ChlZAPYUBkl/0XuTWRg3CohPPcI+UtlRSfvLDeeQ460swjbwgS/RbJh3sIwlCRLU08kEo04Z9H/AgMBAAECggEAEIeaQqHCWZk/HyYN0Am/GJSGFa2tD60SXY2fUieh8/HlfvCArftGgMaYWPSNCJRMXB7tPwpQu19esjz4Z/cR2Je4fTLPrffGUsHFgZjv5OQBZVe4a5Hj1OcgJYhwCqPs2d9i2wToYNBbcfgh8lSETq8YaXngBO6vES9LMhHkNKKrciu9YkInNEHu6uRJ5g/eGGX3KQynTvVIhnOVGAJvjTXcoU6fm7gYdHAD6jk9lc9MEGpfYI6AdHIwFZcT/RNAxhP82lg2gUJSgAu66FfDjMwQXKbafKdP3zq4Up8a7AlekrguPtfV1vWklg+bUFhgGaiAEYTpAUN9t2DVIiijgQKBgQDnYMMsaF0r557CM1CTXUqgCZo8MKeV2jf2drlxRRwRl33SksQbzAQ/qrLdT7GP3sCGqvkxWY2FPdFYf8kxGcCeZPcIeZYCQAM41pjtsaM8tVbLWVR8UtGBuQoPSph7JNF3Tm/JH/fbwjpjP7dtJ7n8EzkRUNE6aIMHOFEeych/PQKBgQDmf1bMogx63rTcwQ0PEZ9Vt7mTgKYK4aLriWgTWHXPZxUQaYhpjXo6+lMI6DpExiDgBAkMzJGIvS7yQiYWU+wthAr9urbWYdGZlS6VjoTkF6r7VZoILXX0fbuXh6lm8K8IQRfBpJff56p9phMwaBpDNDrfpHB5utBUxs40yIdp6wKBgQC69Cp/xUwTX7GdxQzEJctYiKnBHKcspAg38zJf3bGSXU/jR4eB1lVQhELGI9CbKSdzKM71GyEImix/T7FnJSHIWlho1qVo6AQyduNWnAQD15pr8KAdXGXAZZ1FQcb3KYa+2fflERmazdOTwjYZ0tGqZnXkEeMdSLkmqlCRigWhGQKBgDak/735uP20KKqhNehZpC2dJei7OiIgRhCS/dKASUXHSW4fptBnUxACYocdDxtY4VhafI7FPMdvGl8ioYbvlHFh+X0Xs9r1S8yeWnHoXMb6eXWmYKMJrAoveLa+2cFm1Agf7nLhA4R4lqm9IpV6SKegDUkR4fxp9pPyodZPqBLLAoGBAJkD4wHW54Pwd4Ctfk9ojHjWB7pQlUYpTZO9dm+4fpCMn9Okf43AE2yAOaAP94GdzdDJkxfciXKcsYr9IIukfaoXgjKR7p1zERiWZuFF63SB4aiyX1H7IX0MwHDZQO38a5gZaOm/BUlGKMWXzuEd3fy+1rCUwzOp9LSjtJYf4ege-----END PRIVATE KEY-----",
|
|
"description" : "Update my Certificate.",
|
|
"domain" : null,
|
|
"created_at" : "2019-03-31T22:23:51Z",
|
|
"expire_time" : "2045-11-17T13:25:47Z",
|
|
"id" : "233a325e5e3e4ce8beeb320aa714cc12",
|
|
"name" : "My Certificate",
|
|
"certificate" : "-----BEGIN CERTIFICATE-----MIIC4TCCAcmgAwIBAgICEREwDQYJKoZIhvcNAQELBQAwFzEVMBMGA1UEAxMMTXlDb21wYW55IENBMB4XDTE4MDcwMjEzMjU0N1oXDTQ1MTExNzEzMjU0N1owFDESMBAGA1UEAwwJbG9jYWxob3N0MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA0FQGzi3ucTX+DNud1p/b4XVM6I3rY7+Cfge5GMLDIUXIHXCfCgp19Z3807yNpLF5U0NqPQZKUrZz3rQeLN9mYiUTJZPutYlFDDbB8CtlgV+eyU9yYJslWx/Bm5kWNPh97B9Yu9pbp2u6zDA99IC4ekKD93KuzxlnLmSle4Y3dbYwk0LpMDL6lfCHKt/W7jaSIAzlsxD+QM6l7QjhWJ+kUx+UkboOISjTe7E9XmDLJR7u8LRAQylYKy4zgnv1tn/Ky09cxLKAFtgoZWQD2FAZJf9F7k1kYNwqITz3CPlLZUUn7yw3nkOOtLMI28IEv0WyYd7CMJQkS1NPJBKNOGfR/wIDAQABozowODAhBgNVHREEGjAYggpkb21haW4uY29thwQKuUvJhwR/AAABMBMGA1UdJQQMMAoGCCsGAQUFBwMBMA0GCSqGSIb3DQEBCwUAA4IBAQA8lMQJxaTey7EjXtRLSVlEAMftAQPG6jijNQuvIBQYUDauDT4W2XUZ5wAnjiOyQ83va672K1G9s8n6xlH+xwwdSNnozaKzC87vwSeZKIOdl9I5I98TGKI6OoDaezmzCwQYtHBMVQ4c7Ml8554Ft1mWSt4dMAK2rzNYjvPRLYlzp1HMnI6hkjPk4PCZwKnha0dlScati9CCt3UzXSNJOSLalKdHErH08Iqd+1BchScxCfk0xNITn1HZZGmI+vbmunok3A2lucI14rnsrcbkGYqxGikySN6B2cRLBDK4Y3wChiW6NVYtVqcx5/mZiYsGDVN+9QBd0eYUHce+77s96i3I-----END CERTIFICATE-----",
|
|
"admin_state_up" : true,
|
|
"project_id" : "99a3fff0d03c428eac3678da6a7d0f24",
|
|
"updated_at" : "2019-03-31T23:26:49Z",
|
|
"type" : "server"
|
|
},
|
|
"request_id" : "d9abea6b-98ee-4ad4-8c5d-185ded48742f"
|
|
}</pre>
|
|
</div>
|
|
<div class="section" id="UpdateCertificate__section1530610414148"><h4 class="sectiontitle">Status Codes</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="UpdateCertificate__status_code" frame="border" border="1" rules="all"><thead align="left"><tr id="UpdateCertificate__row7306114151411"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.8.2.1.3.1.1"><p id="UpdateCertificate__p15306154121416">Status Code</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="85%" id="mcps1.3.8.2.1.3.1.2"><p id="UpdateCertificate__p230615414147">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="UpdateCertificate__row163065418141"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.8.2.1.3.1.1 "><p id="UpdateCertificate__p73068414146">200</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.8.2.1.3.1.2 "><p id="UpdateCertificate__p930634131410">Successful request.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="UpdateCertificate__section133064412146"><h4 class="sectiontitle">Error Codes</h4><p id="UpdateCertificate__p163071948146">See <a href="ErrorCode.html">Error Codes</a>.</p>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="module_certificates.html">Certificate</a></div>
|
|
</div>
|
|
</div>
|
|
|