Data Registry - List

Referentie

Service:: Maps

API-versie:: 2023-06-01

Gebruik om een lijst met alle gegevensregisters in het Azure Maps-account op te halen.

De List API is een HTTP-aanvraag GET die een matrix retourneert met alle gegevensregisters die eerder zijn geregistreerd met behulp van de API Registreren of Vervangen.

Het service-eindpunt van het gegevensregister is beperkt tot de regio van uw Azure Maps-account en is niet beschikbaar voor globale Azure Maps-accounts.

Aanvraag voor lijst verzenden

Als u al uw gegevensregisters wilt weergeven, verzendt u een GET aanvraag zonder aanvullende parameters.

Lijstantwoord

De List aanvraag retourneert een matrix met gegevensregisters in JSON de indeling in de hoofdtekst van het antwoord.

GET https://{geography}.atlas.microsoft.com/dataRegistries?api-version=2023-06-01

URI-parameters

Name	In	Vereist	Type	Description
geography	path	True	string	Deze parameter geeft aan waar het Azure Maps-account zich bevindt. Geldige waarden zijn us (VS - oost, VS - west-centraal, VS - west 2) en eu (Europa - noord, Europa - west).
api-version	query	True	string	Het versienummer van de Azure Maps-API.

Aanvraagkoptekst

Name	Vereist	Type	Description
x-ms-client-id		string	Hiermee geeft u op welk account is bedoeld voor gebruik in combinatie met het Microsoft Entra ID-beveiligingsmodel. Het vertegenwoordigt een unieke id voor het Azure Maps-account en kan worden opgehaald uit de Azure Maps-beheervlak Account-API. Als u Microsoft Entra ID-beveiliging in Azure Maps wilt gebruiken, raadpleegt u de volgende artikelen voor hulp.

Antwoorden

Name Type Description

200 OK

Name	Type	Description
200 OK	DataRegistryList	De `List` aanvraag is voltooid. De antwoordtekst bevat een matrix met gegevensregisters.
Other Status Codes	MapsErrorResponse	Er is een onverwachte fout opgetreden. Kopteksten x-ms-error-code: string

DataRegistryList

De List aanvraag is voltooid. De antwoordtekst bevat een matrix met gegevensregisters.

Other Status Codes

MapsErrorResponse

Er is een onverwachte fout opgetreden.

Kopteksten

x-ms-error-code: string

Beveiliging

AADToken

Dit zijn de Microsoft Entra OAuth 2.0-stromen . Wanneer het wordt gekoppeld met op rollen gebaseerd toegangsbeheer van Azure , kan het worden gebruikt om de toegang tot Azure Maps REST API's te beheren. Op rollen gebaseerd toegangsbeheer van Azure wordt gebruikt om toegang tot een of meer Azure Maps-resourceaccounts of subresources aan te wijzen. Elke gebruiker, groep of service-principal kan toegang krijgen via een ingebouwde rol of een aangepaste rol die bestaat uit een of meer machtigingen voor Azure Maps REST API's.

Voor het implementeren van scenario's raden we u aan verificatieconcepten te bekijken. Samengevat biedt deze beveiligingsdefinitie een oplossing voor het modelleren van toepassingen via objecten die toegangsbeheer kunnen hebben voor specifieke API's en bereiken.

Notities

Voor deze beveiligingsdefinitie is het gebruik van de x-ms-client-id header vereist om aan te geven tot welke Azure Maps-resource de toepassing toegang aanvraagt. Dit kan worden verkregen via de Kaarten-beheer-API.

De Authorization URL is specifiek voor het azure-exemplaar van de openbare cloud. Onafhankelijke clouds hebben unieke autorisatie-URL's en Microsoft Entra ID-configuraties. * Op rollen gebaseerd toegangsbeheer van Azure wordt geconfigureerd vanuit het Azure-beheervlak via Azure Portal, PowerShell, CLI, Azure SDK's of REST API's. * Gebruik van de Azure Maps Web SDK maakt het mogelijk om een toepassing op basis van configuraties in te stellen voor meerdere gebruiksvoorbeelden.

Zie Overzicht van Microsoft Identity Platform voor meer informatie over Microsoft Identity Platform.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

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

subscription-key

Dit is een gedeelde sleutel die wordt ingericht bij het maken van een Azure Maps-resource via het Azure-beheervlak via Azure Portal, PowerShell, CLI, Azure SDK's of REST API's.

Met deze sleutel is elke toepassing gemachtigd voor toegang tot alle REST API's. Met andere woorden, deze kunnen momenteel worden behandeld als hoofdsleutels voor het account waarvoor ze zijn uitgegeven.

Voor openbaar beschikbare toepassingen wordt aanbevolen om server-naar-servertoegang van Azure Maps REST API's te gebruiken, waar deze sleutel veilig kan worden opgeslagen.

Type: apiKey
In: header

SAS Token

Dit is een Shared Access Signature-token dat is gemaakt op basis van de SAS-bewerking List op de Azure Maps-resource via het Azure-beheervlak via Azure Portal, PowerShell, CLI, Azure SDK's of REST API's.

