Megosztás a következőn keresztül:


Data - Delete

Az adatfeltöltéssel korábban feltöltött adatok törlésére használható.

Megjegyzés

Az Azure Maps data service kivezetése

Az Azure Maps Adatszolgáltatás ( v1 és v2) elavult, és 24.09.16-án megszűnik. A szolgáltatáskimaradások elkerülése érdekében az Adatszolgáltatásba irányuló összes hívást frissíteni kell az Azure Maps Data Registry szolgáltatás használatához 24.09.16-ig. További információ: Adatregisztrációs adatbázis létrehozása.

Az Data Delete API egy HTTP-kérés DELETE , amely lehetővé teszi, hogy a hívó töröljön egy korábban feltöltött adattartalmat.

Ezt az API-t olyan forgatókönyvekben használhatja, mint a korábban feltöltött geofencek eltávolítása az Adatfeltöltési API használatával az Azure Maps Geofencing Service-ben való használatra. Ezzel az API-val törölheti a régi/nem használt feltöltött tartalmakat, és helyet hozhat létre az új tartalmak számára.

Fontos

Ezzel a funkcióval elfogadja az előzetes verzióra vonatkozó jogi feltételeket. További részletekért tekintse meg az előzetes verzió kiegészítő feltételeit .

Törlési kérelem elküldése

A tartalom törléséhez egy kérést DELETE fog kiadni, amelyben az elérési út tartalmazza a udid törölni kívánt adatokat.

Ha például törölni szeretné a korábban az Upload API használatával feltöltött geofences gyűjteményt, állítsa a udid paramétert az elérési úton a udid feltöltési API-válaszban korábban kapott adatokra.

Adatválasz törlése

Az Adattörlési API egy üres törzsű HTTP-választ 204 No Content ad vissza, ha az adaterőforrást sikeresen törölték.

A rendszer HTTP-hibaválaszt 400 Bad Requestudid ad vissza, ha az átadott adaterőforrás nem található.

DELETE https://{geography}.atlas.microsoft.com/mapData/{udid}?api-version=2.0

URI-paraméterek

Name In Kötelező Típus Description
geography
path True

string

Ez a paraméter határozza meg, hogy hol található az Azure Maps Creator-erőforrás. Érvényes értékek vagyunk és eu.

udid
path True

string

A tartalom egyedi adatazonosítója. Ezt udid egy sikeres adatfeltöltési hívásból kellett beszerezni.

api-version
query True

string

Az Azure Maps API verziószáma.

Kérelem fejléce

Name Kötelező Típus Description
x-ms-client-id

string

Meghatározza, hogy melyik fiók legyen használatban a Microsoft Entra ID biztonsági modellel együtt. Az Azure Maps-fiók egyedi azonosítóját jelöli, és lekérhető az Azure Maps felügyeleti síkjának Fiók API-jából. A Microsoft Entra ID-biztonság Azure Mapsben való használatához tekintse meg az alábbi cikkeket .

Válaszok

Name Típus Description
204 No Content

Az adattörlési kérelem sikeresen befejeződött. A tartalom udid törölve lett a kiszolgálón.

Other Status Codes

ErrorResponse

Váratlan hiba történt.

Biztonság

AADToken

Ezek a Microsoft Entra OAuth 2.0 folyamatok. Az Azure-beli szerepköralapú hozzáférés-vezérléssel párosítva szabályozható az Azure Maps REST API-khoz való hozzáférés. Az Azure szerepköralapú hozzáférés-vezérlői egy vagy több Azure Maps-erőforrásfiókhoz vagy alerőforrásokhoz való hozzáférés kijelölésére szolgálnak. Bármely felhasználó, csoport vagy szolgáltatásnév hozzáférést kaphat egy beépített szerepkörrel, vagy egy vagy több Azure Maps REST API-ra vonatkozó engedélyből álló egyéni szerepkörrel.

