Add Management Certificate

 

The Add Management Certificate operation adds a management certificate to the specified subscription.

Request

The Add Management Certificate request may be constructed as follows. Replace <subscription-id> with the name of the subscription ID.

Method

Request URI

POST

https://management.core.windows.net/<subscription-id>/certificates

URI Parameters

None.

Request Headers

The following table describes the request headers.

Request Header

Description

x-ms-version

Required. Specifies the version of the operation to use for this request. This header must be set to 2012-03-01 or higher.

Request Body

The format of the request body is as follows:

< SubscriptionCertificate xmlns=”https://schemas.microsoft.com/windowsazure”>
   <SubscriptionCertificatePublicKey>base64-public-key</SubscriptionCertificatePublicKey>
   <SubscriptionCertificateThumbprint>certificate-thumbprint</SubscriptionCertificateThumbprint>
   <SubscriptionCertificateData>base64-certificate-raw-data</SubscriptionCertificateData>
</SubscriptionCertificate>

The following table describes the elements in the request body.

Request Element

Description

SubscriptionCertificatePublicKey

Specifies a base-64 encoded public key for the management certificate.

SubscriptionCertificateThumbprint

Specifies the thumbprint for the management certificate.

SubscriptionCertificateData

Specifies the base-64 encoded certificate data in .cer format.

Response

The response includes an HTTP status code, a response body, and a set of response headers.

Status Code

A successful operation returns status code 200 (OK).

Response Headers

The response for this operation includes the following headers. The response may also include additional standard HTTP headers.

Response Header

Description

x-ms-request-id

A value that uniquely identifies a request made against the management service.

Response Body

None.

Remarks

Each subscription can store a maximum of 25 management certificates. Attempting to add a 26th certificate to a subscription will result in an error, and return status code 400 (BadRequest).