Agregar certificado de servicio
Collapse the table of content
Expand the table of content
Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Agregar certificado de servicio

 

El Agregar certificado de servicio operación asincrónica, agrega un certificado a un servicio de nube.

El Agregar certificado de servicio solicitud se puede especificar como sigue. Reemplace <subscription-id> con el identificador de suscripción, y <service-name> con el DNS prefijar el nombre del servicio de nube.

(Método)

URI de solicitud

POST

https://management.core.windows.net/<subscription-id>/services/hostedservices/<service-name>/certificates

Debe asegurarse de que la solicitud que se realiza en el servicio de administración es segura. Para obtener más información, consulte autenticar solicitudes de administración de servicio.

La tabla siguiente describe los encabezados de solicitud.

Encabezado de solicitud

Descripción

Content-Type

Requerido. Establezca este encabezado en aplicación/xml.

x-ms-version

Requerido. Especifica la versión de la operación que se utilizará para esta solicitud. Este encabezado debe establecerse en 2009-10-01 o superior. Para obtener más información acerca de los encabezados de control de versiones, consulte versiones del servicio de administración de.

El formato del cuerpo de la solicitud es como sigue:


<?xml version="1.0" encoding="utf-8"?>
<CertificateFile xmlns=”http://schemas.microsoft.com/windowsazure”>
  <Data>base64-encoded-file</Data>
  <CertificateFormat>file-format</CertificateFormat>
  <Password>pfx-file-password</Password>
</CertificateFile>

La tabla siguiente describen los elementos del cuerpo de la solicitud.

Nombre del elemento

Descripción

Datos

Requerido. Especifica el formato codificado base 64 del archivo .pfx o .cer.

System_CAPS_noteNota

El certificado del servicio se agrega como archivo .cer o .pfx. Al recuperar el certificado del servicio utilizando el Enumerar certificados de servicio o Obtener certificado del servicio operación, se devuelve solo la parte pública del certificado como un archivo .cer.

CertificateFormat

Requerido. Especifica el formato del certificado del servicio.

Los valores posibles son:

  • PFX

  • CER

Contraseña

Especifica la contraseña de un certificado .pfx. Un certificado .cer no requiere una contraseña.

La respuesta incluye un código de estado HTTP y un conjunto de encabezados de respuesta.

Una operación correcta devuelve el código de estado 200 (OK). Para obtener información acerca de los códigos de estado, consulte estado de administración del servicio y los códigos de Error.

La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir otros encabezados HTTP estándar. Todos los encabezados estándar cumplen la especificación del protocolo HTTP/1.1.

Encabezado de respuesta

Descripción

x-ms-request-id

Un valor que identifica de forma única una solicitud realizada en el servicio de administración. Para una operación asincrónica, puede llamar a Obtener el estado de la operación con el valor del encabezado para determinar si la operación se completa, error o aún está en curso.

El método siguiente crea una solicitud para agregar un certificado de servicio, envía la solicitud al servicio y devuelve el identificador de solicitud.


public static string AddCertificate(string subscriptionId, string applicationName, X509Certificate2 managementCertificate, string pfxPath, string password)
{
    // Construct the request URI.    var req = (HttpWebRequest)WebRequest.Create(string.Format("https://management.core.windows.net/{0}/services/hostedservices/{1}/certificates", subscriptionId, applicationName));

    // Set the request method and the content type for the request.
    req.Method = "POST";
    req.ContentType = "application/xml";

    // Add the x-ms-version header.
    req.Headers.Add("x-ms-version", "2009-10-01");

    // Add the certificate.
    req.ClientCertificates.Add(managementCertificate);

    // Construct the request body.
    using (var writer = new StreamWriter(req.GetRequestStream()))
    {
        writer.Write(string.Format(@"<?xml version=""1.0"" encoding=""utf-8""?>
                                   <CertificateFilehttp://schemas.microsoft.com/windowsazure"">
                                   <Data>{0}</Data>
                                   <CertificateFormat>pfx</CertificateFormat>
                                   <Password>{1}</Password>
                                   </CertificateFile>", 
                                   Convert.ToBase64String(File.ReadAllBytes(pfxPath)), 
                                   password));
    }

    // Submit the request and return the request ID.
    return req.GetResponse().Headers["x-ms-request-id"];
}

Mostrar:
© 2016 Microsoft