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).