Hoja de referencia rápida de direcciones URL para roles de máquina virtual [SPFSDK][VMROLE]
Se aplica a: Windows Azure Pack
Service Management API es un servicio basado en REST HTTP. Para usar las características relacionadas con los roles de máquina virtual, trabaje con una estructura de dirección URL específica. En este tema se proporciona una guía para todas las direcciones URL que están disponibles al trabajar con roles de máquina virtual. Describe los tipos de objetos con los que funciona cada dirección URL y, si existe, las acciones disponibles para esos objetos a través de la dirección URL.
Importante
Cada vez que use una dirección URL con la galería y los servicios en la nube, debe anexar la cadena de consulta api-version=2013-03 . La cadena de consulta siempre comienza con el carácter ? después de la dirección URL. Por ejemplo, para acceder al servicio en la nube denominado TestService, usaría esta dirección URL: https:// server-name:server-port/subscription-id/CloudServices/TestService?api-version=2013-03.
Marcadores de posición de dirección URL comunes
A lo largo de esta guía de programación, se usarán direcciones URL que necesitan información sobre la infraestructura, como nombres de servidor o nombres de objetos creados anteriormente. En la lista siguiente se describen todos los marcadores de posición usados.
Nombre del marcador de posición |
Descripción |
|---|---|
server-name |
Nombre del servidor del servidor de Service Management API. |
server-port |
Puerto de autenticación del servidor de SERVICE Management API. |
subscription-id |
Nombre del servicio en la nube que hospeda el rol de máquina virtual. |
cloudservice-name |
Nombre del servicio en la nube que hospeda el rol de máquina virtual. |
vmrole-name |
Nombre del rol de máquina virtual. |
vm-id |
Identificador de una máquina virtual. |
disk-id |
Identificador de un disco duro virtual. |
nic-id |
Identificador de un adaptador de red virtual. |
Galería
subscription-id/Gallery/GalleryItems
Operaciones HTTP admitidas: GET.Proporciona acceso a los elementos de la galería disponibles para la suscripción especificada. Los elementos devueltos no se limitan a los roles de máquina virtual, pero son todos los elementos de la galería independientemente del tipo.
subscription-id/Gallery/GalleryItems(publisher,name,version)
Operaciones HTTP admitidas: GET.Proporciona acceso a un elemento de galería específico disponible para la suscripción especificada.
subscription-id/Gallery/GalleryItems/$/MicrosoftCompute.VMRoleGalleryItem
Operaciones HTTP admitidas: GET.Proporciona acceso a los elementos de la galería de roles de máquina virtual disponibles para la suscripción especificada.
Para obtener ejemplos de uso de esta dirección URL, consulte:
subscription-id/Gallery/GalleryItems/$/MicrosoftCompute.VMRoleGalleryItem(publisher,name,version)
Operaciones HTTP admitidas: GET.Proporciona acceso a un elemento específico de la galería de roles de máquina virtual disponible para la suscripción especificada.
Para obtener ejemplos de uso de esta dirección URL, consulte:
Servicios en la nube
subscription-id/CloudServices
Operaciones HTTP admitidas: GET, POST.Proporciona acceso a los servicios en la nube que se han creado para la suscripción especificada. Se puede crear un servicio en la nube mediante la operación POST.
Para obtener ejemplos de uso de esta dirección URL, consulte:
subscription-id/CloudServices/cloudservice-name
Operaciones HTTP admitidas: GET, PUT, PATCH, DELETE.Proporciona acceso a un servicio en la nube específico creado por la suscripción especificada. El servicio en la nube identificado por la dirección URL se puede actualizar y eliminar.
subscription-id/CloudServices/cloudservice-name/Resources
Operaciones HTTP admitidas: GET.Proporciona acceso a los proveedores de recursos disponibles para el servicio en la nube especificado.
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute
Operaciones HTTP admitidas: GET.Proporciona acceso al proveedor de recursos MicrosoftCompute que hospeda roles de máquina virtual.
Roles de máquina virtual
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles
Operaciones HTTP admitidas: GET, POST.Proporciona acceso a las instancias de rol de máquina virtual que se han creado. Esta dirección URL también se usa para enviar una nueva instancia de rol de máquina virtual al servidor.
Para obtener ejemplos de uso de esta dirección URL, consulte:
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name
Operaciones HTTP admitidas: GET, PUT, PATCH, DELETE.Proporciona acceso a un rol de máquina virtual específico por nombre. Esta dirección URL se usa para eliminar y actualizar un rol de máquina virtual.
Para obtener ejemplos de uso de esta dirección URL, consulte:
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/Scale
Operaciones HTTP admitidas: POST.Inicia la acción Escalar en el rol de máquina virtual especificado.
Para obtener ejemplos de uso de esta dirección URL, consulte:
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/Repair
Operaciones HTTP admitidas: POST.Inicia la acción Reparar en el rol de máquina virtual especificado.
Para obtener ejemplos de uso de esta dirección URL, consulte:
Máquinas virtuales
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs
Operaciones HTTP admitidas: GET.Proporciona acceso a las máquinas virtuales hospedadas en un rol de máquina virtual específico.
Para obtener ejemplos de uso de esta dirección URL, consulte:
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id
Operaciones HTTP admitidas: GET, DELETE.Proporciona acceso a la máquina virtual por identificador hospedado en un rol de máquina virtual específico. Esta dirección URL se puede usar para eliminar una máquina virtual específica de un rol de máquina virtual.
Para obtener ejemplos de uso de esta dirección URL, consulte:
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Stop
Operaciones HTTP admitidas: POST.Detiene la máquina virtual identificada.
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Start
Operaciones HTTP admitidas: POST.Inicia la máquina virtual identificada.
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Restart
Operaciones HTTP admitidas: POST.Reinicia la máquina virtual identificada.
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Shutdown
Operaciones HTTP admitidas: POST.Apaga la máquina virtual identificada.
Discos virtuales y adaptadores de red virtual
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Disks
Operaciones HTTP admitidas: GET, POST.Proporciona acceso a los discos virtuales de la máquina virtual identificada. Esta dirección URL también se puede usar para conectar un disco virtual a la máquina virtual mediante la operación POST.
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Disks/disk-id
Operaciones HTTP admitidas: GET, PUT, PATCH, DELETE.Proporciona acceso a los discos virtuales especificados.
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Nics
Operaciones HTTP admitidas: GET.Proporciona acceso a los adaptadores de red virtual de la máquina virtual identificada.
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Nics/nic-id
Operaciones HTTP admitidas: GET.Proporciona acceso al adaptador de red virtual especificado.