Add OS Image
The Add OS Image operation adds an operating system image to the image repository that is associated with the specified subscription.
Request
The Add OS Image request may be specified as follows. Replace <subscription-id> with the subscription ID.
| Method | Request URI |
|---|---|
| POST | https://management.core.windows.net/<subscription-id>/services/images |
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 should be set to 2012-08-01 or higher. |
Request Body
The format of the request body is as follows:
<OSImage xmlns="https://schemas.microsoft.com/windowsazure" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<Label>image-label</Label>
<MediaLink>uri-of-vhd</MediaLink>
<Name>name-of-image</Name>
<OS>operating-system-type</OS>
<Eula>image-eula</Eula>
<Description>image-description</Description>
<ImageFamily>image-family</ImageFamily>
<PublishedDate>published-date</PublishedDate>
<ShowInGui>indicator-of-availability</ShowInGui>
<PrivacyUri>uri-of-privacy-policy</PrivacyUri>
<IconUri>uri-of-icon</IconUri>
<RecommendedVMSize>recommended-vm-size</RecommendedVMSize>
<SmallIconUri>uri-of-icon</SmallIconUri>
<Language>language-of-image</Language>
</OSImage>
The following table describes the elements of the request body.
| Element Name | Description |
|---|---|
| Label | Required. Specifies the friendly name of the image. |
| MediaLink | Required. Specifies the location of the vhd file for the image. The storage account where the vhd is located must be associated with the specified subscription. Example: http://example.blob.core.windows.net/disks/mydisk.vhd |
| Name | Required. Specifies a name that is used to identify the image when you create a Virtual Machine. |
| OS | Required. Specifies the operating system type of the OS image. Possible values are: - Linux- Windows |
| Eula | Optional. Specifies the End User License Agreement that is associated with the image. The value for this element is a string, but it is recommended that the value be a URL that points to a EULA. |
| Description | Optional. Specifies the description of the OS image. |
| ImageFamily | Optional. Specifies a value that can be used to group OS images. |
| PublishedDate | Optional. Specifies the date when the OS image was added to the image repository. |
| ShowInGui | Specifies whether the image should appear in the image gallery. |
| PrivacyUri | Optional. Specifies the URI that points to a document that contains the privacy policy related to the OS image. |
| IconUri | Optional. Specifies the Uri to the icon that is displayed for the image in the Management Portal. |
| RecommendedVMSize | Optional. Specifies the size to use for the virtual machine that is created from the OS image. |
| SmallIconUri | Specifies the URI to the small icon that is displayed when the image is presented in the portal. The SmallIconUri element is only available using version 2013-03-01 or higher. |
| Language | Specifies the language of the image. The Language element is only available using version 2013-03-01 or higher. |
Response
The response includes an HTTP status code and a set of response headers.
Status Code
A successful operation returns status code 201 (Created).
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.