Mulai Cepat: Membuat dan mengelola sumber daya Communication Services

Mulai dengan Azure Communication Services dengan menyediakan sumber daya Communication Services pertama Anda. Sumber daya Communication Services dapat diprovisikan melalui portal Azure atau dengan SDK manajemen .NET. SDK manajemen dan portal Azure memungkinkan Anda membuat, mengonfigurasi, memperbarui, dan menghapus sumber daya dan antarmuka Anda dengan Azure Resource Manager, layanan penyebaran dan manajemen Azure. Semua fungsi yang tersedia di SDK tersedia di portal Azure.

Peringatan

Perhatikan bahwa tidak dimungkinkan untuk membuat grup sumber daya secara bersamaan sebagai sumber daya untuk Azure Communication Services. Saat membuat sumber daya, grup sumber daya yang telah dibuat, harus digunakan.

Prasyarat

• Akun Azure dengan langganan aktif. Buat akun secara gratis.

Perhatikan bahwa jika Anda berencana menggunakan nomor telepon, Anda tidak dapat menggunakan akun uji coba gratis. Periksa apakah langganan Anda memenuhi semua persyaratan jika Anda berencana untuk membeli nomor telepon sebelum membuat sumber daya Anda.

Membuat sumber daya Azure Communication Services

Untuk membuat sumber daya Azure Communication Services, pertama-tama masuk ke portal Microsoft Azure. Di sudut kiri atas halaman, pilih + Buat sumber daya.

Masukkan Komunikasi ke dalam input Cari Marketplace atau bilah pencarian di bagian atas portal.

Pilih Communication Services dalam hasil, lalu pilih Buat.

Kini Anda dapat mengonfigurasi sumber daya Communication Services. Pada halaman pertama dalam proses pembuatan, Anda akan diminta untuk menentukan:

• Langganan
• Grup sumber daya (Anda dapat membuat yang baru atau memilih grup sumber daya yang sudah ada)
• Nama sumber daya Communication Services
• Geografi yang akan dikaitkan dengan sumber daya

Pada langkah berikutnya, Anda dapat menetapkan tag ke sumber daya. Tag dapat digunakan untuk mengelola sumber daya Azure Anda. Lihat dokumentasi pemberian tag sumber daya untuk mengetahui informasi selengkapnya mengenai tag.

Terakhir, Anda dapat meninjau konfigurasi dan Membuat sumber daya. Perhatikan bahwa penyebaran akan memakan waktu beberapa menit untuk diselesaikan.

Mengelola sumber daya Communication Services Anda

Untuk mengelola sumber daya Communication Services Anda, buka portal Microsoft Azure, dan cari dan pilih Azure Communication Services.

Pada halaman Communication Services, pilih nama sumber daya Anda.

Halaman Gambaran Umum untuk sumber daya Anda berisi opsi untuk manajemen dasar seperti telusuri, hentikan, mulai, mulai ulang, dan hapus. Anda dapat menemukan opsi konfigurasi lainnya di menu kiri halaman sumber daya Anda.

Prasyarat

• Akun Azure dengan langganan aktif. Buat akun secara gratis.
• Memasang Azure CLI

Jika Anda berencana menggunakan nomor telepon, Anda tidak dapat menggunakan akun uji coba gratis. Periksa apakah langganan Anda memenuhi semua persyaratan jika Anda berencana untuk membeli nomor telepon sebelum membuat sumber daya Anda.

Membuat sumber daya Azure Communication Services

Untuk membuat sumber daya Azure Communication Services, masuk ke Azure CLI. Anda dapat masuk menjalankan az login perintah dari terminal dan memberikan kredensial Anda. Jalankan perintah berikut untuk membuat sumber daya:

az communication create --name "<acsResourceName>" --location "Global" --data-location "United States" --resource-group "<resourceGroup>"

Jika Anda ingin memilih langganan tertentu, Anda juga dapat menentukan --subscription bendera dan memberikan ID langganan.

az communication create --name "<acsResourceName>" --location "Global" --data-location "United States" --resource-group "<resourceGroup> --subscription "<subscriptionId>"

Anda bisa mengonfigurasi sumber daya Communication Services Anda dengan opsi berikut:

• Grup sumber daya
• Nama sumber daya Communication Services
• Geografi yang akan dikaitkan dengan sumber daya

