Bagikan melalui

Mendaftarkan penyewa untuk pelacakan penggunaan di Azure Stack Hub

  • Artikel

Artikel ini berisi rincian tentang operasi pendaftaran. Anda dapat menggunakan operasi ini untuk:

  • Mengelola pendaftaran penyewa.
  • Mengelola pelacakan penggunaan penyewa.

Menambahkan penyewa ke pendaftaran

Anda dapat menggunakan operasi ini saat ingin menambahkan penyewa baru ke pendaftaran. Penggunaan penyewa dilaporkan di bawah langganan Azure yang tersambung dengan penyewa Microsoft Entra.

Anda juga dapat menggunakan operasi ini untuk mengubah langganan yang terkait dengan penyewa. Hubungi PUT atau cmdlet PowerShell New-AzResource untuk menimpa pemetaan sebelumnya. Jika Anda menggunakan modul AzureRM PowerShell, gunakan cmdlet PowerShell New-AzureRMResource.

Anda dapat mengaitkan satu langganan Azure dengan satu penyewa. Jika Anda mencoba menambahkan langganan kedua ke penyewa yang sudah ada, langganan pertama akan ditimpa.

Menggunakan profil API

Cmdlet pendaftaran berikut mengharuskan Anda menentukan profil API saat menjalankan PowerShell. Profil API mewakili sekumpulan penyedia sumber Azure dan versi API-nya. Profil ini membantu Anda menggunakan versi API yang tepat saat berinteraksi dengan beberapa cloud Azure. Misalnya, jika Anda bekerja dengan beberapa cloud saat bekerja dengan Azure dan Azure Stack Hub global, profil API menentukan nama yang cocok dengan tanggal rilisnya. Anda menggunakan profil 2017-09-03.

Untuk informasi selengkapnya tentang Profil Azure Stack Hub dan API, lihat Mengelola profil versi API di Azure Stack Hub.

Parameter

Parameter Deskripsi
registrationSubscriptionID Langganan Azure yang digunakan untuk pendaftaran awal.
customerSubscriptionID Langganan Azure (bukan Azure Stack Hub) milik pelanggan yang akan didaftarkan. Harus dibuat dalam penawaran Penyedia Solusi Cloud (CSP) melalui Pusat Mitra. Jika pelanggan memiliki lebih dari satu penyewa, buat langganan bagi penyewa untuk masuk ke Azure Stack Hub. ID langganan pelanggan peka huruf besar/kecil.
resourceGroup Grup sumber daya di Azure tempat pendaftaran Anda disimpan.
registrationName Nama pendaftaran Azure Stack Hub Anda. Ini adalah objek yang disimpan di Azure. Namanya biasanya dalam bentuk azurestack-CloudID, saat CloudID adalah ID cloud dari penyebaran Azure Stack Hub Anda.

Catatan

Penyewa harus terdaftar dengan setiap penyebaran Azure Stack Hub yang mereka gunakan. Jika penyewa menggunakan lebih dari satu Azure Stack Hub, perbarui pendaftaran awal dari setiap penyebaran dengan langganan penyewa.

PowerShell

Gunakan cmdlet New-AzResource untuk menambahkan penyewa. Sambungkan ke Azure, lalu dari permintaan yang ditingkatkan, jalankan perintah berikut:

New-AzResource -ResourceId "subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}" -ApiVersion 2017-06-01

Panggilan API

Operasi: PUT
RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
Respons: 201 Dibuat
Badan Respons: Kosong

Daftar semua penyewa terdaftar

Dapatkan daftar semua penyewa yang telah ditambahkan ke pendaftaran.

Catatan

Jika tidak ada penyewa yang terdaftar, Anda tidak akan menerima respons.

Parameter

Parameter Deskripsi
registrationSubscriptionID Langganan Azure yang digunakan untuk pendaftaran awal.
resourceGroup Grup sumber daya di Azure tempat pendaftaran Anda disimpan.
registrationName Nama pendaftaran penyebaran Azure Stack Hub Anda. Ini adalah objek yang disimpan di Azure. Nama ini biasanya dalam bentuk azurestack-CloudID, saat CloudID adalah ID cloud dari penyebaran Azure Stack Hub Anda.

PowerShell

Gunakan cmdlet Get-AzResource untuk mencantumkan semua penyewa terdaftar. Sambungkan ke Azure Stack Hub, lalu dari permintaan yang ditingkatkan, jalankan cmdlet berikut:

Get-AzResource -ResourceId "subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions" -ApiVersion 2017-06-01

Panggilan API

Anda bisa mendapatkan daftar semua pemetaan penyewa menggunakan operasi GET.

Operasi: GET
RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions?api-version=2017-06-01 HTTP/1.1
Respons: 200
Isi Respons:

{
    "value": [{
            "id": " subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{ cspSubscriptionId 1}",
            "name": " cspSubscriptionId 1",
            "type": "Microsoft.AzureStack\customerSubscriptions",
            "properties": { "tenantId": "tId1" }
        },
        {
            "id": " subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{ cspSubscriptionId 2}",
            "name": " cspSubscriptionId2 ",
            "type": "Microsoft.AzureStack\customerSubscriptions",
            "properties": { "tenantId": "tId2" }
        }
    ],
    "nextLink": "{originalRequestUrl}?$skipToken={opaqueString}"
}

Menghapus pemetaan penyewa

Anda dapat menghapus penyewa yang telah ditambahkan ke pendaftaran. Jika penyewa tersebut masih menggunakan sumber daya di Azure Stack Hub, penggunaannya dibebankan ke langganan yang digunakan dalam pendaftaran Azure Stack Hub awal.

Parameter

Parameter Deskripsi
registrationSubscriptionID ID langganan untuk pendaftaran.
resourceGroup Grup sumber daya untuk pendaftaran.
registrationName Nama pendaftaran.
customerSubscriptionId ID langganan pelanggan. ID langganan pelanggan peka huruf besar/kecil.

PowerShell

Gunakan cmdlet Remove-AzResource untuk menghapus penyewa. Sambungkan ke Azure Stack Hub, lalu dari permintaan yang ditingkatkan, jalankan cmdlet berikut:

Remove-AzResource -ResourceId "subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}" -ApiVersion 2017-06-01

Panggilan API

Anda dapat menghapus pemetaan penyewa menggunakan operasi DELETE.

Operasi: DELETE
RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
Respons: 204 Tidak Ada Konten
Badan Respons: Kosong

Langkah berikutnya