Folha de referência de URL para funções de VM [SPFSDK][VMROLE]

Artigo
08/24/2015

Aplica-se a: Windows Azure Pack

A API de Gerenciamento de Serviços é um serviço baseado em HTTP REST. Para usar os recursos relacionados a funções de VM, você trabalha com uma estrutura de URL específica. Este tópico fornece um guia para todas as URLs disponíveis ao trabalhar com funções de VM. Ele descreve os tipos de objetos com os quais cada URL funciona e, se houver, as ações disponíveis para esses objetos por meio da URL.

Importante

Sempre que você usar uma URL com a galeria e os serviços de nuvem, deverá acrescentar a cadeia de caracteres de consulta api-version=2013-03 . A cadeia de caracteres de consulta sempre começa com o caractere ? após a URL. Por exemplo, para acessar o serviço de nuvem chamado TestService, você usaria esta URL: https:// server-name:server-port/subscription-id/CloudServices/TestService?api-version=2013-03.

Espaços reservados de URL comuns

Ao longo desta programação, serão usadas URLs que precisam de informações sobre sua infraestrutura, como nomes de servidor ou nomes de objetos que foram criados anteriormente. A lista a seguir descreve todos os espaços reservados usados.

Nome do espaço reservado	Descrição
server-name	O nome do servidor da API de Gerenciamento de Serviços.
server-port	A porta de autenticação do servidor de API de Gerenciamento de Serviços.
id da assinatura	O nome do serviço de nuvem que hospeda a função de VM.
cloudservice-name	O nome do serviço de nuvem que hospeda a função de VM.
vmrole-name	O nome da função de VM.
vm-id	O identificador de uma máquina virtual.
disk-id	O identificador de um disco rígido virtual.
nic-id	O identificador de um adaptador de rede virtual.

Galeria

subscription-id/Gallery/GalleryItems
Operações HTTP com suporte: GET.

Fornece acesso aos itens da galeria disponíveis para a assinatura especificada. Os itens retornados não se limitam a funções de VM, mas são todos itens da galeria, independentemente do tipo.
subscription-id/Gallery/GalleryItems(publisher, name,version)
Operações HTTP com suporte: GET.

Fornece acesso a um item específico da galeria disponível para a assinatura especificada.
subscription-id/Gallery/GalleryItems/$/MicrosoftCompute.VMRoleGalleryItem
Operações HTTP com suporte: GET.

Fornece acesso aos itens da galeria de funções de VM disponíveis para a assinatura especificada.

Para obter exemplos usando essa URL, consulte:
- Obter referência a um item da galeria de funções de VM
- Obter a definição de recurso do item da galeria de funções da VM
subscription-id/Gallery/GalleryItems/$/MicrosoftCompute.VMRoleGalleryItem(publisher, name,version)
Operações HTTP com suporte: GET.

Fornece acesso a um item específico da galeria de funções de VM disponível para a assinatura especificada.

Para obter exemplos usando essa URL, consulte:
- Obter a definição de recurso do item da galeria de funções da VM

Serviços de Nuvem

subscription-id/CloudServices
Operações HTTP com suporte: GET, POST.

Fornece acesso aos serviços de nuvem que foram criados para a assinatura especificada. Um serviço de nuvem pode ser criado usando a operação POST.

Para obter exemplos usando essa URL, consulte:
- Criar um serviço de nuvem para hospedar funções de VM [SPFSDK][VMROLE]
subscription-id/CloudServices/cloudservice-name
Operações HTTP com suporte: GET, PUT, PATCH, DELETE.

Fornece acesso a um serviço de nuvem específico criado pela assinatura especificada. O serviço de nuvem identificado pela URL pode ser atualizado e excluído.
subscription-id/CloudServices/cloudservice-name/Resources
Operações HTTP com suporte: GET.

Fornece acesso aos provedores de recursos disponíveis para o serviço de nuvem especificado.
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute
Operações HTTP com suporte: GET.

Fornece acesso ao provedor de recursos MicrosoftCompute que hospeda funções de VM.

Funções de VM

subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles
Operações HTTP com suporte: GET, POST.

Fornece acesso às instâncias de função da VM que foram criadas. Essa URL também é usada para enviar uma nova instância de função de VM para o servidor.

Para obter exemplos usando essa URL, consulte:
- Compilar e enviar um objeto JSON da instância de função de VM
- Inspecionar uma função de VM para erros de provisionamento [SPFSDK][VMROLE]
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name
Operações HTTP com suporte: GET, PUT, PATCH, DELETE.

Fornece acesso a uma função de VM específica por nome. Essa URL é usada para excluir e atualizar uma função de VM.

Para obter exemplos usando essa URL, consulte:
- Obter uma instância de função de VM [SPFSDK][VMROLE]
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/Scale
Operações HTTP com suporte: POST.

Inicia a ação Dimensionar na função de VM especificada.

Para obter exemplos usando essa URL, consulte:
- Dimensionar uma função de VM [SPFSDK][VMROLE]
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/Repair
Operações HTTP com suporte: POST.

Inicia a ação Reparar na função de VM especificada.

Para obter exemplos usando essa URL, consulte:
- Reparar uma função de VM [SPFSDK][VMROLE]

Máquinas virtuais

subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs
Operações HTTP com suporte: GET.

Fornece acesso às máquinas virtuais hospedadas em uma função de VM específica.

Para obter exemplos usando essa URL, consulte:
- Obter todos os Máquinas Virtuais [SPFSDK][VMROLE]
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id
Operações HTTP com suporte: GET, DELETE.

Fornece acesso à máquina virtual por identificador hospedado em uma função de VM específica. Essa URL pode ser usada para excluir uma máquina virtual específica de uma função de VM.

Para obter exemplos usando essa URL, consulte:
- Obter uma única máquina virtual [SPFSDK][VMROLE]
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Stop
Operações HTTP com suporte: POST.

Interrompe a máquina virtual identificada.
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Start
Operações HTTP com suporte: POST.

Inicia a máquina virtual identificada.
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Restart
Operações HTTP com suporte: POST.

Reinicia a máquina virtual identificada.
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Shutdown
Operações HTTP com suporte: POST.

Desliga a máquina virtual identificada.

Discos virtuais e adaptadores de rede virtual

subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Disks
Operações HTTP com suporte: GET, POST.

Fornece acesso aos discos virtuais da máquina virtual identificada. Essa URL também pode ser usada para anexar um disco virtual à máquina virtual usando a operação POST.
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Disks/disk-id
Operações HTTP com suporte: GET, PUT, PATCH, DELETE.

Fornece acesso aos discos virtuais especificados.
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Nics
Operações HTTP com suporte: GET.

Fornece acesso aos adaptadores de rede virtual da máquina virtual identificada.
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Nics/nic-id
Operações HTTP com suporte: GET.

Fornece acesso ao adaptador de rede virtual especificado.

Compartilhar via