Pada langkah berikutnya, Anda dapat menetapkan tag ke sumber daya. Tag dapat digunakan untuk mengelola sumber daya Azure Anda. Untuk informasi selengkapnya tentang tag, lihat dokumentasi pemberian tag sumber daya.

Mengelola sumber daya Communication Services Anda

Untuk menambahkan tag ke sumber daya Communication Services Anda, jalankan perintah berikut. Anda juga dapat menargetkan langganan tertentu.

az communication update --name "<communicationName>" --tags newTag="newVal1" --resource-group "<resourceGroup>"

az communication update --name "<communicationName>" --tags newTag="newVal2" --resource-group "<resourceGroup>" --subscription "<subscriptionId>"

az communication show --name "<communicationName>" --resource-group "<resourceGroup>"

az communication show --name "<communicationName>" --resource-group "<resourceGroup>" --subscription "<subscriptionId>"

Untuk informasi tentang perintah lain, lihat Azure Communication CLI.

Prasyarat

• Akun Azure dengan langganan aktif. Buat akun secara gratis.
• Versi terbaru .NET Core SDK untuk sistem operasi Anda.
• Dapatkan versi terbaru dari .NET Identity SDK.
• Dapatkan versi terbaru dari .NET Management SDK.

Perhatikan bahwa jika Anda berencana menggunakan nomor telepon, Anda tidak dapat menggunakan akun uji coba gratis. Periksa apakah langganan Anda memenuhi semua persyaratan jika Anda berencana untuk membeli nomor telepon sebelum membuat sumber daya Anda.

Menginstal SDK

Pertama, sertakan SDK Manajemen Communication Services dalam proyek C# Anda:

using Azure.ResourceManager.Communication;

ID Langganan

Anda harus mengetahui ID langganan Azure Anda. Ini dapat diperoleh dari portal:

1. Masuk ke akun Azure Anda
2. Pilih Langganan di bilah sisi kiri
3. Pilih langganan mana yang diperlukan
4. Klik Gambaran Umum
5. Pilih ID Langganan Anda

Dalam mulai cepat ini, kami akan menganggap bahwa Anda telah menyimpan ID langganan dalam variabel lingkungan yang disebut AZURE_SUBSCRIPTION_ID.

Autentikasi

Untuk berkomunikasi dengan Azure Communication Services, Anda harus terlebih dahulu mengautentikasi diri Anda ke Azure. Anda biasanya akan melakukan ini menggunakan identitas perwakilan layanan.

Opsi 1: Identitas Terkelola

Jika kode Anda berjalan sebagai layanan di Azure, cara termudah untuk mengautentikasi adalah dengan memperoleh identitas terkelola dari Azure. Pelajari selengkapnya tentang identitas terkelola.

Layanan Azure yang mendukung Identitas Terkelola

Cara menggunakan identitas terkelola untuk App Service dan Azure Functions

Identitas Terkelola yang ditetapkan sistem

using Azure.Identity;
using Azure.ResourceManager.Communication;
using Azure.ResourceManager.Communication.Models;
using System;
...
var subscriptionId = "AZURE_SUBSCRIPTION_ID";
var acsClient = new CommunicationManagementClient(subscriptionId, new ManagedIdentityCredential());

Identitas Terkelola yang Ditetapkan Pengguna

ClientId identitas terkelola yang Anda buat harus diteruskan ke ManagedIdentityCredential secara eksplisit.

using Azure.Identity;
using Azure.ResourceManager.Communication;
using Azure.ResourceManager.Communication.Models;
using System;
...
var subscriptionId = "AZURE_SUBSCRIPTION_ID";
var managedIdentityCredential = new ManagedIdentityCredential("AZURE_CLIENT_ID");
var acsClient = new CommunicationManagementClient(subscriptionId, managedIdentityCredential);

Opsi 2: Perwakilan Layanan

Sebagai ganti dari menggunakan identitas terkelola, Anda mungkin ingin mengautentikasi ke Azure menggunakan perwakilan layanan yang Anda kelola sendiri. Pelajari selengkapnya menggunakan dokumentasi tentang membuat dan mengelola perwakilan layanan di ID Microsoft Entra.

Setelah membuat perwakilan layanan, Anda harus mengumpulkan informasi berikut tentangnya dari portal Azure:

• ID klien
• Rahasia Klien
• ID Penyewa

