URL-cheatsheet voor VM-rollen [SPFSDK][VMROLE]

 

Van toepassing op: Windows Azure Pack

De Service Management-API is een OP HTTP REST gebaseerde service. Als u de functies met betrekking tot VM-rollen wilt gebruiken, werkt u met een specifieke URL-structuur. Dit onderwerp bevat een handleiding voor alle URL's die beschikbaar zijn bij het werken met VM-rollen. Hierin worden de typen objecten beschreven waarmee elke URL werkt en, indien aanwezig, de acties die beschikbaar zijn voor deze objecten via de URL.

Belangrijk

Wanneer u een URL met de galerie en cloudservices gebruikt, moet u de querytekenreeks api-version=2013-03 toevoegen. De querytekenreeks begint altijd met het teken ? na de URL. Als u bijvoorbeeld toegang wilt krijgen tot de cloudservice met de naam TestService, gebruikt u deze URL: https:// server-name:server-port/subscription-id/CloudServices/TestService?api-version=2013-03.

Algemene tijdelijke aanduidingen voor URL's

In deze programmeergids-URL's worden URL's gebruikt die informatie nodig hebben over uw infrastructuur, zoals servernamen of namen van objecten die eerder zijn gemaakt. In de volgende lijst worden alle gebruikte tijdelijke aanduidingen beschreven.

Naam van tijdelijke aanduiding	Description
servernaam	De servernaam van de Service Management API-server.
serverpoort	De verificatiepoort van de Service Management API-server.
subscription-id	De naam van de cloudservice die als host fungeert voor de VM-rol.
cloudservicenaam	De naam van de cloudservice die als host fungeert voor de VM-rol.
vmrole-name	De naam van de VM-rol.
vm-id	De id van een virtuele machine.
schijf-id	De id van een virtuele harde schijf.
nic-id	De id van een virtuele netwerkadapter.

Galerie

• subscription-id/Gallery/GalleryItems
  ONDERSTEUNDE HTTP-bewerkingen: GET.

  Biedt toegang tot de galerie-items die beschikbaar zijn voor het opgegeven abonnement. De geretourneerde items zijn niet beperkt tot VM-rollen, maar zijn alle galerie-items, ongeacht het type.

• subscription-id/Gallery/GalleryItems(publisher,name,version)
  ONDERSTEUNDE HTTP-bewerkingen: GET.

  Biedt toegang tot een specifiek galerie-item dat beschikbaar is voor het opgegeven abonnement.

• subscription-id/Gallery/GalleryItems/$/MicrosoftCompute.VMRoleGalleryItem
  ONDERSTEUNDE HTTP-bewerkingen: GET.

  Biedt toegang tot de items in de galerie met VM-rollen die beschikbaar zijn voor het opgegeven abonnement.

  Zie voor voorbeelden van het gebruik van deze URL:

  • Verwijzing ophalen naar een item in de galerie met VM-rollen

  • De resourcedefinitie ophalen uit het galerie-item met VM-rollen

• subscription-id/Gallery/GalleryItems/$/MicrosoftCompute.VMRoleGalleryItem(publisher,name,version)
  ONDERSTEUNDE HTTP-bewerkingen: GET.

  Biedt toegang tot een specifiek item in de galerie met VM-rollen dat beschikbaar is voor het opgegeven abonnement.

  Zie voor voorbeelden van het gebruik van deze URL:

  • De resourcedefinitie ophalen uit het galerie-item met VM-rollen

Cloud services

• subscription-id/CloudServices
  ONDERSTEUNDE HTTP-bewerkingen: GET, POST.

  Biedt toegang tot de cloudservices die zijn gemaakt voor het opgegeven abonnement. Een cloudservice kan worden gemaakt met behulp van de POST-bewerking.

  Zie voor voorbeelden van het gebruik van deze URL:

  • Een cloudservice maken voor het hosten van VM-rollen [SPFSDK][VMROLE]

• subscription-id/CloudServices/cloudservice-name
  ONDERSTEUNDE HTTP-bewerkingen: GET, PUT, PATCH, DELETE.

  Biedt toegang tot een specifieke cloudservice die is gemaakt door het opgegeven abonnement. De cloudservice die door de URL wordt geïdentificeerd, kan worden bijgewerkt en verwijderd.

