Data Registry - Get Data Registry

Referentie

Service:: Maps

API Version:: 2023-06-01

Gebruik om de opgegeven gegevensregistergegevens op te halen.

De Get Data Registry API is een HTTP-aanvraag GET die gegevensregistergegevens retourneert, als een AzureBlob-object in JSON-indeling, in de hoofdtekst van het antwoord, samen met de HTTP-statuscode 200, wanneer dit is gelukt. Als Azure Maps geen toegang heeft tot de onderliggende inhoud of als de integriteitscontrole mislukt, wordt de status ingesteld op Failed en wordt er een fout geretourneerd.

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.

Registeraanvraag voor gegevens ophalen indienen

Een gegevensregisteraanvraag GET retourneert details van het aangevraagde gegevensregister, zoals bepaald door de opgegeven udid. De details worden geretourneerd in de hoofdtekst van het antwoord in JSON-indeling.

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

URI-parameters

Name In Vereist Type Description

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).
udid	path	True	string	De gebruikersgegevens-id van het gegevensregister. Regex pattern: `^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$`
api-version	query	True	string	Het versienummer van Azure Maps API.

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).

udid

path

True

string

De gebruikersgegevens-id van het gegevensregister.

Regex pattern: ^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$

api-version

query

True

string

Het versienummer van 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 raadpleegt u de volgende artikelen voor hulp.

Antwoorden

Name Type Description

200 OK

Name	Type	Description
200 OK	DataRegistry	De `Get Data Registry` aanvraag is voltooid. De antwoordtekst bevat het gegevensregister van de opgegeven `udid`.
Other Status Codes	MapsErrorResponse	Er is een onverwachte fout opgetreden. Headers x-ms-error-code: string

DataRegistry

De Get Data Registry aanvraag is voltooid. De antwoordtekst bevat het gegevensregister van de opgegeven udid.

Other Status Codes

MapsErrorResponse

Er is een onverwachte fout opgetreden.

Headers

x-ms-error-code: string

Beveiliging

AADToken

Dit zijn de Microsoft Entra OAuth 2.0-stromen. In combinatie 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 resourceaccount 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.

Als u scenario's wilt implementeren, raden we u aan om 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

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

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 configuratie van een toepassing mogelijk voor meerdere gebruiksscenario's.

Zie Microsoft identity platform overzicht voor meer informatie over 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

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 wordt 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 beschikbaar gemaakte toepassingen wordt aanbevolen om server-naar-servertoegang te gebruiken voor Azure Maps REST API's waar deze sleutel veilig kan worden opgeslagen.

Type: apiKey
In: header

SAS Token

Dit is een shared access signature-token dat wordt 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 over het verloop, de snelheid en de 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 oorsprongen te configureren op de resource Van het account toewijzen om misbruik van het genereren te beperken en het SAS-token regelmatig te vernieuwen.

Type: apiKey
In: header

Voorbeelden

Get the data registry of a completed udid

Get the data registry of a failed udid

Get the data registry of a completed udid

Sample Request

HTTP

GET https://us.atlas.microsoft.com/dataRegistries/0522b4fe-0539-4c6c-ba70-e35ec865d8e2?api-version=2023-06-01

Sample Response

Status code:: 200

{
  "udid": "0522b4fe-0539-4c6c-ba70-e35ec865d8e2",
  "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,
    "contentMD5": "sOJMJvFParkSxBsvvrPOMQ=="
  },
  "status": "Completed"
}

Get the data registry of a failed udid

Sample Request

HTTP

GET https://us.atlas.microsoft.com/dataRegistries/0522b4fe-0539-4c6c-ba70-e35ec865d8e2?api-version=2023-06-01

Sample Response

Status code:: 200

{
  "udid": "0522b4fe-0539-4c6c-ba70-e35ec865d8e2",
  "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"
  },
  "status": "Failed",
  "error": {
    "code": "AuthorizationPermissionMismatch",
    "message": "Not authorized to perform this operation on resource: https://mystorageaccount.blob.core.windows.net/my-container/my/blob/path.json."
  }
}

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.
LongRunningOperationStatus	De status van een langdurige bewerking.
MapsErrorDetail	De foutdetails.
MapsErrorResponse	Veelvoorkomende foutreacties voor Azure Maps API's om foutdetails voor mislukte bewerkingen te retourneren.
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 inhoud 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 langdurige bewerking.
udid	string	De gebruikersgegevens-id voor het gegevensregister.

DataRegistryKind

Soort gegevensregister.

Name	Type	Description
AzureBlob	string	Azure Blob

LongRunningOperationStatus

De status van een langdurige bewerking.

Name	Type	Description
Completed	string	De aanvraag is voltooid.
Failed	string	De aanvraag heeft een of meer fouten.
Running	string	De aanvraag wordt momenteel verwerkt.

MapsErrorDetail

De foutdetails.

Name	Type	Description
code	string	Een van een door de server gedefinieerde set foutcodes.
details	MapsErrorDetail[]	Een matrix met details over specifieke fouten die tot deze gerapporteerde fout hebben geleid.
innererror	MapsInnerError	Een object met specifiekere informatie dan het huidige object over de fout.
message	string	Een door mensen leesbare weergave van de fout.
target	string	Het doel van de fout.

MapsErrorResponse

Veelvoorkomende foutreacties voor Azure Maps API's om foutdetails voor mislukte bewerkingen te retourneren.

Name	Type	Description
error	MapsErrorDetail	De foutdetails.

MapsInnerError

Een object met specifiekere informatie dan het huidige object over de fout.

Name	Type	Description
code	string	De foutcode.
innererror	MapsInnerError	Een object met specifiekere informatie dan het huidige object over de fout.

Share via

Data Registry - Get Data Registry

Registeraanvraag voor gegevens ophalen indienen

URI-parameters

Aanvraagkoptekst

Antwoorden

Beveiliging

AADToken

Notities

Scopes

subscription-key

SAS Token

Voorbeelden

Get the data registry of a completed udid

Sample Request

Sample Response

Get the data registry of a failed udid

Sample Request

Sample Response

Definities

AzureBlob

DataFormat

DataRegistry

DataRegistryKind

LongRunningOperationStatus

MapsErrorDetail

MapsErrorResponse

MapsInnerError

Aanvullende resources