Simpan nilai-nilai ini dalam variabel lingkungan masing-masing bernama AZURE_CLIENT_ID, AZURE_CLIENT_SECRET, dan AZURE_TENANT_ID. Anda kemudian dapat membuat klien manajemen Communication Services seperti ini:

using Azure.Identity;
using Azure.ResourceManager.Communication;
using Azure.ResourceManager.Communication.Models;
using System;
...
var subscriptionId = Environment.GetEnvironmentVariable("AZURE_SUBSCRIPTION_ID");
var acsClient = new CommunicationManagementClient(subscriptionId, new EnvironmentCredential());

Opsi 3: Identitas Pengguna

Jika Anda ingin memanggil Azure atas nama pengguna interaktif, daripada menggunakan identitas layanan, Anda dapat menggunakan kode berikut untuk membuat klien Manajemen Azure Communication Services Azure. Ini akan membuka jendela browser untuk meminta kredensial MSA atau Microsoft Entra mereka kepada pengguna.

using Azure.Identity;
using Azure.ResourceManager.Communication;
using Azure.ResourceManager.Communication.Models;
using System;
...
var subscriptionId = Environment.GetEnvironmentVariable("AZURE_SUBSCRIPTION_ID");
var communicationServiceClient = new CommunicationManagementClient(subscriptionId, new InteractiveBrowserCredential());

Mengelola Sumber Daya Communication Services

Berinteraksi dengan sumber daya Azure

Setelah diautentikasi, Anda dapat menggunakan klien manajemen untuk melakukan panggilan API.

Untuk setiap contoh berikut, kita akan menetapkan sumber daya Communication Services ke grup sumber daya yang ada.

Jika Anda perlu membuat grup sumber daya, Anda dapat melakukannya dengan menggunakan portal Azure atau Azure Resource Manager SDK.

Membuat dan mengelola sumber daya Communication Services

Instans dari klien SDK Manajemen Communication Services (Azure.ResourceManager.Communication.CommunicationManagementClient) dapat digunakan untuk melakukan operasi pada sumber daya Communication Services.

Membuat sumber daya Communication Services

Saat membuat sumber daya Communication Services, Anda akan menentukan nama grup sumber daya dan nama sumber daya. Perhatikan bahwa properti Location akan selalu global, dan selama pratinjau publik, nilai DataLocation harus UnitedStates.

var resourceGroupName = "myResourceGroupName";
var resourceName = "myResource";
var resource = new CommunicationServiceResource { Location = "Global", DataLocation = "UnitedStates"  };
var operation = await acsClient.CommunicationService.StartCreateOrUpdateAsync(resourceGroupName, resourceName, resource);
await operation.WaitForCompletionAsync();

Memperbarui sumber daya Communication Services

...
var resourceGroupName = "myResourceGroupName";
var resourceName = "myResource";
var resource = new CommunicationServiceResource { Location = "Global", DataLocation = "UnitedStates" };
resource.Tags.Add("environment","test");
resource.Tags.Add("department","tech");
// Use existing resource name and new resource object
var operation = await acsClient.CommunicationService.StartCreateOrUpdateAsync(resourceGroupName, resourceName, resource);
await operation.WaitForCompletionAsync();

Mencantumkan semua sumber daya Communication Services

var resources = acsClient.CommunicationService.ListBySubscription();
foreach (var resource in resources)
{
    Console.WriteLine(resource.Name);
}

Menghapus sumber daya Communication Services

var resourceGroupName = "myResourceGroupName";
var resourceName = "myResource";
await acsClient.CommunicationService.StartDeleteAsync(resourceGroupName, resourceName);

Mengelola kunci akun dan string koneksi

Setiap sumber daya Communication Services memiliki sepasang kunci akses dan string koneksi yang sesuai. Kunci ini dapat diakses dengan SDK Manajemen lalu digunakan oleh Communication Services SDK lainnya untuk mengautentikasi dirinya ke Azure Communication Services.

Dapatkan kunci akses untuk sumber daya Communication Services

var resourceGroupName = "myResourceGroupName";
var resourceName = "myResource";
var keys = await acsClient.CommunicationService.ListKeysAsync(resourceGroupName, resourceName);

Console.WriteLine(keys.Value.PrimaryConnectionString);
Console.WriteLine(keys.Value.SecondaryConnectionString);

Regenerasi kunci akses untuk sumber daya Communication Services

