Tileset - Get Operation
タイルセットの作成の状態を取得するには、 を使用します。
Get Operation
API は、タイルセット作成プロセスの状態をチェックし、値を取得するために使用される tilesetId
HTTP GET
要求です。 パスは、 Tileset - Create の呼び出しから取得されます。 進行中は、余分なヘッダーなしで HTTP 200 が返されます。 正常に完了すると、HTTP 200 がヘッダーと共に Resource-Location
返されます。 詳細については、「 タイルセットの作成の状態を確認する」を参照してください。
GET https://{geography}.atlas.microsoft.com/tilesets/operations/{operationId}?api-version=2023-03-01-preview
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
geography
|
path | True |
string |
このパラメーターは、Azure Maps Creator リソースの場所を指定します。 有効な値は、us と eu です。 |
operation
|
path | True |
string |
タイルセットの作成/インポート要求の状態を照会する ID。 |
api-version
|
query | True |
string |
Azure Maps API のバージョン番号。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
操作が実行されているか完了しています。 操作が成功した場合は、Resource-Location ヘッダーを使用して結果へのパスを取得します。 ヘッダー Resource-Location: string |
|
Other Status Codes |
予期しないエラーが発生しました。 |
セキュリティ
AADToken
これらは Azure Active Directory OAuth2 フローです。 Azure ロールベースのアクセス制御と組み合わせて使用すると、Azure Maps REST API へのアクセスを制御できます。 Azure ロールベースのアクセス制御は、1 つ以上のAzure Mapsリソース アカウントまたはサブリソースへのアクセスを指定するために使用されます。 REST API をAzure Mapsするための 1 つ以上のアクセス許可で構成される組み込みロールまたはカスタム ロールを使用して、ユーザー、グループ、またはサービス プリンシパルにアクセス権を付与できます。
シナリオを実装するには、 認証の概念を表示することをお勧めします。 要約すると、このセキュリティ定義は、特定の API とスコープに対するアクセス制御が可能なオブジェクトを使用してアプリケーションをモデル化するためのソリューションを提供します。
メモ
- このセキュリティ定義では、 ヘッダーを使用して、
x-ms-client-id
アプリケーションがアクセスを要求しているリソースAzure Maps示す必要があります。 これは、 Maps 管理 API から取得できます。
は Authorization URL
、Azure パブリック クラウド インスタンスに固有です。 ソブリン クラウドには、一意の承認 URL と Azure Active Directory 構成があります。
* Azure ロールベースのアクセス制御は、Azure portal、PowerShell、CLI、Azure SDK、または REST API を介して Azure 管理プレーンから構成されます。
* Azure Maps Web SDK を使用すると、複数のユース ケースに対してアプリケーションを構成ベースで設定できます。
- 現在、Azure Active Directory v1.0 または v2.0 では、職場、学校、ゲストはサポートされていますが、個人用アカウントはサポートされていません。
型:
oauth2
フロー:
implicit
Authorization URL (承認 URL):
https://login.microsoftonline.com/common/oauth2/authorize
スコープ
名前 | 説明 |
---|---|
https://atlas.microsoft.com/.default | https://atlas.microsoft.com/.default |
subscription-key
これは、Azure portalでAzure Maps アカウントを作成するとき、または PowerShell、CLI、Azure SDK、または REST API を使用してプロビジョニングされる共有キーです。
このキーを使用すると、すべてのアプリケーションですべての REST API にアクセスできます。 つまり、このキーは、発行先のアカウントのマスター キーとして使用できます。
公開されているアプリケーションの場合は、機密クライアント アプリケーション のアプローチを使用して、キーを安全に格納できるように、Azure Maps REST API にアクセスすることをお勧めします。
型:
apiKey
/:
query
SAS Token
これは、Azure portal、PowerShell、CLI、Azure SDK、または REST API を介して Azure 管理プレーンを介して、Azure Maps リソースの List SAS 操作から作成される共有アクセス署名トークンです。
このトークンを使用すると、すべてのアプリケーションが Azure ロールベースのアクセス制御を使用してアクセスし、特定のトークンに使用される有効期限、レート、およびリージョンに対するきめ細かい制御が許可されます。 言い換えると、SAS トークンを使用して、アプリケーションが共有キーよりもセキュリティで保護された方法でアクセスを制御できます。
公開されているアプリケーションの場合、 Map アカウント リソース で許可される配信元の特定のリストを構成して、レンダリングの不正使用を制限し、SAS トークンを定期的に更新することをお勧めします。
型:
apiKey
/:
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
要求のサンプル
GET https://us.atlas.microsoft.com/tilesets/operations/{operationId}?api-version=2023-03-01-preview
応答のサンプル
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
要求のサンプル
GET https://us.atlas.microsoft.com/tilesets/operations/{operationId}?api-version=2023-03-01-preview
応答のサンプル
{
"operationId": "{operationId}",
"created": "2021-04-23T19:14:03.2452596+00:00",
"status": "Running"
}
定義
名前 | 説明 |
---|---|
Error |
リソース管理エラーの追加情報。 |
Error |
エラーの詳細。 |
Error |
エラー応答 |
Long |
Long-Running Operations API の応答モデル。 |
Lro |
要求の状態。 |
ErrorAdditionalInfo
リソース管理エラーの追加情報。
名前 | 型 | 説明 |
---|---|---|
info |
object |
追加情報。 |
type |
string |
追加情報の種類。 |
ErrorDetail
エラーの詳細。
名前 | 型 | 説明 |
---|---|---|
additionalInfo |
エラーの追加情報。 |
|
code |
string |
エラー コード。 |
details |
エラーの詳細です。 |
|
message |
string |
エラー メッセージ。 |
target |
string |
エラーのターゲット。 |
ErrorResponse
エラー応答
名前 | 型 | 説明 |
---|---|---|
error |
error オブジェクト。 |
LongRunningOperationResult
Long-Running Operations API の応答モデル。
名前 | 型 | 説明 |
---|---|---|
created |
string |
作成されたタイムスタンプ。 |
error |
エラーの詳細。 |
|
operationId |
string |
この実行時間の長い操作の ID。 |
status |
要求の状態。 |
|
warning |
エラーの詳細。 |
LroStatus
要求の状態。
名前 | 型 | 説明 |
---|---|---|
Failed |
string |
要求に 1 つ以上のエラーがあります。 |
NotStarted |
string |
要求はまだ処理を開始していません。 |
Running |
string |
要求の処理が開始されました。 |
Succeeded |
string |
要求が正常に完了しました。 |