Delen via


Data Registry - List

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

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.

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

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

Voorbeeldrespons

{
  "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

DataRegistryList

Het antwoordmodel voor de lijst-API van het gegevensregister. Retourneert een lijst met alle eerder geregistreerde gegevens.

Name Type Description
nextLink

string

De URL voor het ophalen van de volgende set gegevensregisters.

value

DataRegistry[]

Een matrix van gegevensregisters.

LongRunningOperationStatus

De status van een langlopende 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 te retourneren voor mislukte bewerkingen.

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.