var resourceGroupName = "myResourceGroupName";
var resourceName = "myResource";
var keyParams = new RegenerateKeyParameters { KeyType = KeyType.Primary };
var keys = await acsClient.CommunicationService.RegenerateKeyAsync(resourceGroupName, resourceName, keyParams);

Console.WriteLine(keys.Value.PrimaryKey);

Prasyarat

• Akun Azure dengan langganan aktif. Buat akun secara gratis.
• Menginstal Modul Azure Az PowerShell

Perhatikan bahwa jika Anda berencana menggunakan nomor telepon, Anda tidak dapat menggunakan akun uji coba gratis. Periksa apakah langganan Anda memenuhi semua persyaratan jika Anda berencana untuk membeli nomor telepon sebelum membuat sumber daya Anda.

Membuat sumber daya Azure Communication Services

Untuk membuat sumber daya Azure Communication Services, masuk ke Azure CLI. Anda dapat melakukan ini melalui terminal menggunakan perintah Connect-AzAccount dan memberikan info masuk Anda.

Pertama, pastikan untuk memasang modul Azure Communication Services Az.Communication menggunakan perintah berikut.

PS C:\> Install-Module Az.Communication

Jalankan perintah berikut untuk membuat sumber daya:

PS C:\> New-AzCommunicationService -ResourceGroupName ContosoResourceProvider1 -Name ContosoAcsResource1 -DataLocation UnitedStates -Location Global

Jika Anda ingin memilih langganan tertentu, Anda juga dapat menentukan bendera --subscription dan memberikan ID langganan.

PS C:\> New-AzCommunicationService -ResourceGroupName ContosoResourceProvider1 -Name ContosoAcsResource1 -DataLocation UnitedStates -Location Global -SubscriptionId SubscriptionID

Anda bisa mengonfigurasi sumber daya Communication Services Anda dengan opsi berikut:

• Grup sumber daya
• Nama sumber daya Communication Services
• Geografi yang akan dikaitkan dengan sumber daya

Pada langkah berikutnya, Anda dapat menetapkan tag ke sumber daya. Tag dapat digunakan untuk mengelola sumber daya Azure Anda. Lihat dokumentasi pemberian tag sumber daya untuk mengetahui informasi selengkapnya mengenai tag.

Mengelola sumber daya Communication Services Anda

Untuk menambahkan tag ke sumber daya Communication Services Anda, jalankan perintah berikut. Anda juga dapat menargetkan langganan tertentu.

PS C:\> Update-AzCommunicationService -Name ContosoAcsResource1 -ResourceGroupName ContosoResourceProvider1 -Tag @{ExampleKey1="ExampleValue1"}

PS C:\> Update-AzCommunicationService -Name ContosoAcsResource1 -ResourceGroupName ContosoResourceProvider1 -Tag @{ExampleKey1="ExampleValue1"} -SubscriptionId SubscriptionID

Untuk mencantumkan semua Sumber Daya Layanan Komunikasi Azure Anda dalam langganan tertentu gunakan perintah berikut ini:

PS C:\> Get-AzCommunicationService -SubscriptionId SubscriptionID

Untuk mencantumkan semua informasi pada sumber daya tertentu, gunakan perintah berikut:

PS C:\> Get-AzCommunicationService -Name ContosoAcsResource1 -ResourceGroupName ContosoResourceProvider1

Mengakses string koneksi dan titik akhir layanan Anda

String koneksi memungkinkan SDK Communication Services untuk menyambungkan dan mengautentikasi ke Azure. Anda dapat mengakses string koneksi Communication Services dan titik akhir layanan dari portal Azure atau secara terprogram dengan API Azure Resource Manager.

Setelah menavigasi ke sumber daya Communication Services Anda, pilih Tombol dari menu navigasi dan salin nilai String koneksi atau Titik akhir untuk penggunaan oleh SDK Communication Services. Anda memiliki akses ke kunci primer dan sekunder. Ini dapat berguna ketika Anda ingin menyediakan akses sementara ke sumber daya Communication Services Anda ke lingkungan pihak ketiga atau penahapan.

Mengakses string koneksi dan titik akhir layanan Anda menggunakan Azure CLI

Anda juga dapat mengakses informasi utama menggunakan Azure CLI, seperti grup sumber daya atau kunci untuk sumber daya tertentu.

Instal Azure CLI dan gunakan perintah berikut untuk masuk. Anda perlu memberikan kredensial Anda untuk terhubung dengan akun Azure Anda.

az login

