Data Registry - Register Or Replace
Slouží k registraci dat uložených v účtu služby Azure Storage pomocí účtu Azure Maps.
Rozhraní Register
API je požadavek HTTPPUT
, který slouží k registraci dat v účtu služby Azure Storage pomocí účtu Azure Maps. Maximální velikost souboru, který lze zaregistrovat, je jeden gigabajt.
To je užitečné ve scénářích, jako je registrace kolekce geografických monitorů ve GeoJSON
formátu pro použití ve službě Azure Maps Geofencing Nebo registrace sady souborů návrhů DWG jako komprimovaného balíčku výkresu pro použití ve službě Azure Maps Creator Conversion Service.
Rozsah koncového bodu služby registru dat je omezený na oblast vašeho účtu Azure Maps a není k dispozici pro globální účty Azure Maps.
Odeslat žádost o registraci nebo nahrazení
Požadavky Register
a Replace
jsou dlouhotrvající operace, které obsahují objekt JSON AzureBlob v těle požadavku, který definuje podrobnosti registru dat.
PUT https://{geography}.atlas.microsoft.com/dataRegistries/{udid}?api-version=2023-06-01
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
geography
|
path | True |
string |
Tento parametr určuje, kde se nachází účet Azure Maps. Platné hodnoty jsou my (USA – východ, USA – středozápad, USA – západ 2) a eu (Severní Evropa, Západní Evropa). |
udid
|
path | True |
string |
ID uživatelských dat registru dat. Regex pattern: |
api-version
|
query | True |
string |
Číslo verze rozhraní API Azure Maps. |
Hlavička požadavku
Name | Vyžadováno | Typ | Description |
---|---|---|---|
x-ms-client-id |
string |
Určuje, který účet je určený pro použití ve spojení s modelem zabezpečení Microsoft Entra ID. Představuje jedinečné ID účtu Azure Maps a je možné ho načíst z rozhraní API účtu roviny správy Azure Maps. Pokud chcete použít Microsoft Entra ID zabezpečení v Azure Maps pokyny najdete v následujících článcích. |
|
Operation-Id |
string |
ID operace ve formátu GUID. Regex pattern: |
Text požadavku
Name | Typ | Description |
---|---|---|
azureBlob |
Podrobnosti registru dat objektů blob Azure |
|
description |
string |
Popis předaný registru dat. Maximální délka je 1024 znaků. |
kind |
Druh registru dat. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
Nahrazování prostředků: Požadavek byl přijat ke zpracování. Headers
|
|
201 Created |
Vytvoření prostředku: Požadavek byl přijat ke zpracování. Headers
|
|
Other Status Codes |
Došlo k neočekávané chybě. Headers x-ms-error-code: string |
Zabezpečení
AADToken
Toto jsou Microsoft Entra toky OAuth 2.0. Při spárování s řízením přístupu na základě role v Azure se dá použít k řízení přístupu k Azure Maps rozhraní REST API. Řízení přístupu na základě role v Azure slouží k určení přístupu k jednomu nebo několika Azure Maps účtu prostředku nebo dílčím prostředkům. Každému uživateli, skupině nebo instančnímu objektu je možné udělit přístup prostřednictvím předdefinované role nebo vlastní role složené z jednoho nebo více oprávnění k Azure Maps rozhraní REST API.
Pokud chcete implementovat scénáře, doporučujeme zobrazit si koncepty ověřování. Souhrnně řečeno, tato definice zabezpečení poskytuje řešení pro modelování aplikací prostřednictvím objektů schopných řízení přístupu pro konkrétní rozhraní API a obory.
Poznámky
- Tato definice zabezpečení vyžaduje použití hlavičky
x-ms-client-id
k označení Azure Maps prostředku, ke kterému aplikace žádá o přístup. Můžete ho získat z rozhraní MAPS MANAGEMENT API.
Je Authorization URL
specifický pro instanci veřejného cloudu Azure. Suverénní cloudy mají jedinečné autorizační adresy URL a konfigurace Microsoft Entra ID.
* Řízení přístupu na základě role v Azure se konfiguruje z roviny správy Azure prostřednictvím Azure Portal, PowerShellu, rozhraní příkazového řádku, sad Azure SDK nebo rozhraní REST API.
* Použití sady AZURE MAPS Web SDK umožňuje nastavení aplikace na základě konfigurace pro více případů použití.
- Další informace o Microsoft identity platform najdete v přehledu Microsoft identity platform.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
https://atlas.microsoft.com/.default | https://atlas.microsoft.com/.default |
subscription-key
Jedná se o sdílený klíč, který se zřizuje při vytváření prostředku Azure Maps prostřednictvím roviny správy Azure prostřednictvím Azure Portal, PowerShellu, rozhraní příkazového řádku, sad Azure SDK nebo rozhraní REST API.
S tímto klíčem má každá aplikace autorizaci pro přístup ke všem rozhraním REST API. Jinými slovy, ty je v současné době možné považovat za hlavní klíče k účtu, pro který jsou vystavené.
U veřejně vystavených aplikací doporučujeme použít přístup mezi servery Azure Maps rozhraní REST API, kde je možné tento klíč bezpečně uložit.
Type:
apiKey
In:
header
SAS Token
Jedná se o token sdíleného přístupového podpisu, který se vytvoří z operace List SAS v Azure Maps prostředku prostřednictvím roviny správy Azure prostřednictvím Azure Portal, PowerShellu, rozhraní příkazového řádku, sad Azure SDK nebo rozhraní REST API.
S tímto tokenem má každá aplikace autorizaci pro přístup pomocí řízení přístupu na základě role v Azure a podrobnou kontrolu vypršení platnosti, četnosti a oblastí použití konkrétního tokenu. Jinými slovy, token SAS je možné použít k tomu, aby aplikace mohly řídit přístup zabezpečeným způsobem než sdílený klíč.
U veřejně vystavených aplikací doporučujeme nakonfigurovat konkrétní seznam povolených zdrojů v prostředku účtu map , aby se omezilo zneužití vykreslování, a pravidelně obnovovat token SAS.
Type:
apiKey
In:
header
Příklady
Register or replace a udid
Sample Request
PUT https://us.atlas.microsoft.com/dataRegistries/29a92cab-74af-49e7-a326-66898220aa9d?api-version=2023-06-01
{
"description": "Contoso Geofence GeoJSON",
"kind": "AzureBlob",
"azureBlob": {
"dataFormat": "geojson",
"msiClientId": "3263cad5-ed8b-4829-b72b-3d1ba556e373",
"linkedResource": "my-storage-account",
"blobUrl": "https://mystorageaccount.blob.core.windows.net/my-container/my/blob/path.json"
}
}
Sample Response
Operation-Id: 0522b4fe-0539-4c6c-ba70-e35ec865d8e2
Operation-Location: https://us.atlas.microsoft.com/dataRegistries/operations/0522b4fe-0539-4c6c-ba70-e35ec865d8e2
{
"udid": "29a92cab-74af-49e7-a326-66898220aa9d",
"description": "Contoso Geofence GeoJSON",
"kind": "AzureBlob",
"azureBlob": {
"dataFormat": "geojson",
"msiClientId": "3263cad5-ed8b-4829-b72b-3d1ba556e373",
"linkedResource": "my-storage-account",
"blobUrl": "https://mystorageaccount.blob.core.windows.net/my-container/my/blob/path.json",
"sizeInBytes": 1339
},
"status": "Running"
}
Operation-Id: 0522b4fe-0539-4c6c-ba70-e35ec865d8e2
Operation-Location: https://us.atlas.microsoft.com/dataRegistries/operations/0522b4fe-0539-4c6c-ba70-e35ec865d8e2
{
"udid": "29a92cab-74af-49e7-a326-66898220aa9d",
"description": "Contoso Geofence GeoJSON",
"kind": "AzureBlob",
"azureBlob": {
"dataFormat": "geojson",
"msiClientId": "3263cad5-ed8b-4829-b72b-3d1ba556e373",
"linkedResource": "my-storage-account",
"blobUrl": "https://mystorageaccount.blob.core.windows.net/my-container/my/blob/path.json",
"sizeInBytes": 1339
},
"status": "Running"
}
Definice
Name | Description |
---|---|
Azure |
Podrobnosti registru dat objektů blob Azure |
Data |
Formát dat nahraného obsahu, který se používá pro účely ověření. |
Data |
Registr dat v Azure Maps. |
Data |
Druh registru dat. |
Long |
Stav dlouhotrvající operace. |
Maps |
Podrobnosti o chybě |
Maps |
Běžná chybová odpověď pro rozhraní API Azure Maps, která vrací podrobnosti o chybě pro neúspěšné operace. |
Maps |
Objekt obsahující konkrétnější informace o chybě než aktuální objekt. |
AzureBlob
Podrobnosti registru dat objektů blob Azure
Name | Typ | Description |
---|---|---|
blobUrl |
string |
Adresa URL objektu blob obsahuje cestu k registrovanému souboru. |
contentMD5 |
string |
Obsah MD5 obsahu, který se používá k ověření dat. |
dataFormat |
Formát dat nahraného obsahu, který se používá pro účely ověření. |
|
linkedResource |
string |
ID úložiště dat v účtu Azure Maps. |
msiClientId |
string |
ID klienta spravované identity přiřazené uživatelem Pokud není k dispozici, použijte spravovanou identitu přiřazenou systémem. |
sizeInBytes |
integer |
Velikost obsahu v bajtech. |
DataFormat
Formát dat nahraného obsahu, který se používá pro účely ověření.
Name | Typ | Description |
---|---|---|
geojson |
string |
GeoJSON je formát geoprostorových dat založený na formátu JSON. |
zip |
string |
Komprimovaný formát dat. |
DataRegistry
Registr dat v Azure Maps.
Name | Typ | Description |
---|---|---|
azureBlob |
Podrobnosti registru dat objektů blob Azure |
|
description |
string |
Popis předaný registru dat. Maximální délka je 1024 znaků. |
error |
Podrobnosti o chybě |
|
kind |
Druh registru dat. |
|
status |
Stav dlouhotrvající operace. |
|
udid |
string |
ID dat uživatele pro registr dat. |
DataRegistryKind
Druh registru dat.
Name | Typ | Description |
---|---|---|
AzureBlob |
string |
Azure Blob |
LongRunningOperationStatus
Stav dlouhotrvající operace.
Name | Typ | Description |
---|---|---|
Completed |
string |
Požadavek se úspěšně dokončil. |
Failed |
string |
Požadavek má jedno nebo více selhání. |
Running |
string |
Žádost se právě zpracovává. |
MapsErrorDetail
Podrobnosti o chybě
Name | Typ | Description |
---|---|---|
code |
string |
Jeden ze serverem definovaných chybových kódů. |
details |
Pole podrobností o konkrétních chybách, které vedly k této nahlášené chybě. |
|
innererror |
Objekt obsahující konkrétnější informace o chybě než aktuální objekt. |
|
message |
string |
Lidsky čitelná reprezentace chyby. |
target |
string |
Cíl chyby. |
MapsErrorResponse
Běžná chybová odpověď pro rozhraní API Azure Maps, která vrací podrobnosti o chybě pro neúspěšné operace.
Name | Typ | Description |
---|---|---|
error |
Podrobnosti o chybě |
MapsInnerError
Objekt obsahující konkrétnější informace o chybě než aktuální objekt.
Name | Typ | Description |
---|---|---|
code |
string |
Kód chyby |
innererror |
Objekt obsahující konkrétnější informace o chybě než aktuální objekt. |