Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda/ Elastic Load Balance/ Referencia de la API/ API del balanceador de carga dedicado/ Certificado/ Actualización de un certificado

Actualización más reciente 2022-11-17 GMT+08:00

Ver PDF

Actualización de un certificado

Función

Esta API se utiliza para actualizar un certificado SSL.

Restricciones

Si un agente de escucha utiliza un certificado con un nombre de dominio, el nombre de dominio no se puede actualizar a una cadena vacía (""), y el sistema devuelve el código de estado de conflicto 409.

URI

PUT /v3/{project_id}/elb/certificates/{certificate_id}

**Tabla 1** Parámetros de path
Parámetro	Obligatorio	Tipo	Descripción
certificate_id	Sí	String	Especifica un ID de certificado.
project_id	Sí	String	Especifica el ID de proyecto del certificado.

Parámetros de solicitud

**Tabla 2** Parámetros de encabezado de solicitud
Parámetro	Obligatorio	Tipo	Descripción
X-Auth-Token	Sí	String	Especifica el token utilizado para la autenticación IAM.

**Tabla 3** Parámetros de body de solicitud
Parámetro	Obligatorio	Tipo	Descripción
certificate	Sí	UpdateCertificateOption object	Especifica el certificado.

**Tabla 4** UpdateCertificateOption
Parámetro	Obligatorio	Tipo	Descripción
certificate	No	String	Especifica la clave privada del certificado. El valor debe estar codificado por PEM. Longitud máxima: caracteres 65,536 Admite cadenas de certificados con un máximo de 11 capas (incluyendo certificados y cadenas de certificados).
description	No	String	Proporciona información adicional sobre el certificado. Mínimo: 0 Máximo: 255
name	No	String	Especifica el nombre del certificado. Mínimo: 0 Máximo: 255
private_key	No	String	Especifica la clave privada del certificado de servidor. El valor debe estar codificado por PEM. Este parámetro se omitirá si type se establece en client. Un certificado de CA todavía se puede crear y utilizar normalmente. Este parámetro se dejará en blanco incluso si introduce una clave privada que no esté codificada por PEM. Este parámetro es válido y obligatorio solo cuando type se establece en server. Si introduce una clave privada no válida, se devuelve un error. Longitud máxima: 8,192 caracteres
domain	No	String	Especifica los nombres de dominio utilizados por el certificado de servidor. Este parámetro solo tendrá efecto cuando el type se establece en server. El valor puede contener de 0 a 1024 caracteres y consta de varios nombres de dominio comunes o nombres de dominio comodín separados por comas. Se permite un máximo de 30 nombres de dominio. Un nombre de dominio común consta de varias etiquetas separadas por puntos (.). Cada etiqueta puede contener un máximo de 63 caracteres, incluyendo letras, dígitos y guiones (-) y debe comenzar y terminar con una letra o dígito. Ejemplo www.test.com Un nombre de dominio comodín es un nombre de dominio que comienza con un asterisco (). Ejemplo: .test.com Mínimo: 0 Máximo: 1024

Parámetros de respuesta

Código de estado: 200

**Tabla 5** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
request_id	String	Especifica el ID de la solicitud. El valor se genera automáticamente.
certificate	CertificateInfo object	Especifica el certificado.

**Tabla 6** CertificateInfo
Parámetro	Tipo	Descripción
admin_state_up	Boolean	Especifica el estado administrativo del certificado. Este parámetro no es compatible. Por favor, no lo use.
certificate	String	Especifica el contenido del certificado. El valor debe estar codificado por PEM.
description	String	Proporciona información adicional sobre el certificado. Mínimo: 1 Máximo: 255
domain	String	Especifica los nombres de dominio utilizados por el certificado de servidor. Este parámetro solo tendrá efecto cuando el type se establece en server. El valor puede contener de 0 a 1024 caracteres y consta de varios nombres de dominio comunes o nombres de dominio comodín separados por comas. Se permite un máximo de 30 nombres de dominio. Un nombre de dominio común consta de varias etiquetas separadas por puntos (.). Cada etiqueta puede contener un máximo de 63 caracteres, incluyendo letras, dígitos y guiones (-) y debe comenzar y terminar con una letra o dígito. Ejemplo www.test.com Un nombre de dominio comodín es un nombre de dominio que comienza con un asterisco (). Ejemplo: .test.com Mínimo: 1 Máximo: 1024
id	String	Especifica el ID del certificado.
name	String	Especifica el nombre del certificado. Mínimo: 1 Máximo: 255
private_key	String	Especifica la clave privada del certificado de servidor. El valor debe estar codificado por PEM. Este parámetro se ignorará incluso si type está establecido en client. Un certificado de CA todavía se puede crear y utilizar normalmente. Este parámetro se dejará en blanco incluso si introduce una clave privada que no esté codificada por PEM. Este parámetro es válido y obligatorio solo cuando type se establece en server. Si introduce una clave privada no válida, se devuelve un error.
type	String	Especifica el tipo de certificado. El valor puede ser server o client. server indica certificados de servidor y client indica certificados de CA. El valor predeterminado es server.
created_at	String	Especifica la hora en que se creó el certificado.
updated_at	String	Especifica la hora a la que se actualizó el certificado.
expire_time	String	Especifica la hora a la que caduca el certificado.
project_id	String	Especifica el ID de proyecto del certificado.

Solicitudes de ejemplo

PUT https://{ELB_Endponit}/v3/99a3fff0d03c428eac3678da6a7d0f24/elb/certificates/233a325e5e3e4ce8beeb320aa714cc12

{
  "certificate" : {
    "name" : "My Certificate",
    "description" : "Update my Certificate."
  }
}

Ejemplo de respuestas

Código de estado: 200

Solicitud exitosa.

{
  "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"
}