VM 角色的 URL 速查表 [SPFSDK][VMROLE]
適用于：Windows Azure Pack
服務管理 API 是以 HTTP REST 為基礎的服務。 若要使用與 VM 角色相關的功能，請使用特定 URL 結構。 本主題提供使用 VM 角色時可用之所有 URL 的指南。 它會描述每個 URL 搭配使用的物件類型，以及如果有的話，這些物件可透過 URL 使用這些物件的動作。
重要
每當您搭配資源庫和雲端服務使用 URL 時，您必須附加 api-version=2013-03 查詢字串。 查詢字串一律以 URL 之後 的 ？ 字元開頭。 例如，若要存取名為TestService的雲端服務，您會使用此 URL：HTTPs:// server-name：server-port/subscription-id/CloudServices/TestService？api-version=2013-03。
常見的 URL 預留位置
在此程式設計指南 URL 中，將會使用需要基礎結構相關資訊的 URL，例如先前建立之物件的伺服器名稱或名稱。 下列清單描述使用的所有預留位置。
預留位置名稱 |
描述 |
|---|---|
server-name |
服務管理 API 伺服器的伺服器名稱。 |
server-port |
服務管理 API 伺服器的驗證埠。 |
subscription-id |
裝載 VM 角色的雲端服務名稱。 |
cloudservice-name |
裝載 VM 角色的雲端服務名稱。 |
vmrole-name |
VM 角色的名稱。 |
vm-id |
虛擬機器的識別碼。 |
disk-id |
虛擬硬碟的識別碼。 |
nic-id |
虛擬網路介面卡的識別碼。 |
資源庫
subscription-id/Gallery/GalleryItems
支援的 HTTP 作業：GET。提供可供指定訂用帳戶使用之資源庫專案的存取權。 傳回的專案不限於 VM 角色，但不論類型為何，都是所有資源庫專案。
subscription-id/Gallery/GalleryItems (publisher，name，version)
支援的 HTTP 作業：GET。提供特定資源庫專案的存取權，可供指定的訂用帳戶使用。
subscription-id/Gallery/GalleryItems/$/MicrosoftCompute.VMRoleGalleryItem
支援的 HTTP 作業：GET。提供存取指定訂用帳戶可用的 VM 角色資源庫專案。
如需使用此 URL 的範例，請參閱：
subscription-id/Gallery/GalleryItems/$/MicrosoftCompute.VMRoleGalleryItem (publisher，name，version)
支援的 HTTP 作業：GET。提供特定 VM 角色資源庫專案的存取權，可供指定的訂用帳戶使用。
如需使用此 URL 的範例，請參閱：
雲端服務
subscription-id/CloudServices
支援的 HTTP 作業：GET、POST。提供針對指定訂用帳戶所建立之雲端服務的存取權。 您可以使用 POST 作業來建立雲端服務。
如需使用此 URL 的範例，請參閱：
subscription-id/CloudServices/cloudservice-name
支援的 HTTP 作業：GET、PUT、PATCH、DELETE。提供指定訂用帳戶所建立之特定雲端服務的存取權。 URL 所識別的雲端服務可以更新和刪除。
subscription-id/CloudServices/cloudservice-name/Resources
支援的 HTTP 作業：GET。提供指定雲端服務可用之資源提供者的存取權。
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute
支援的 HTTP 作業：GET。提供裝載 VM 角色之 MicrosoftCompute 資源提供者的存取權。
VM 角色
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles
支援的 HTTP 作業：GET、POST。提供已建立之 VM 角色實例的存取權。 此 URL 也可用來將新的 VM 角色實例提交至伺服器。
如需使用此 URL 的範例，請參閱：
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name
支援的 HTTP 作業：GET、PUT、PATCH、DELETE。依名稱提供特定 VM 角色的存取權。 此 URL 可用來刪除和更新 VM 角色。
如需使用此 URL 的範例，請參閱：
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/Scale
支援的 HTTP 作業：POST。在指定的 VM 角色上起始調整動作。
如需使用此 URL 的範例，請參閱：
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/Repair
支援的 HTTP 作業：POST。在指定的 VM 角色上起始修復動作。
如需使用此 URL 的範例，請參閱：
虛擬機器
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VM
支援的 HTTP 作業：GET。提供特定 VM 角色中裝載之虛擬機器的存取權。
如需使用此 URL 的範例，請參閱：
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VM/vm-id
支援的 HTTP 作業：GET、DELETE。依裝載于特定 VM 角色的識別碼，提供虛擬機器的存取權。 此 URL 可用來從 VM 角色中刪除特定虛擬機器。
如需使用此 URL 的範例，請參閱：
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VM/vm-id/Stop
支援的 HTTP 作業：POST。停止已識別的虛擬機器。
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VM/vm-id/Start
支援的 HTTP 作業：POST。啟動已識別的虛擬機器。
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VM/vm-id/Restart
支援的 HTTP 作業：POST。重新開機已識別的虛擬機器。
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VM/vm-id/Shutdown
支援的 HTTP 作業：POST。關閉已識別的虛擬機器。
虛擬磁片和虛擬網路介面卡
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VM/vm-id/Disks
支援的 HTTP 作業：GET、POST。提供所識別虛擬機器之虛擬磁片的存取權。 此 URL 也可以用來使用 POST 作業將虛擬磁片連結至虛擬機器。
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VM/vm-id/Disks/disk-id
支援的 HTTP 作業：GET、PUT、PATCH、DELETE。提供指定之虛擬磁片的存取權。
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VM/vm-id/Nics
支援的 HTTP 作業：GET。提供所識別虛擬機器之虛擬網路介面卡的存取權。
subscription-id/CloudServices/cloudservice-name/Resources/MicrosoftCompute/VMRoles/vmrole-name/VM/vm-id/Nics/nic-id
支援的 HTTP 作業：GET。提供指定之虛擬網路介面卡的存取權。