• subscription-id/CloudServices/cloudservice-name/Resources
  ONDERSTEUNDE HTTP-bewerkingen: GET.

  Biedt toegang tot de resourceproviders die beschikbaar zijn voor de opgegeven cloudservice.

• subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute
  ONDERSTEUNDE HTTP-bewerkingen: GET.

  Biedt toegang tot de MicrosoftCompute-resourceprovider die als host fungeert voor VM-rollen.

VM-rollen

• subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles
  ONDERSTEUNDE HTTP-bewerkingen: GET, POST.

  Biedt toegang tot de VM-rolinstanties die zijn gemaakt. Deze URL wordt ook gebruikt om een nieuw exemplaar van de VM-functie naar de server te verzenden.

  Zie voor voorbeelden van het gebruik van deze URL:

  • Een JSON-object voor een VM-rolinstantie bouwen en verzenden

  • Een VM-rol controleren op inrichtingsfouten [SPFSDK][VMROLE]

• subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name
  ONDERSTEUNDE HTTP-bewerkingen: GET, PUT, PATCH, DELETE.

  Biedt toegang tot een specifieke VM-rol op naam. Deze URL wordt gebruikt om een VM-rol te verwijderen en bij te werken.

  Zie voor voorbeelden van het gebruik van deze URL:

  • Een EXEMPLAAR van een VM-rol ophalen [SPFSDK][VMROLE]

• subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/Scale
  ONDERSTEUNDE HTTP-bewerkingen: POST.

  Hiermee start u de actie Schaal op de opgegeven VM-rol.

  Zie voor voorbeelden van het gebruik van deze URL:

  • Een VM-rol schalen [SPFSDK][VMROLE]

• subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/Repair
  ONDERSTEUNDE HTTP-bewerkingen: POST.

  Start de herstelactie voor de opgegeven VM-rol.

  Zie voor voorbeelden van het gebruik van deze URL:

  • Een VM-rol herstellen [SPFSDK][VMROLE]

Virtuele machines

• subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMMs
  ONDERSTEUNDE HTTP-bewerkingen: GET.

  Biedt toegang tot de virtuele machines die worden gehost in een specifieke VM-rol.

  Zie voor voorbeelden van het gebruik van deze URL:

  • Haal alle Virtual Machines [SPFSDK][VMROLE]

• subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id
  ONDERSTEUNDE HTTP-bewerkingen: GET, DELETE.

  Biedt toegang tot de virtuele machine op id die wordt gehost in een specifieke VM-rol. Deze URL kan worden gebruikt om een specifieke virtuele machine te verwijderen uit een VM-rol.

  Zie voor voorbeelden van het gebruik van deze URL:

  • Eén virtuele machine ophalen [SPFSDK][VMROLE]

• subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Stop
  ONDERSTEUNDE HTTP-bewerkingen: POST.

  Hiermee stopt u de geïdentificeerde virtuele machine.

• subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMMs/vm-id/Startmenu
  ONDERSTEUNDE HTTP-bewerkingen: POST.

  Hiermee start u de geïdentificeerde virtuele machine.

• subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Restart
  ONDERSTEUNDE HTTP-bewerkingen: POST.

  Start de geïdentificeerde virtuele machine opnieuw.

• subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMMs/vm-id/Shutdown
  ONDERSTEUNDE HTTP-bewerkingen: POST.

  Hiermee wordt de geïdentificeerde virtuele machine afgesloten.

Virtuele schijven en virtuele netwerkadapters

• subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Disks
  ONDERSTEUNDE HTTP-bewerkingen: GET, POST.

  Biedt toegang tot de virtuele schijven van de geïdentificeerde virtuele machine. Deze URL kan ook worden gebruikt om een virtuele schijf aan de virtuele machine te koppelen met behulp van de POST-bewerking.

• subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMMs/vm-id/Disks/disk-id
  ONDERSTEUNDE HTTP-bewerkingen: GET, PUT, PATCH, DELETE.

  Biedt toegang tot de opgegeven virtuele schijven.

• subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Nics
  ONDERSTEUNDE HTTP-bewerkingen: GET.

  Biedt toegang tot de virtuele netwerkadapters van de geïdentificeerde virtuele machine.

• subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VMs/vm-id/Nics/nic-id
  ONDERSTEUNDE HTTP-bewerkingen: GET.

  Biedt toegang tot de opgegeven virtuele netwerkadapter.