URL-fuskblad för VM-roller [SPFSDK][VMROLE]

 

Gäller för: Windows Azure Pack

Service Management-API:et är en HTTP REST-baserad tjänst. Om du vill använda funktionerna som är relaterade till VM-roller arbetar du med en specifik URL-struktur. Det här avsnittet innehåller en guide till alla URL:er som är tillgängliga när du arbetar med VM-roller. Den beskriver de typer av objekt som varje URL fungerar med, och i förekommande fall de åtgärder som är tillgängliga för dessa objekt via URL:en.

Viktigt

När du använder en URL med galleriet och molntjänsterna måste du lägga till frågesträngen api-version=2013-03 . Frågesträngen börjar alltid med tecknet ? efter URL:en. Om du till exempel vill få åtkomst till molntjänsten TestService använder du den här URL:en: https:// server-name:server-port/subscription-id/CloudServices/TestService?api-version=2013-03.

Vanliga URL-platshållare

I den här programmeringsguiden används URL:er som behöver information om infrastrukturen, till exempel servernamn eller namn på objekt som har skapats tidigare. I följande lista beskrivs alla platshållare som används.

Platshållarnamn	Beskrivning
server-name	Servernamnet för Service Management API-servern.
serverport	Autentiseringsporten för Service Management API-servern.
prenumerations-ID	Namnet på molntjänsten som är värd för vm-rollen.
cloudservice-name	Namnet på molntjänsten som är värd för vm-rollen.
vmrole-name	Namnet på den virtuella datorrollen.
vm-id	Identifieraren för en virtuell dator.
disk-ID	Identifieraren för en virtuell hårddisk.
nic-id	Identifieraren för ett virtuellt nätverkskort.

Galleri

• subscription-id/Gallery/GalleryItems
  HTTP-åtgärder som stöds: GET.

  Ger åtkomst till de galleriobjekt som är tillgängliga för den angivna prenumerationen. Objekten som returneras är inte begränsade till VM-roller, utan alla galleriobjekt oavsett typ.

• subscription-id/Gallery/GalleryItems(publisher,name,version)
  HTTP-åtgärder som stöds: GET.

  Ger åtkomst till ett specifikt galleriobjekt som är tillgängligt för den angivna prenumerationen.

• subscription-id/Gallery/GalleryItems/$/MicrosoftCompute.VMRoleGalleryItem
  HTTP-åtgärder som stöds: GET.

  Ger åtkomst till de vm-rollgalleriobjekt som är tillgängliga för den angivna prenumerationen.

  Exempel som använder den här URL:en finns i:

  • Hämta referens till ett vm-rollgalleriobjekt

  • Hämta resursdefinitionen från vm-rollgalleriobjektet

• subscription-id/Gallery/GalleryItems/$/MicrosoftCompute.VMRoleGalleryItem(publisher,name,version)
  HTTP-åtgärder som stöds: GET.

  Ger åtkomst till ett specifikt vm-rollgalleriobjekt som är tillgängligt för den angivna prenumerationen.

  Exempel som använder den här URL:en finns i:

  • Hämta resursdefinitionen från vm-rollgalleriobjektet

Molntjänster

• subscription-id/CloudServices
  HTTP-åtgärder som stöds: GET, POST.

  Ger åtkomst till de molntjänster som har skapats för den angivna prenumerationen. En molntjänst kan skapas med hjälp av POST-åtgärden.

  Exempel som använder den här URL:en finns i:

  • Skapa en molntjänst som ska vara värd för VM-roller [SPFSDK][VMROLE]

• subscription-id/CloudServices/cloudservice-name
  HTTP-åtgärder som stöds: GET, PUT, PATCH, DELETE.

  Ger åtkomst till en specifik molntjänst som skapats av den angivna prenumerationen. Molntjänsten som identifieras av URL:en kan uppdateras och tas bort.

• subscription-id/CloudServices/cloudservice-name/Resources
  HTTP-åtgärder som stöds: GET.

  Ger åtkomst till resursprovidrar som är tillgängliga för den angivna molntjänsten.

• subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute
  HTTP-åtgärder som stöds: GET.

  Ger åtkomst till resursprovidern MicrosoftCompute som är värd för VM-roller.

VM-roller

• subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles
  HTTP-åtgärder som stöds: GET, POST.

  Ger åtkomst till de VM-rollinstanser som har skapats. Den här URL:en används också för att skicka en ny vm-rollinstans till servern.

  Exempel som använder den här URL:en finns i:

  • Skapa och skicka ett JSON-objekt för vm-rollinstans

  • Granska en VM-roll för etableringsfel [SPFSDK][VMROLE]

• subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name
  HTTP-åtgärder som stöds: GET, PUT, PATCH, DELETE.

  Ger åtkomst till en specifik VM-roll efter namn. Den här URL:en används för att ta bort och uppdatera en VM-roll.

  Exempel som använder den här URL:en finns i:

  • Hämta en VM-rollinstans [SPFSDK][VMROLE]

• subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/Scale
  HTTP-åtgärder som stöds: POST.

  Initierar åtgärden Skala på den angivna VM-rollen.

  Exempel som använder den här URL:en finns i:

  • Skala en VM-roll [SPFSDK][VMROLE]

• subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/Repair
  HTTP-åtgärder som stöds: POST.

  Initierar reparationsåtgärden för den angivna VM-rollen.

  Exempel som använder den här URL:en finns i:

  • Reparera en VM-roll [SPFSDK][VMROLE]

Virtuella datorer

• subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs
  HTTP-åtgärder som stöds: GET.

  Ger åtkomst till de virtuella datorer som finns i en specifik VM-roll.

  Exempel som använder den här URL:en finns i:

  • Hämta alla Virtual Machines [SPFSDK][VMROLE]

• subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id
  HTTP-åtgärder som stöds: GET, DELETE.

  Ger åtkomst till den virtuella datorn efter identifierare som finns i en specifik VM-roll. Den här URL:en kan användas för att ta bort en specifik virtuell dator från en VM-roll.

  Exempel som använder den här URL:en finns i:

  • Hämta en enskild virtuell dator [SPFSDK][VMROLE]

• subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Stop
  HTTP-åtgärder som stöds: POST.

  Stoppar den identifierade virtuella datorn.

• subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Start
  HTTP-åtgärder som stöds: POST.

  Startar den identifierade virtuella datorn.

• subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Restart
  HTTP-åtgärder som stöds: POST.

  Startar om den identifierade virtuella datorn.

• subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Shutdown
  HTTP-åtgärder som stöds: POST.

  Stänger av den identifierade virtuella datorn.

Virtuella diskar och virtuella nätverkskort

• subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Disks
  HTTP-åtgärder som stöds: GET, POST.

  Ger åtkomst till de virtuella diskarna för den identifierade virtuella datorn. Den här URL:en kan också användas för att ansluta en virtuell disk till den virtuella datorn med hjälp av POST-åtgärden.

• subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Disks/disk-id
  HTTP-åtgärder som stöds: GET, PUT, PATCH, DELETE.

  Ger åtkomst till de angivna virtuella diskarna.

• subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Nics
  HTTP-åtgärder som stöds: GET.

  Ger åtkomst till de virtuella nätverkskorten för den identifierade virtuella datorn.

• subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Nics/nic-id
  HTTP-åtgärder som stöds: GET.

  Ger åtkomst till det angivna virtuella nätverkskortet.