Data Registry - List

Referensi

Layanan:: Maps

Versi API:: 2023-06-01

Gunakan untuk mendapatkan daftar semua registri data di akun Azure Maps.

List API adalah permintaan HTTP GET yang mengembalikan array yang berisi semua registri data yang sebelumnya terdaftar menggunakan REGISTER atau Replace API.

Titik akhir layanan registri data dibatasi dalam cakupan ke wilayah akun Azure Maps Anda dan tidak tersedia untuk akun Azure Maps global.

Kirim Permintaan Daftar

Untuk mencantumkan semua registri data Anda, terbitkan GET permintaan tanpa parameter tambahan.

Respons Daftar

Permintaan List mengembalikan array registri data dalam JSON format dalam isi respons.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
geography	path	True	string	Parameter ini menentukan tempat Akun Azure Maps berada. Nilai yang valid adalah kita (US Timur, US Tengah Barat, AS Barat 2) dan Eropa (Eropa Utara, Eropa Barat).
api-version	query	True	string	Nomor versi Azure Maps API.

Header Permintaan

Nama	Diperlukan	Jenis	Deskripsi
x-ms-client-id		string	Menentukan akun mana yang ditujukan untuk penggunaan bersama dengan model keamanan ID Microsoft Entra. Ini mewakili ID unik untuk akun Azure Maps dan dapat diambil dari API Akun bidang manajemen Azure Maps. Untuk menggunakan keamanan ID Microsoft Entra di Azure Maps, lihat artikel berikut ini untuk panduan.

Respons

Nama Jenis Deskripsi

200 OK

Nama	Jenis	Deskripsi
200 OK	DataRegistryList	Permintaan `List` berhasil diselesaikan. Isi respons berisi array registri data.
Other Status Codes	MapsErrorResponse	Terjadi kesalahan tak terduga. Header x-ms-error-code: string

DataRegistryList

Permintaan List berhasil diselesaikan. Isi respons berisi array registri data.

Other Status Codes

MapsErrorResponse

Terjadi kesalahan tak terduga.

Header

x-ms-error-code: string

Keamanan

AADToken

Ini adalah Alur Microsoft Entra OAuth 2.0 . Saat dipasangkan dengan kontrol akses berbasis peran Azure , kontrol akses tersebut dapat digunakan untuk mengontrol akses ke REST API Azure Maps. Kontrol akses berbasis peran Azure digunakan untuk menunjuk akses ke satu atau beberapa akun sumber daya atau sub-sumber daya Azure Maps. Setiap pengguna, grup, atau perwakilan layanan dapat diberikan akses melalui peran bawaan atau peran kustom yang terdiri dari satu atau beberapa izin ke REST API Azure Maps.

Untuk menerapkan skenario, sebaiknya lihat konsep autentikasi. Singkatnya, definisi keamanan ini menyediakan solusi untuk memodelkan aplikasi melalui objek yang mampu mengontrol akses pada API dan cakupan tertentu.

Catatan

Definisi keamanan ini memerlukan penggunaan x-ms-client-id header untuk menunjukkan sumber daya Azure Maps mana yang meminta akses aplikasi. Ini dapat diperoleh dari API manajemen Maps.

Authorization URL khusus untuk instans cloud publik Azure. Sovereign cloud memiliki URL Otorisasi yang unik dan konfigurasi ID Microsoft Entra. * Kontrol akses berbasis peran Azure dikonfigurasi dari bidang manajemen Azure melalui portal Microsoft Azure, PowerShell, CLI, Azure SDK, atau REST API. * Penggunaan Azure Maps Web SDK memungkinkan penyiapan aplikasi berbasis konfigurasi untuk beberapa kasus penggunaan.

Untuk informasi selengkapnya tentang platform identitas Microsoft, lihat Gambaran umum platform identitas Microsoft.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
https://atlas.microsoft.com/.default	https://atlas.microsoft.com/.default

subscription-key