A forgatókönyvek implementálásához javasoljuk, hogy tekintse meg a hitelesítési fogalmakat. Összefoglalva, ez a biztonsági definíció megoldást nyújt az alkalmazások modellezésére olyan objektumokon keresztül, amelyek hozzáférés-vezérlésre képesek adott API-kon és hatókörökön.

Jegyzetek

  • Ez a biztonsági definíció megköveteli a fejléc használatát x-ms-client-id annak jelzéséhez, hogy az alkalmazás melyik Azure Maps-erőforráshoz kér hozzáférést. Ez a Térképek felügyeleti API-ból szerezhető be.

Ez Authorization URL az Azure nyilvános felhőpéldányára jellemző. A szuverén felhők egyedi engedélyezési URL-címekkel és Microsoft Entra ID-konfigurációkkal rendelkeznek. * Az Azure szerepköralapú hozzáférés-vezérlés az Azure felügyeleti síkjáról van konfigurálva az Azure Portalon, a PowerShellen, a parancssori felületen, az Azure SDK-kon vagy a REST API-kon keresztül. * Az Azure Maps Web SDK használata lehetővé teszi egy alkalmazás konfigurációalapú beállítását több használati esetben.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name Description
https://atlas.microsoft.com/.default https://atlas.microsoft.com/.default

subscription-key

Ez egy megosztott kulcs, amely akkor lesz kiépítve, ha Azure Maps-fiókot hoz létre az Azure Portalon, vagy a PowerShell, a CLI, az Azure SDK-k vagy a REST API használatával.

Ezzel a kulccsal bármely alkalmazás hozzáférhet az összes REST API-hoz. Más szóval ez a kulcs használható főkulcsként abban a fiókban, amelyben ki vannak adva.

Nyilvánosan közzétett alkalmazások esetében javasoljuk, hogy a bizalmas ügyfélalkalmazások megközelítésével érje el az Azure Maps REST API-kat, hogy a kulcs biztonságosan tárolható legyen.

Típus: apiKey
In: query

SAS Token

Ez egy közös hozzáférésű jogosultságkód-jogkivonat az Azure Maps-erőforrás Sas listázási műveletéből jön létre az Azure Felügyeleti síkon keresztül az Azure Portalon, a PowerShellen, a parancssori felületen, az Azure SDK-kon vagy a REST API-kon keresztül.

Ezzel a jogkivonattal minden alkalmazás jogosult hozzáférni az Azure szerepköralapú hozzáférés-vezérlőihez, valamint az adott jogkivonat lejáratához, sebességéhez és régiójához. Más szóval az SAS-jogkivonattal az alkalmazások biztonságosabb módon szabályozhatják a hozzáférést, mint a megosztott kulcs.

Nyilvánosan közzétett alkalmazások esetében azt javasoljuk, hogy konfigurálja az engedélyezett források adott listáját a Térképfiók erőforráson a megjelenítési visszaélések korlátozása és az SAS-jogkivonat rendszeres megújítása érdekében.

Típus: apiKey
In: header

Példák

Delete previously uploaded GeoJSON data containing geometries that represent a collection of geofences

Mintakérelem

DELETE https://us.atlas.microsoft.com/mapData/25084fb7-307a-4720-8f91-7952a0b91012?api-version=2.0

Mintaválasz

Definíciók

Name Description
ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

ErrorDetail

A hiba részletei.

ErrorResponse

Hibaválasz

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

Name Típus Description
info

object

A további információk.

type

string

A további információtípus.

ErrorDetail

A hiba részletei.

Name Típus Description
additionalInfo

ErrorAdditionalInfo[]

A hiba további információi.

code

string

A hibakód.

details

ErrorDetail[]

A hiba részletei.

message

string

A hibaüzenet.

target

string

A hibacél.

ErrorResponse

Hibaválasz

Name Típus Description
error

ErrorDetail

A hibaobjektum.