Sekarang Anda dapat mengakses informasi penting tentang sumber daya Anda.

az communication list --resource-group "<resourceGroup>"

az communication list-key --name "<acsResourceName>" --resource-group "<resourceGroup>"

Jika Anda ingin memilih langganan tertentu, Anda juga dapat menentukan --subscription bendera dan memberikan ID langganan.

az communication list --resource-group  "<resourceGroup>"  --subscription "<subscriptionId>"

az communication list-key --name "<acsResourceName>" --resource-group "<resourceGroup>" --subscription "<subscriptionId>"

Simpan string koneksi Anda

SDK Communication Services menggunakan string koneksi untuk mengotorisasi permintaan yang dibuat ke Communication Services. Anda memiliki beberapa opsi untuk menyimpan string koneksi Anda:

• Aplikasi yang berjalan di desktop atau di perangkat dapat menyimpan string koneksi di file app.config atau web.config. Tambahkan string koneksi ke bagian AppSettings di file-file ini.
• Aplikasi yang berjalan di Azure App Service dapat menyimpan string koneksi di pengaturan aplikasi App Service. Tambahkan string koneksi ke bagian String Koneksi pada tab Pengaturan Aplikasi di dalam portal.
• Anda dapat menyimpan string koneksi di Azure Key Vault.
• Jika Anda menjalankan aplikasi secara lokal, Anda mungkin ingin menyimpan string koneksi Anda dalam variabel lingkungan.

Simpan string koneksi Anda dalam variabel lingkungan

Untuk mengonfigurasi variabel lingkungan, buka jendela konsol dan pilih sistem operasi Anda dari tab di bawah ini. Ganti <yourconnectionstring> dengan string koneksi aktual Anda.

Windows

Buka jendela konsol dan masukkan perintah berikut:

setx COMMUNICATION_SERVICES_CONNECTION_STRING "<yourConnectionString>"

Setelah menambahkan variabel lingkungan, Anda mungkin perlu memulai ulang program yang sedang berjalan yang membaca variabel lingkungan, termasuk jendela konsol. Misalnya, jika Anda menggunakan Visual Studio sebagai editor, mulai ulang Visual Studio sebelum menjalankan contoh.

macOS

Edit .zshrc Anda, dan tambahkan variabel lingkungan:

export COMMUNICATION_SERVICES_CONNECTION_STRING="<yourConnectionString>"

Setelah Anda menambahkan variabel lingkungan, jalankan source ~/.zshrc dari jendela konsol Anda untuk menerapkan perubahan. Jika Anda membuat variabel lingkungan dengan IDE terbuka, Anda mungkin perlu menutup dan membuka kembali editor, IDE, atau shell untuk mengakses variabel.

Linux

Edit .bash_profile Anda, dan tambahkan variabel lingkungan:

export COMMUNICATION_SERVICES_CONNECTION_STRING="<yourConnectionString>"

Setelah Anda menambahkan variabel lingkungan, jalankan source ~/.bash_profile dari jendela konsol Anda untuk menerapkan perubahan. Jika Anda membuat variabel lingkungan dengan IDE terbuka, Anda mungkin perlu menutup dan membuka kembali editor, IDE, atau shell untuk mengakses variabel.

Membersihkan sumber daya

Jika ingin membersihkan dan menghapus langganan Azure Communication Services, Anda bisa menghapus sumber daya atau grup sumber daya. Anda dapat menghapus sumber daya komunikasi dengan menjalankan perintah berikut.

az communication delete --name "acsResourceName" --resource-group "resourceGroup"

Menghapus grup sumber daya juga menghapus sumber daya lain yang terkait dengannya.

Jika Anda memiliki nomor telepon yang ditetapkan ke sumber daya Anda setelah penghapusan sumber daya, nomor telepon secara otomatis dirilis dari sumber daya Anda secara bersamaan.

Catatan

Penghapusan sumber daya bersifat permanen dan tidak ada data, termasuk filter kisi peristiwa, nomor telepon, atau data lain yang terkait dengan sumber daya Anda, dapat dipulihkan jika Anda menghapus sumber daya.

Langkah berikutnya

Dalam panduan mulai cepat ini, Anda telah mempelajari cara:

• Membuat sumber daya Communication Services
• Mengonfigurasi tag dan geografi sumber daya
• Mengakses kunci untuk sumber daya tersebut
• Menghapus sumber daya

Membuat token akses pengguna pertama Anda