Met dit token is elke toepassing gemachtigd om toegang te krijgen met op rollen gebaseerd toegangsbeheer van Azure en fijnmazige controle tot de vervaldatum, frequentie en gebruiksregio(s) voor het specifieke token. Met andere woorden, het SAS-token kan worden gebruikt om toepassingen in staat te stellen toegang op een veiligere manier te beheren dan de gedeelde sleutel.

Voor openbaar beschikbaar gemaakte toepassingen wordt aanbevolen om een specifieke lijst met toegestane origins te configureren voor de resource van het kaartaccount om misbruik van rendering te beperken en het SAS-token regelmatig te vernieuwen.

Type: apiKey
In: header

Voorbeelden

List all previously registered data registries

Voorbeeldaanvraag

HTTP

GET https://us.atlas.microsoft.com/dataRegistries?api-version=2023-06-01

Voorbeeldrespons

Statuscode:: 200

{
  "value": [
    {
      "udid": "f6495f62-94f8-0ec2-c252-45626f82fcb2",
      "description": "Contoso Indoor Design",
      "kind": "AzureBlob",
      "azureBlob": {
        "dataFormat": "zip",
        "msiClientId": "3263cad5-ed8b-4829-b72b-3d1ba556e373",
        "linkedResource": "my-storage-account",
        "blobUrl": "https://mystorageaccount.blob.core.windows.net/my-container/my/blob/path1.zip",
        "sizeInBytes": 29920,
        "contentMD5": "CsFxZ2YSfxw3cRPlqokV0w=="
      },
      "status": "Completed"
    },
    {
      "udid": "8b1288fa-1958-4a2b-b68e-13a7i5af7d7c",
      "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/path2.geojson",
        "sizeInBytes": 1339
      },
      "status": "Running"
    },
    {
      "udid": "7c1288fa-2058-4a1b-b68f-13a6h5af7d7c",
      "description": "Contoso Geofence GeoJSON",
      "kind": "AzureBlob",
      "azureBlob": {
        "dataFormat": "geojson",
        "linkedResource": "my-storage-account",
        "blobUrl": "https://mystorageaccount.blob.core.windows.net/my-container/my/blob/path3.geojson",
        "sizeInBytes": 1650,
        "contentMD5": "rYpEfIeLbWZPyaICGEGy3A=="
      },
      "status": "Failed",
      "error": {
        "code": "ContentMD5Mismatch",
        "message": "Actual content MD5: sOJMJvFParkSxBsvvrPOMQ== doesn't match expected content MD5: CsFxZ2YSfxw3cRPlqokV0w==."
      }
    }
  ]
}

Definities

Name	Description
AzureBlob	Registerdetails van Azure Blob-gegevens.
DataFormat	De gegevensindeling van de geüploade inhoud die wordt gebruikt voor validatiedoeleinden.
DataRegistry	Het gegevensregister in Azure Maps.
DataRegistryKind	Soort gegevensregister.
DataRegistryList	Het antwoordmodel voor de lijst-API van het gegevensregister. Retourneert een lijst met alle eerder geregistreerde gegevens.
LongRunningOperationStatus	De status van een langlopende bewerking.
MapsErrorDetail	De foutdetails.
MapsErrorResponse	Veelvoorkomende foutreacties voor Azure Maps-API's om foutdetails te retourneren voor mislukte bewerkingen.
MapsInnerError	Een object met specifiekere informatie dan het huidige object over de fout.

AzureBlob

Registerdetails van Azure Blob-gegevens.

Name	Type	Description
blobUrl	string	De blob-URL bevat het pad naar het bestand dat wordt geregistreerd.
contentMD5	string	De inhouds-MD5 van de inhoud, die wordt gebruikt voor gegevensvalidatie.
dataFormat	DataFormat	De gegevensindeling van de geüploade inhoud die wordt gebruikt voor validatiedoeleinden.
linkedResource	string	De id van het gegevensarchief in het Azure Maps-account.
msiClientId	string	Client-id van door de gebruiker toegewezen beheerde identiteit. Gebruik door het systeem toegewezen beheerde identiteit als deze niet is opgegeven.
sizeInBytes	integer	De grootte van de inhoud in bytes.

DataFormat

De gegevensindeling van de geüploade inhoud die wordt gebruikt voor validatiedoeleinden.

Name	Type	Description
geojson	string	GeoJSON is een indeling voor georuimtelijke gegevensuitwisseling op basis van JSON.
zip	string	Gecomprimeerde gegevensindeling.

DataRegistry

Het gegevensregister in Azure Maps.

Name	Type	Description
azureBlob	AzureBlob	Registerdetails van Azure Blob-gegevens.
description	string	De beschrijving van het gegevensregister. De maximale lengte is 1024 tekens.
error	MapsErrorDetail	De foutdetails.
kind	DataRegistryKind	Soort gegevensregister.
status	LongRunningOperationStatus	De status van een langlopende bewerking.
udid	string	De gebruikersgegevens-id voor het gegevensregister.

DataRegistryKind

Soort gegevensregister.

Name	Type	Description
AzureBlob	string	Azure Blob