Exportar (0) Imprimir
Expandir Tudo

Adicionar a imagem do sistema operacional

Atualizado: abril de 2014

A operação Add OS Image adiciona uma imagem do sistema operacional que está armazenada em uma conta de armazenamento e está disponível no repositório da imagem.

A solicitação Add OS Image é especificada como a seguir. Substitua <subscription-id> por sua ID da assinatura.

 

Método URI de solicitação Versão HTTP

POST

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

HTTP/1.1

A tabela a seguir descreve os cabeçalhos de solicitação obrigatórios e opcionais.

 

Cabeçalho de solicitação Descrição

x-ms-version

Obrigatório. Especifica a versão da operação a ser usada para esta solicitação. Atualmente, esse cabeçalho deve ser definido como 2012-08-01.

Formato do corpo da solicitação:

    
<OSImage xmlns="http://schemas.microsoft.com/windowsazure" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
   <Label>image-label</Label>
   <MediaLink>uri-of-the-containing-blob</MediaLink>
   <Name>image-name</Name>
   <OS>Linux|Windows</OS>
   <Eula>image-eula</Eula>
   <Description>image-description</Description>
   <ImageFamily>image-family</ImageFamily>
   <PublishedDate>published-date</PublishedDate>
   <IsPremium>true/false</IsPremium>
   <ShowInGui>true/false</ShowInGui>
   <PrivacyUri>http://www.example.com/privacypolicy.html</PrivacyUri>
   <IconUri>http://www.example.com/favicon.png</IconUri>
   <RecommendedVMSize>Small/Large/Medium/ExtraLarge</RecommendedVMSize>
   <SmallIconUri>http://www.example.com/smallfavicon.png</SmallIconUri>
   <Language>language-of-image</Language>
</OSImage>

A tabela a seguir descreve os principais elementos do corpo da solicitação:

 

Nome de elemento Descrição

Rótulo

Obrigatório. Especifica o nome amigável da imagem.

MediaLink

Obrigatório. Especifica a localização do blob no armazenamento do Windows Azure. O local de blob deve pertencer a uma conta de armazenamento da assinatura especificada pelo valor <subscription-id> na chamada da operação.

Exemplo:

http://example.blob.core.windows.net/disks/mydisk.vhd

Nome

Obrigatório. Especifica um nome que o Windows Azure usa para identificar a imagem ao criar uma ou mais máquinas virtuais.

SO

Obrigatório. O tipo do sistema operacional da imagem do sistema operacional.

Os possíveis valores são:

  • Linux

  • Windows

Eula

Opcional. Especifica o contrato de licença de usuário final que está associado à imagem. O valor para esse elemento é uma cadeia de caracteres, mas é recomendado que o valor seja uma URL que aponta para um EULA.

Descrição

Opcional. Especifica a descrição da imagem do sistema operacional.

ImageFamily

Opcional. Especifica um valor que pode ser usado para agrupar imagens do sistema operacional.

PublishedDate

Opcional. Especifica a data em que a imagem do sistema operacional foi adicionada ao repositório de imagem.

IsPremium

Indica se a imagem contém software ou serviços associados que incorrerão em encargos acima do preço principal para a máquina virtual.

ShowInGui

Especifica se a imagem deve aparecer na galeria de imagem.

PrivacyUri

Opcional. Especifica o URI que aponta para um documento que contém a política de privacidade relacionada à imagem do sistema operacional.

IconUri

Opcional. Especifica o URI para o ícone que é exibido para a imagem no Portal de Gerenciamento.

RecommendedVMSize

Opcional. Especifica o tamanho a ser usado para a máquina virtual que é criada a partir da imagem do sistema operacional.

SmallIconUri

Especifica o URI para o ícone pequeno que é exibido quando a imagem é apresentada no Portal de Gerenciamento do Windows Azure.

O elemento SmallIconUri só estará disponível com a versão 2013-03-01 ou superior.

Linguagem

Especifica a linguagem da imagem.

O elemento Language só estará disponível com a versão 2013-03-01 ou superior.

A resposta inclui um código de status HTTP e um conjunto de cabeçalhos de resposta.

Uma operação bem-sucedida retorna o código de status 201 (Criado).

Para obter informações sobre códigos de status, consulte Status de Gerenciamento de Serviço e códigos de erro.

A resposta para esta operação inclui os cabeçalhos a seguir. A resposta também pode incluir cabeçalhos padrão HTTP adicionais. Todos os cabeçalhos padrão obedecem à especificação de protocolo HTTP/1.1.

 

Cabeçalho de resposta Descrição

x-ms-request-id

Um valor que identifica exclusivamente uma solicitação feita no serviço de Gerenciamento. Para uma operação assíncrona, você pode obter o status da operação com o valor do cabeçalho para determinar se a operação foi concluída, se falhou ou se ainda está em andamento. Consulte Controlando solicitações assíncronas de gerenciamento de serviço para obter mais informações.

Somente o proprietário da conta pode chamar essa operação.

Mostrar:
© 2014 Microsoft