Tileset - Get Operation
用來取得建立磚集的狀態。
Get Operation
API 是 HTTP GET
要求,可用來檢查磚集建立程序的狀態,並擷取tilesetId
值。 路徑是從 對 Tileset - Create 的呼叫取得。 進行中時,不會傳回 HTTP 200,而且沒有額外的標頭。 成功完成 HTTP 200 之後,會傳回標頭 Resource-Location
。 如需詳細資訊,請參閱 檢查磚集建立的狀態。
GET https://{geography}.atlas.microsoft.com/tilesets/operations/{operationId}?api-version=2023-03-01-preview
URI 參數
名稱 | 位於 | 必要 | 類型 | Description |
---|---|---|---|---|
geography
|
path | True |
string |
此參數會指定 Azure 地圖服務 Creator 資源所在的位置。 有效值為us和 eu。 |
operation
|
path | True |
string |
要查詢磚集建立/匯入要求狀態的標識符。 |
api-version
|
query | True |
string |
Azure 地圖服務 API 的版本號碼。 |
回應
名稱 | 類型 | Description |
---|---|---|
200 OK |
作業正在執行或完成。 如果作業成功,請使用 Resource-Location 標頭來取得結果的路徑。 Headers Resource-Location: string |
|
Other Status Codes |
發生意外錯誤。 |
安全性
AADToken
這些是 Azure Active Directory OAuth2 流程。 與 Azure 角色型存取控制配對時,可用來控制對 REST API 的存取 Azure 地圖服務。 Azure 角色型訪問控制可用來指定一或多個 Azure 地圖服務 資源帳戶或子資源的存取權。 任何使用者、群組或服務主體都可以透過內建角色或由一或多個許可權組成的自定義角色來授與存取權,以 Azure 地圖服務 REST API。
若要實作案例,建議您檢視 驗證概念。 總而言之,此安全性定義提供一個解決方案,可透過能夠針對特定 API 和範圍進行存取控制的物件,將應用程式模型化 () 。
備註
- 此安全性定義需要使用
x-ms-client-id
標頭來指出應用程式要求存取權 Azure 地圖服務 資源。 這可以從 地圖服務管理 API 取得。
Authorization URL
專屬於 Azure 公用雲端實例。 主權雲端具有唯一的授權 URL 和 Azure Active Directory 設定。
* 透過 Azure 入口網站、PowerShell、CLI、Azure SDK 或 REST API,從 Azure 管理平面設定 Azure 角色型存取控制。
* Azure 地圖服務 Web SDK 的使用方式允許針對多個使用案例設定應用程式的組態型設定。
- Azure Active Directory v1.0 或 v2.0 目前支援公司、學校和來賓,但不支持個人帳戶。
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
名稱 | Description |
---|---|
https://atlas.microsoft.com/.default | https://atlas.microsoft.com/.default |
subscription-key
這是當您在 Azure 入口網站 或使用 PowerShell、CLI、Azure SDK 或 REST API 中建立 Azure 地圖服務 帳戶時所佈建的共享密鑰。
使用此金鑰時,任何應用程式都可以存取所有 REST API。 換句話說,此金鑰可作為發行帳戶中的主要金鑰。
對於公開的應用程式,我們建議使用機密用戶端應用程式方法來存取 Azure 地圖服務 REST API,以便安全地儲存您的密鑰。
Type:
apiKey
In:
query
SAS Token
這是透過 Azure 入口網站、PowerShell、CLI、Azure SDK 或 REST API,從 Azure 地圖服務 資源上的列出 SAS 作業建立共用存取簽章令牌。
使用此令牌時,任何應用程式都有權使用 Azure 角色型訪問控制進行存取,並精細控制到期、速率和區域 (特定令牌的使用) 。 換句話說,SAS 令牌可用來允許應用程式以比共用密鑰更安全的方式控制存取。
對於公開的應用程式,我們建議在 地圖帳戶資源 上設定允許的來源特定清單,以限制轉譯濫用,並定期更新 SAS 令牌。
Type:
apiKey
In:
header
範例
Get the status of an operation which has finished successfully |
Get the status of an operation which is still running |
Get the status of an operation which has finished successfully
Sample Request
GET https://us.atlas.microsoft.com/tilesets/operations/{operationId}?api-version=2023-03-01-preview
Sample Response
Resource-Location: https://us.atlas.microsoft.com/tilesets/{tilesetId}?api-version=2023-03-01-preview
{
"operationId": "{operationId}",
"created": "2021-04-20T22:43:14.9401559+00:00",
"status": "Succeeded"
}
Get the status of an operation which is still running
Sample Request
GET https://us.atlas.microsoft.com/tilesets/operations/{operationId}?api-version=2023-03-01-preview
Sample Response
{
"operationId": "{operationId}",
"created": "2021-04-23T19:14:03.2452596+00:00",
"status": "Running"
}
定義
名稱 | Description |
---|---|
Error |
資源管理錯誤其他資訊。 |
Error |
錯誤詳細數據。 |
Error |
錯誤回應 |
Long |
Long-Running Operations API 的回應模型。 |
Lro |
要求的狀態狀態。 |
ErrorAdditionalInfo
資源管理錯誤其他資訊。
名稱 | 類型 | Description |
---|---|---|
info |
object |
其他資訊。 |
type |
string |
其他信息類型。 |
ErrorDetail
錯誤詳細數據。
名稱 | 類型 | Description |
---|---|---|
additionalInfo |
錯誤其他資訊。 |
|
code |
string |
錯誤碼。 |
details |
錯誤詳細資料。 |
|
message |
string |
錯誤訊息。 |
target |
string |
錯誤目標。 |
ErrorResponse
錯誤回應
名稱 | 類型 | Description |
---|---|---|
error |
error 物件。 |
LongRunningOperationResult
Long-Running Operations API 的回應模型。
名稱 | 類型 | Description |
---|---|---|
created |
string |
建立的時間戳。 |
error |
錯誤詳細數據。 |
|
operationId |
string |
這個長時間執行作業的標識碼。 |
status |
要求的狀態狀態。 |
|
warning |
錯誤詳細數據。 |
LroStatus
要求的狀態狀態。
名稱 | 類型 | Description |
---|---|---|
Failed |
string |
要求有一或多個失敗。 |
NotStarted |
string |
要求尚未開始處理。 |
Running |
string |
要求已開始處理。 |
Succeeded |
string |
要求已成功完成。 |