Namespaces - Migrate

Layanan:: Device Registry

Versi API:: 2026-04-01

Memigrasikan sumber daya ke Namespace

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DeviceRegistry/namespaces/{namespaceName}/migrate?api-version=2026-04-01

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
namespaceName	path	True	string minLength: 3 maxLength: 64 pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$	Nama namespace layanan.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil.
subscriptionId	path	True	string (uuid)	ID langganan target. Nilainya harus sebuah UUID.
api-version	query	True	string minLength: 1	Versi API yang digunakan untuk operasi ini.

Isi Permintaan

Nama	Jenis	Deskripsi
resourceIds	string[]	Daftar sumber daya aset yang akan dimigrasikan.
scope	Scope	Cakupan operasi migrasi sumber daya.

Respons

Nama	Jenis	Deskripsi
200 OK	NamespaceMigrateResponse	Operasi Azure berhasil diselesaikan.
202 Accepted		Operasi sumber daya diterima. Header Azure-AsyncOperation: string Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Respons kesalahan tak terduga.

Nama

Jenis

Deskripsi

200 OK

NamespaceMigrateResponse

Operasi Azure berhasil diselesaikan.

202 Accepted

Operasi sumber daya diterima.

Header

Azure-AsyncOperation: string
Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Respons kesalahan tak terduga.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

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

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

Namespace Migrate

Permintaan sampel

HTTP

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.DeviceRegistry/namespaces/my-namespace-1/migrate?api-version=2026-04-01

{
  "scope": "Resources",
  "resourceIds": [
    "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.DeviceRegistry/assets/my-asset-1",
    "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.DeviceRegistry/assets/my-asset-2",
    "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.DeviceRegistry/assets/my-asset-3"
  ]
}

Respon sampel

Kode status:: 200

{
  "migrateResults": [
    {
      "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.DeviceRegistry/assets/my-asset-1",
      "result": "Succeeded"
    },
    {
      "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.DeviceRegistry/assets/my-asset-2",
      "result": "Succeeded"
    },
    {
      "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.DeviceRegistry/assets/my-asset-3",
      "result": "Failed",
      "error": {
        "code": "ResourceNotFound",
        "message": "The resource was not found."
      }
    }
  ]
}

Kode status:: 202

azure-asyncoperation: https://contoso.com/subscriptions/00000000-0000-0000-0000-000000000000/locations/westus/operationsStatuses/someguid

Definisi

Nama	Deskripsi
Error	Mendefinisikan objek kesalahan dengan properti.
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorDetails	Menentukan properti detail error.
ErrorResponse	Tanggapan kesalahan
MigrateResult	Hasil dari Migrasi operasi sumber daya aset ke sumber daya Namespace.
MigrateResultType	Jenis Hasil Operasi Migrasi.
NamespaceMigrateRequest	Isi permintaan untuk operasi migrasi sumber daya ke sumber daya Namespace.
NamespaceMigrateResponse	Respons untuk operasi migrasi sumber daya aset ke sumber daya Namespace.
Scope	Cakupan operasi migrasi sumber daya.

Error

Objek

Mendefinisikan objek kesalahan dengan properti.

Nama	Jenis	Deskripsi
code	string	Kode kesalahan untuk klasifikasi kesalahan (mis: '400', '404', '500', dll.).
details	ErrorDetails[]	Array detail kesalahan yang menjelaskan status setiap kesalahan.
message	string	Pesan kesalahan bermanfaat yang dapat dibaca manusia untuk memberikan konteks tambahan untuk kesalahan (misalnya: "ID Kemampuan 'foo' tidak ada").

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Detail kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

ErrorDetails

Objek

Menentukan properti detail error.

Nama	Jenis	Deskripsi
code	string	Kode kesalahan multi-bagian untuk klasifikasi dan akar penyebab kesalahan (mis: 400.200.100.432).
correlationId	string	Pengidentifikasi unik untuk transaksi untuk membantu penelusuran kesalahan.
info	string	Konteks teks terperinci yang dapat dibaca manusia untuk debugging (mis: "Mekanisme berikut didukung...").
message	string	Pesan kesalahan bermanfaat yang dapat dibaca manusia untuk memberikan konteks tambahan untuk kesalahan (mis: "Metode autentikasi tidak didukung").

ErrorResponse

Objek

Tanggapan kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

MigrateResult

Objek

Hasil dari Migrasi operasi sumber daya aset ke sumber daya Namespace.

Nama	Jenis	Deskripsi
error	Error	Kesalahan jika operasi migrasi tidak berhasil.
resourceId	string	Id sumber daya sumber daya aset.
result	MigrateResultType	Hasil dari operasi migrasi.

MigrateResultType

Enumerasi

Jenis Hasil Operasi Migrasi.

Nilai	Deskripsi
Succeeded	Operasi Migrasi Sumber Daya berhasil.
Failed	Operasi Migrasi Sumber Daya tidak berhasil.

NamespaceMigrateRequest

Objek

Isi permintaan untuk operasi migrasi sumber daya ke sumber daya Namespace.

Nama	Jenis	Deskripsi
resourceIds	string[]	Daftar sumber daya aset yang akan dimigrasikan.
scope	Scope	Cakupan operasi migrasi sumber daya.

NamespaceMigrateResponse

Objek

Respons untuk operasi migrasi sumber daya aset ke sumber daya Namespace.

Nama	Jenis	Deskripsi
migrateResults	MigrateResult[]	Daftar hasil migrasi yang berisi hasil setiap operasi migrasi aset.

Scope

Enumerasi

Cakupan operasi migrasi sumber daya.

Nilai	Deskripsi
Resources	Menjangkau migrasi ke resourceIds yang disediakan