Ini adalah kunci bersama yang disediakan saat membuat sumber daya Azure Maps melalui bidang manajemen Azure melalui portal Microsoft Azure, PowerShell, CLI, Azure SDK, atau REST API.

Dengan kunci ini, aplikasi apa pun berwenang untuk mengakses semua REST API. Dengan kata lain, ini saat ini dapat diperlakukan sebagai kunci master ke akun tempat kunci tersebut dikeluarkan.

Untuk aplikasi yang diekspos secara publik, rekomendasi kami adalah menggunakan akses server-ke-server dari REST API Azure Maps tempat kunci ini dapat disimpan dengan aman.

Jenis: apiKey
Dalam: header

SAS Token

Ini adalah token tanda tangan akses bersama dibuat dari operasi Daftar SAS pada sumber daya Azure Maps melalui bidang manajemen Azure melalui portal Microsoft Azure, PowerShell, CLI, Azure SDK, atau REST API.

Dengan token ini, aplikasi apa pun berwenang untuk mengakses dengan kontrol akses berbasis peran Azure dan kontrol halus ke kedaluwarsa, laju, dan wilayah penggunaan untuk token tertentu. Dengan kata lain, Token SAS dapat digunakan untuk memungkinkan aplikasi mengontrol akses dengan cara yang lebih aman daripada kunci bersama.

Untuk aplikasi yang diekspos secara publik, rekomendasi kami adalah mengonfigurasi daftar asal tertentu yang diizinkan di sumber daya akun Peta untuk membatasi penyalahgunaan penyalahgunaan dan memperbarui Token SAS secara teratur.

Jenis: apiKey
Dalam: header

Contoh

List all previously registered data registries

Permintaan sampel

HTTP

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

Respon sampel

Kode status:: 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==."
      }
    }
  ]
}

Definisi

Nama	Deskripsi
AzureBlob	Detail registri data blob Azure.
DataFormat	Format data konten yang diunggah yang digunakan untuk tujuan validasi.
DataRegistry	Registri data di Azure Maps.
DataRegistryKind	Jenis registri data.
DataRegistryList	Model respons untuk API Daftar registri data. Mengembalikan daftar semua data yang terdaftar sebelumnya.
LongRunningOperationStatus	Status operasi yang berjalan lama.
MapsErrorDetail	Detail kesalahan.
MapsErrorResponse	Respons kesalahan umum untuk API Azure Maps untuk mengembalikan detail kesalahan untuk operasi yang gagal.
MapsInnerError	Objek yang berisi informasi yang lebih spesifik daripada objek saat ini tentang kesalahan.

AzureBlob

Detail registri data blob Azure.

Nama	Jenis	Deskripsi
blobUrl	string	URL blob berisi jalur ke file yang sedang didaftarkan.
contentMD5	string	Konten MD5 dari konten, digunakan untuk validasi data.
dataFormat	DataFormat	Format data konten yang diunggah yang digunakan untuk tujuan validasi.
linkedResource	string	ID datastore di akun Azure Maps.
msiClientId	string	ID klien identitas terkelola yang ditetapkan pengguna. Gunakan identitas terkelola yang ditetapkan sistem jika tidak disediakan.
sizeInBytes	integer	Ukuran konten dalam byte.

DataFormat

Format data konten yang diunggah yang digunakan untuk tujuan validasi.

Nama	Jenis	Deskripsi
geojson	string	GeoJSON adalah format pertukaran data geospasial berbasis JSON.
zip	string	Format data terkompresi.

DataRegistry

Registri data di Azure Maps.

Nama	Jenis	Deskripsi
azureBlob	AzureBlob	Detail registri data blob Azure.
description	string	Deskripsi yang diberikan ke registri data. Panjang maksimum adalah 1024 karakter.
error	MapsErrorDetail	Detail kesalahan.
kind	DataRegistryKind	Jenis registri data.
status	LongRunningOperationStatus	Status operasi yang berjalan lama.
udid	string	ID data pengguna untuk registri data.

DataRegistryKind

Jenis registri data.

Nama	Jenis	Deskripsi
AzureBlob	string	Azure Blob