Conversion - Delete

Gilt für: Siehe Preisstufen.

Creator ermöglicht es, Anwendungen basierend auf Ihren privaten Indoor-Kartendaten mithilfe von Azure Maps API und SDK zu entwickeln. In diesem Artikel werden Konzepte und Tools vorgestellt, die für Azure Maps Creator gelten.

Diese API ermöglicht dem Aufrufer das Löschen von Datenkonvertierungen, die zuvor mithilfe der Konvertierungs-API erstellt wurden.

Löschanforderung übermitteln

Um Ihre Konvertierungsdaten zu löschen, geben Sie eine DELETE Anforderung an, in der der Pfad die conversionId zu löschenden Daten enthält.

Konvertierungslöschantwort

Die Konvertierungslösch-API gibt eine HTTP-Antwort 204 No Content mit einem leeren Textkörper zurück, wenn die konvertierten Datenressourcen erfolgreich gelöscht wurden.

Eine HTTP-Fehlerantwort 400 Bad RequestconversionId wird zurückgegeben, wenn keine Ressource zurückgegeben wird, die der übergebenen Ressource zugeordnet ist.

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

URI-Parameter

Name In Required Type Description
conversionId
path True
  • string

Die Konvertierungs-ID für den Inhalt. Dies conversionId muss aus einem erfolgreichen Konvertierungs-API-Aufruf abgerufen werden.

geography
path True
  • string

Dieser Parameter gibt an, wo sich die Azure Maps Creator-Ressource befindet. Gültige Werte sind uns und eu.

api-version
query True
  • string

Versionsnummer der Azure Maps API.

Anforderungsheader

Name Required Type Description
x-ms-client-id
  • string

Gibt an, welches Konto in Verbindung mit dem Azure AD-Sicherheitsmodell für die Verwendung vorgesehen ist. Es stellt eine eindeutige ID für das Azure Maps-Konto dar und kann aus der Azure Maps verwaltungsebenen Konto-API abgerufen werden. Informationen zur Verwendung der Azure AD-Sicherheit in Azure Maps finden Sie in den folgenden Artikeln zur Anleitung.

Antworten

Name Type Description
204 No Content

Die Konvertierungslöschanforderung wurde erfolgreich abgeschlossen. Der Inhalt wurde conversionId auf dem Server gelöscht.

Other Status Codes

Ein unerwarteter Fehler ist aufgetreten.

Sicherheit

AADToken

Dies sind die Azure Active Directory OAuth2-Flusse . Wenn sie mit azure-rollenbasierter Zugriffssteuerung gekoppelt sind, kann er verwendet werden, um den Zugriff auf Azure Maps REST-APIs zu steuern. Azure-rollenbasierte Zugriffssteuerelemente werden verwendet, um den Zugriff auf ein oder mehrere Azure Maps Ressourcenkonto oder Unterressourcen festzulegen. Jeder Benutzer-, Gruppen- oder Dienstprinzipal kann Zugriff über eine integrierte Rolle oder eine benutzerdefinierte Rolle gewährt werden, die aus einer oder mehreren Berechtigungen für Azure Maps REST-APIs besteht.

Um Szenarien zu implementieren, empfehlen wir das Anzeigen von Authentifizierungskonzepten. In der Zusammenfassung stellt diese Sicherheitsdefinition eine Lösung für die Modellierung von Anwendungen über Objekte bereit, die Zugriffssteuerungen für bestimmte APIs und Bereiche ermöglichen.

Notizen

  • Diese Sicherheitsdefinition erfordert die Verwendung des x-ms-client-id Headers, um anzugeben, welche Azure Maps Ressource die Anwendung anfordert. Dies kann über die Kartenverwaltungs-API erworben werden.

Dies Authorization URL ist speziell für die Azure-öffentliche Cloudinstanz. Souveräne Clouds verfügen über eindeutige Autorisierungs-URLs und Azure Active Directory-Konfigurationen. * Die azure-rollenbasierte Zugriffssteuerung wird über Azure-Portal, PowerShell, CLI, Azure SDKs oder REST-APIs aus der Azure-Verwaltungsebene konfiguriert. * Die Verwendung des Azure Maps Web SDK ermöglicht die konfigurationsbasierte Einrichtung einer Anwendung für mehrere Anwendungsfälle.

  • Derzeit unterstützt Azure Active Directory v1.0 oder v2.0 Work, School und Gäste, aber keine persönlichen Konten.

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

Dies ist ein freigegebener Schlüssel, der bereitgestellt wird, wenn Sie ein Azure Maps Konto im Azure-Portal erstellen oder PowerShell, CLI, Azure SDKs oder REST-API verwenden.

Mit diesem Schlüssel kann jede Anwendung auf alle REST-API zugreifen. Mit anderen Worten, dieser Schlüssel kann als Masterschlüssel im Konto verwendet werden, in dem sie ausgestellt werden.

Für öffentlich zugängliche Anwendungen empfiehlt es sich, den vertraulichen Clientanwendungen-Ansatz zum Zugriff auf Azure Maps REST-APIs zu verwenden, damit Ihr Schlüssel sicher gespeichert werden kann.

Type: apiKey
In: query

SAS Token

Dies ist ein freigegebenes Zugriffssignaturtoken wird aus dem Listen-SAS-Vorgang auf der Azure Maps Ressource über die Azure-Verwaltungsebene über Azure-Portal, PowerShell, CLI, Azure SDKs oder REST-APIs erstellt.

Mit diesem Token ist jede Anwendung berechtigt, auf azure rollenbasierte Zugriffssteuerelemente und Feinkornsteuerelemente auf den Ablauf, die Rate und die Region(n) der Verwendung für das bestimmte Token zuzugreifen. Mit anderen Worten, das SAS-Token kann verwendet werden, um Anwendungen den Zugriff auf eine sicherere Weise als den freigegebenen Schlüssel zu steuern.

Für öffentlich zugängliche Anwendungen empfiehlt es sich, eine bestimmte Liste der zulässigen Ursprünge in der Kartenkontoressource zu konfigurieren, um das Rendern von Missbrauch zu beschränken und das SAS-Token regelmäßig zu verlängern.

Type: apiKey
In: header

Beispiele

Delete previously converted content

Sample Request

DELETE https://us.atlas.microsoft.com/conversions/99884fb7-87a9-0920-7f93-7952a0b91012?api-version=2.0

Sample Response

Definitionen

ErrorAdditionalInfo

Der Fehler beim Ressourcenverwaltungsfehler.

ErrorDetail

Die Fehlerdetails.

ErrorResponse

Fehlerantwort

ErrorAdditionalInfo

Der Fehler beim Ressourcenverwaltungsfehler.

Name Type Description
info
  • object

Die zusätzlichen Informationen.

type
  • string

Der zusätzliche Infotyp.

ErrorDetail

Die Fehlerdetails.

Name Type Description
additionalInfo

Der Fehler, der zusätzliche Informationen enthält.

code
  • string

Der Fehlercode.

details

Die Fehlerdetails.

message
  • string

Die Fehlermeldung.

target
  • string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Type Description
error

Das Fehlerobjekt.