URL Cheat Sheet para funções VM [SPFSDK][VMROLE]
Aplica-se a: Windows Azure Pack
A API de Gestão de Serviços é um serviço baseado em HTTP REST. Para utilizar as funcionalidades relacionadas com funções VM trabalha com uma estrutura de URL específica. Este tópico fornece um guia para todos os URLs que estão disponíveis ao trabalhar com funções VM. Descreve os tipos de objetos com que cada URL trabalha e, se houver, as ações disponíveis para esses objetos através do URL.
Importante
Sempre que utilizar um URL com os serviços de galeria e nuvem, deve anexar a cadeia de consultas api-version=2013-03 . A cadeia de consulta começa sempre com o personagem ? Por exemplo, para aceder ao serviço de cloud chamado TestService, utilizaria este URL: https:// server-name:server-port/subscription-id/CloudServices/TestService?api-version=2013-03.
Espaços reservados de URL comuns
Ao longo deste guia de programação serão utilizados URLs que necessitem de informações sobre a sua infraestrutura, tais como nomes de servidores ou nomes de objetos que tenham sido previamente criados. A lista que se segue descreve todos os espaços reservados utilizados.
Nome reservado |
Description |
|---|---|
server-name |
O nome do servidor do servidor API de Gestão de Serviços. |
servidor-porta |
A porta de autenticação do servidor API de Gestão de Serviços. |
id de subscrição |
O nome do serviço de nuvem que acolhe o papel de VM. |
nome cloudservice |
O nome do serviço de nuvem que acolhe o papel de VM. |
vmrole-nome |
O nome do papel VM. |
vm-id |
O identificador de uma máquina virtual. |
disco id |
O identificador de um disco rígido virtual. |
nic-id |
O identificador de um adaptador de rede virtual. |
Galeria
subscrição id/Galeria/GalleryItems
Operações HTTP suportadas: GET.Fornece acesso aos itens de galeria disponíveis para a subscrição especificada. Os artigos devolvidos não se limitam às funções de VM, mas são todos itens de galeria independentemente do tipo.
subscrição id/Gallery/GalleryItems (editor,nome,versão)
Operações HTTP suportadas: GET.Fornece acesso a um item de galeria específico disponível para a subscrição especificada.
subscrição id/Gallery/GalleryItems/$/MicrosoftCompute.VMRoleGalleryItem
Operações HTTP suportadas: GET.Fornece acesso aos itens de galeria de funções VM disponíveis para a subscrição especificada.
Por exemplo, utilizando este URL, consulte:
subscrição id/Gallery/GalleryItems/$/MicrosoftCompute.VMRoleGalleryItem (editor,nome,versão)
Operações HTTP suportadas: GET.Fornece acesso a um item específico de galeria de funções VM disponível para a subscrição especificada.
Por exemplo, utilizando este URL, consulte:
Serviços em nuvem
subscrição id/CloudServices
OPERAÇÕES HTTP suportadas: GET, POST.Fornece acesso aos serviços em nuvem que foram criados para a subscrição especificada. Um serviço de nuvem pode ser criado utilizando a operação POST.
Por exemplo, utilizando este URL, consulte:
subscrição-id/CloudServices/nome cloudservice
OPERAÇÕES HTTP suportadas: GET, PUT, PATCH, DELETE.Fornece acesso a um serviço de nuvem específico criado pela subscrição especificada. O serviço de nuvem identificado pelo URL pode ser atualizado e eliminado.
subscrição-id/CloudServices/cloudservice-name/Resources
Operações HTTP suportadas: GET.Fornece acesso aos fornecedores de recursos disponíveis para o serviço de nuvem especificado.
subscrição-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute
Operações HTTP suportadas: GET.Fornece acesso ao fornecedor de recursos MicrosoftCompute que acolhe funções VM.
Funções VM
subscrição-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles
OPERAÇÕES HTTP suportadas: GET, POST.Proporciona acesso às instâncias de função VM que foram criadas. Este URL também é usado para submeter uma nova instância de função VM para o servidor.
Por exemplo, utilizando este URL, consulte:
subscrição-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name
OPERAÇÕES HTTP suportadas: GET, PUT, PATCH, DELETE.Proporciona acesso a uma função VM específica pelo nome. Este URL é utilizado para eliminar e atualizar uma função VM.
Por exemplo, utilizando este URL, consulte:
subscrição-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/Scale
Operações HTTP suportadas: POST.Inicia a ação escala na função VM especificada.
Por exemplo, utilizando este URL, consulte:
subscrição-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/Repair
Operações HTTP suportadas: POST.Inicia a ação de reparação na função VM especificada.
Por exemplo, utilizando este URL, consulte:
Máquinas virtuais
subscrição-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs
Operações HTTP suportadas: GET.Fornece acesso às máquinas virtuais hospedadas numa função VM específica.
Por exemplo, utilizando este URL, consulte:
subscrição-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id
Operações HTTP suportadas: GET, DELETE.Fornece acesso à máquina virtual por identificador que é hospedado numa função VM específica. Este URL pode ser usado para eliminar uma máquina virtual específica de uma função VM.
Por exemplo, utilizando este URL, consulte:
subscrição-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Stop
Operações HTTP suportadas: POST.Para a máquina virtual identificada.
subscrição-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Start
Operações HTTP suportadas: POST.Inicia a máquina virtual identificada.
subscrição-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Restart
Operações HTTP suportadas: POST.Reinicia a máquina virtual identificada.
subscrição-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Shutdown
Operações HTTP suportadas: POST.Desliga a máquina virtual identificada.
Discos virtuais e adaptadores de rede virtuais
subscrição-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Disks
OPERAÇÕES HTTP suportadas: GET, POST.Fornece acesso aos discos virtuais da máquina virtual identificada. Este URL também pode ser usado para anexar um disco virtual à máquina virtual utilizando a operação POST.
subscrição-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Disks/disk-id
OPERAÇÕES HTTP suportadas: GET, PUT, PATCH, DELETE.Fornece acesso aos discos virtuais especificados.
subscrição-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Nics
Operações HTTP suportadas: GET.Fornece acesso aos adaptadores de rede virtuais da máquina virtual identificada.
subscrição-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Nics/nic-id
Operações HTTP suportadas: GET.Fornece acesso ao adaptador de rede virtual especificado.