共用方式為


虛擬目錄資源

虛擬目錄提供建立網站所需的虛擬檔案階層的方式。 虛擬目錄 API 可讓取用者建立、讀取、刪除或更新其虛擬目錄。

GET/api/webserver/virtual-directory/{id}

{
    "location": "Default Web Site/demo-vdir",
    "path": "/demo-vdir",
    "id": "{id}",
    "physical_path": "c:\\inetpub\\wwwroot\\demo-vdir",
    "identity": {
        "username": "",
        "logon_method": "network_cleartext"
    },
    "webapp": {
        "location": "Default Web Site/",
        "path": "/",
        "id": "{webapp_id}"
    },
    "website": {
        "name": "Default Web Site",
        "id": "{website_id}",
        "status": "started"
    }
}

擷取網站的虛擬目錄

可以藉由在 GET 要求中提供網站標識碼來擷取屬於網站的虛擬目錄。 網站 資源包含存取其虛擬目錄 HAL所需的連結。

列出網站的虛擬目錄。 GET/api/webserver/virtual-directory?website.id={website_id}

{
    "virtual_directories": [
        {
            "location": "Default Web Site/",
            "path": "/",
            "id": "{id}",
            "_links": {
                "self": {
                    "href": "/api/webserver/virtual-directories/{id}"
                }
            }
        },
        {
            "location": "Default Web Site/demo-vdir",
            "path": "/demo-vdir",
            "id": "{id_1}",
            "_links": {
                "self": {
                    "href": "/api/webserver/virtual-directories/{id_1}"
                }
            }
        }
    ]
}

擷取應用程式的虛擬目錄

可以藉由在 GET 要求中提供應用程式識別碼來擷取屬於應用程式的虛擬目錄。 Web 應用程式 資源包含存取其 HAL虛擬目錄所需的連結。

列出應用程式的虛擬目錄。 GET/api/webserver/virtual-directory?webapp.id={webapp_id}

{
    "virtual_directories": [
        {
            "location": "Default Web Site/demo-app/",
            "path": "/",
            "id": "{id}",
            "_links": {
                "self": {
                    "href": "/api/webserver/virtual-directories/{id}"
                }
            }
        },
        {
            "location": "Default Web Site/demo-app/app-level-vdir",
            "path": "/app-level-vdir",
            "id": "{id_1}",
            "_links": {
                "self": {
                    "href": "/api/webserver/virtual-directories/{id_1}"
                }
            }
        }
    ]
}

建立虛擬目錄

建立虛擬目錄需要

  • 虛擬目錄所屬的網站或 Web 應用程式
  • 相對於網站或 Web 應用程式根目錄的虛擬路徑
  • 實體路徑,指定虛擬目錄將位於文件系統上的目錄

建立虛擬目錄 POST/api/webserver/virtual-directory

{
    "path": "demo-vdir",
    "physical_path": "C:\\inetpub\\wwwroot\\demo-vdir",
    "website": {
        "id": {website_id}
    }
}