Aracılığıyla paylaş

İletişim Hizmetleri kaynağı oluşturma

İlk İletişim Hizmetleri kaynağınızı sağlayarak Azure İletişim Hizmetleri kullanmaya başlayın. İletişim Hizmetleri kaynaklarını Azure portalı üzerinden veya .NET yönetim SDK'sını kullanarak sağlayabilirsiniz. Yönetim SDK'sı ve Azure portalı, dağıtım ve yönetim hizmetini kullanarak kaynaklarınızı ve arabiriminizi oluşturmanızı, yapılandırmanızı, güncelleştirmenizi ve silmenizi sağlar: Azure Resource Manager. SDK'larda kullanılabilen tüm işlevler Azure portalında kullanılabilir.

Uyarı

Azure İletişim Hizmetleri için kaynakla aynı anda bir kaynak grubu oluşturamazsınız. Kaynak oluşturmadan önce bir kaynak grubu oluşturmanız gerekir.

Önkoşullar

Telefon numaralarını kullanmayı planlıyorsanız ücretsiz deneme hesabını kullanamazsınız. Kaynağınızı oluşturmadan önce telefon numaraları satın almayı planlıyorsanız aboneliğinizin tüm gereksinimleri karşılayıp karşılamadığını denetleyin.

Azure portalını kullanarak Azure İletişim Hizmetleri kaynağı oluşturma

Azure İletişim Hizmetleri kaynağı oluşturmak için önce Azure portalında oturum açın. Sayfanın sol üst köşesinde + Kaynak oluştur'u seçin.

Azure portalında Kaynak oluştur düğmesini vurgulayan ekran görüntüsü.

Portalın üst kısmındaki arama çubuğuna veya Marketplace Arama alanına İletişim yazın.

Arama çubuğunda iletişim hizmetleri aramasını gösteren ekran görüntüsü.

Sonuçlarda İletişim Hizmetleri'ni ve ardından Oluştur'u seçin.

İletişim Hizmetleri panelini gösteren ve Oluştur düğmesini vurgulayan ekran görüntüsü.

Artık İletişim Hizmetleri kaynağınızı yapılandırabilirsiniz. Oluşturma işleminin ilk sayfasında şunları belirtmeniz gerekir:

  • Abonelik.
  • Kaynak grubu (yeni bir tane oluşturabilir veya mevcut bir kaynak grubunu seçebilirsiniz).
  • İletişim Hizmetleri kaynağının adı.
  • Kaynakla ilişkili coğrafya.

Sonraki adımda, kaynağa etiket atayabilirsiniz. Azure kaynaklarınızı düzenlemek için etiketleri kullanabilirsiniz. Etiketler hakkında daha fazla bilgi için bkz . Azure kaynaklarınızı ve yönetim hiyerarşinizi düzenlemek için etiketleri kullanma.

Son olarak, yapılandırmanızı gözden geçirin ve kaynağı dağıtmak için Oluştur'a tıklayın. Dağıtımın tamamlanması birkaç dakika sürer.

İletişim Hizmetleri kaynağınızı yönetme

İletişim Hizmetleri kaynağınızı yönetmek için Azure portalında oturum açın ve Azure İletişim Hizmetleri için arama yapın ve seçin.

İletişim Hizmetleri sayfasında kaynağınızın adını seçin.

Kaynağınızın Genel Bakış sayfasında göz atma, durdurma, başlatma, yeniden başlatma ve silme gibi temel yönetim seçenekleri bulunur. Daha fazla yapılandırma seçeneği için kaynak sayfanızın sol menüsüne bakın.

Önkoşullar

Telefon numaralarını kullanmayı planlıyorsanız ücretsiz deneme hesabını kullanamazsınız. Kaynağınızı oluşturmadan önce telefon numaraları satın almayı planlıyorsanız aboneliğinizin tüm gereksinimleri karşılayıp karşılamadığını denetleyin.

Azure CLI kullanarak Azure İletişim Hizmetleri kaynağı oluşturma

Azure İletişim Hizmetleri kaynağı oluşturmak için Azure CLI'da oturum açın. Terminalden komutu çalıştırarak az login oturum açabilir ve kimlik bilgilerinizi sağlayabilirsiniz.

Kaynağı oluşturmak için aşağıdaki komutu çalıştırın:

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

Belirli bir aboneliği seçmek isterseniz, --subscription bayrağını ve abonelik kimliğini belirtebilirsiniz.

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

İletişim Hizmetleri kaynağınızı aşağıdaki seçeneklerle yapılandırabilirsiniz:

  • Kaynak grubu
  • İletişim Hizmetleri kaynağının adı
  • Kaynakla ilişkilendirilmiş coğrafya

Sonraki adımda, kaynağa etiket atayabilirsiniz. Azure kaynaklarınızı düzenlemek için etiketleri kullanabilirsiniz. Etiketler hakkında daha fazla bilgi için bkz . Azure kaynaklarınızı ve yönetim hiyerarşinizi düzenlemek için etiketleri kullanma.

İletişim Hizmetleri kaynağınızı yönetme

İletişim Hizmetleri kaynağınıza etiket eklemek için aşağıdaki komutları çalıştırın. Belirli bir aboneliği de hedefleyebilirsiniz.

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

Diğer komutlar hakkında bilgi için bkz Azure İletişim CLI.

Önkoşullar

  • Etkin aboneliği olan bir Azure hesabı. Ücretsiz hesap oluşturun.
  • İşletim sisteminiz için en son sürüm .NET Core SDK'sı .
  • .NET Kimlik SDK'sının en son sürümünü alın.
  • .NET Yönetim SDK'sının en son sürümünü edinin.

Telefon numaralarını kullanmayı planlıyorsanız ücretsiz deneme hesabını kullanamazsınız. Kaynağınızı oluşturmadan önce telefon numaraları satın almayı planlıyorsanız aboneliğinizin tüm gereksinimleri karşılayıp karşılamadığını denetleyin.

SDK’yı yükleyin

İlk olarak, C# projenize İletişim Hizmetleri Yönetim SDK'sını ekleyin:

using Azure.ResourceManager.Communication;

Abonelik Kimliği

Azure aboneliğinizin kimliğini bilmeniz gerekir. Portaldan abonelik kimliğinizi alın:

  1. Azure portalında hesabınızda oturum açın.
  2. Sol kenar çubuğunda Abonelikler'i seçin.
  3. Kullanmak istediğiniz aboneliği seçin.
  4. Genel Bakış'a tıklayın.
  5. Abonelik Kimliğinizi seçin.

Örneklerin çalışması için abonelik kimliğinizi adlı AZURE_SUBSCRIPTION_IDbir ortam değişkeninde depolamanız gerekir.

Kimlik Doğrulaması

Azure İletişim Hizmetleri ile iletişim kurmak için önce Azure'da kimliğinizi doğrulamanız gerekir. Bunun kimliğini bir hizmet sorumlusu kimliği kullanarak doğrulayabilirsiniz.

Seçenek 1: Yönetilen Kimlik

Kodunuz Azure'da hizmet olarak çalışıyorsa, kimlik doğrulaması yapmanın en kolay yolu Azure'dan yönetilen kimlik almaktır. Daha fazla bilgi için bkz.

Sistem tarafından atanan Yönetilen Kimlik

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());

Kullanıcı Tarafından Atanan Yönetilen Kimlik

Oluşturduğunuz yönetilen kimliğin ClientId değeri, ManagedIdentityCredential öğesine açıkça iletilmelidir.

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);

Seçenek 2: Hizmet Sorumlusu

Yönetilen kimlik kullanmak yerine, yönettiğiniz bir hizmet sorumlusu kullanarak Azure'da kimlik doğrulaması yapabilirsiniz. Daha fazla bilgi için bkz Microsoft Entra ID'de hizmet sorumlusu oluşturma ve yönetme.

Hizmet sorumlunuzu oluşturduktan sonra Azure portalından bu konuda aşağıdaki bilgileri toplamanız gerekir:

  • Müşteri Kimliği
  • İstemci Sırrı
  • Kiracı Kimlik

Bu değerleri sırasıyla , AZURE_CLIENT_IDve AZURE_CLIENT_SECRETadlı AZURE_TENANT_IDortam değişkenleri olarak depolayın. Daha sonra aşağıdaki gibi bir İletişim Hizmetleri yönetim istemcisi oluşturabilirsiniz:

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());

Seçenek 3: Kullanıcı Kimliği

Azure'ı hizmet kimliği kullanmak yerine etkileşimli bir kullanıcı adına çağırmak istiyorsanız, Azure İletişim Hizmetleri Management istemcisi oluşturmak için aşağıdaki kodu kullanabilirsiniz. Bu, kullanıcıdan MSA veya Microsoft Entra kimlik bilgilerini istemesi için bir tarayıcı penceresi açar.

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());

İletişim Hizmetleri kaynaklarını yönetme

Azure kaynaklarıyla etkileşim kurma

Kimlik doğrulaması yaptıktan sonra API çağrıları yapmak için yönetim istemcinizi kullanabilirsiniz.

Aşağıdaki örneklerin her biri için İletişim Hizmetleri kaynaklarımızı mevcut bir kaynak grubuna atarız.

Kaynak grubu oluşturmanız gerekiyorsa Azure portalını veya Azure Resource Manager SDK'sını kullanabilirsiniz.

İletişim Hizmetleri kaynağı oluşturma ve yönetme

İletişim Hizmetleri kaynakları üzerinde işlem gerçekleştirmek için İletişim Hizmetleri Yönetim SDK'sı istemcisinin (Azure.ResourceManager.Communication.CommunicationManagementClient) örneğini kullanabilirsiniz.

İletişim Hizmetleri kaynağı oluşturma

İletişim Hizmetleri kaynağı oluştururken kaynak grubu adını ve kaynak adını belirtin. Location özelliği her zaman global olur ve genel önizleme sırasında DataLocation değeri UnitedStates olmalıdır.

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();

İletişim Hizmetleri kaynağını güncelleştirme

...
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();

Tüm İletişim Hizmetleri kaynaklarını listeleme

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

İletişim Hizmetleri kaynağını silme

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

Anahtarları ve bağlantı dizesi yönetme

Her İletişim Hizmetleri kaynağında bir çift erişim anahtarı ve buna karşılık gelen bağlantı dizesi vardır. Yönetim SDK'sını kullanarak bu anahtarlara erişebilir ve ardından Azure İletişim Hizmetleri kimliklerini doğrulamak için diğer İletişim Hizmetleri SDK'larının kullanımına sunabilirsiniz.

İletişim Hizmetleri kaynağı için erişim anahtarları alma

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

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

İletişim Hizmetleri kaynağı için erişim anahtarını yeniden oluşturma

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);

Önkoşullar

Telefon numaralarını kullanmayı planlıyorsanız ücretsiz deneme hesabını kullanamazsınız. Kaynağınızı oluşturmadan önce telefon numaraları satın almayı planlıyorsanız aboneliğinizin tüm gereksinimleri karşılayıp karşılamadığını denetleyin.

PowerShell kullanarak Azure İletişim Hizmetleri kaynağı oluşturma

Azure İletişim Hizmetleri kaynağı oluşturmak için Azure CLI'da oturum açın. komutunu kullanarak Connect-AzAccount ve kimlik bilgilerinizi sağlayarak terminal aracılığıyla bir kaynak oluşturabilirsiniz.

İlk olarak, aşağıdaki komutu kullanarak Azure İletişim Hizmetleri modülünü Az.Communication yükleyin.

PS C:\> Install-Module Az.Communication

Kaynağı oluşturmak için aşağıdaki komutu çalıştırın:

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

Belirli bir aboneliği seçmek isterseniz, belirtilen --subscription bayrağını belirtebilir ve abonelik kimliğini sağlayabilirsiniz.

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

İletişim Hizmetleri kaynağınızı aşağıdaki seçeneklerle yapılandırabilirsiniz:

  • Kaynak grubu
  • İletişim Hizmetleri kaynağının adı
  • Kaynakla ilişkilendirilecek coğrafya

Sonraki adımda, kaynağa etiket atayabilirsiniz. Azure kaynaklarınızı düzenlemek için etiketleri kullanabilirsiniz. Daha fazla bilgi için bkz . Azure kaynaklarınızı ve yönetim hiyerarşinizi düzenlemek için etiketleri kullanma.

İletişim Hizmetleri kaynağınızı yönetme

İletişim Hizmetleri kaynağınıza etiket eklemek için aşağıdaki komutları çalıştırın. Belirli bir aboneliği de hedefleyebilirsiniz.

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

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

Belirli bir aboneliğe ilişkin tüm Azure İletişim Hizmetleri Kaynaklarınızı listelemek için aşağıdaki komutu kullanın:

PS C:\> Get-AzCommunicationService -SubscriptionId SubscriptionID

Belirli bir kaynakla ilgili tüm bilgileri listelemek için aşağıdaki komutu kullanın:

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

bağlantı dizesi ve hizmet uç noktalarınıza erişme

Bağlantı dizeleri, İletişim Hizmetleri SDK'larının Azure'a bağlanmasına ve kimlik doğrulaması yapmasına olanak tanır. İletişim Hizmetleri bağlantı dizesi ve hizmet uç noktalarınıza Azure portalından veya Azure Resource Manager API'leriyle program aracılığıyla erişebilirsiniz.

İletişim Hizmetleri kaynağınıza gittikten sonra, gezinti menüsünden Anahtarlar'ı seçin ve İletişim Hizmetleri SDK'ları tarafından kullanılmak üzere Bağlantı dizesini veya Uç nokta değerlerini kopyalayın. Birincil ve ikincil anahtarlara erişiminiz vardır. Bu anahtarlar, İletişim Hizmetleri kaynaklarınıza üçüncü taraf veya hazırlama ortamına geçici erişim sağlamak istediğinizde kullanışlıdır.

İletişim Hizmetleri Anahtarı sayfasının ekran görüntüsü.

Azure CLI kullanarak bağlantı dizesi ve hizmet uç noktalarınıza erişme

Kaynak grubunuz veya belirli bir kaynağın anahtarları gibi Azure CLI'yı kullanarak da anahtar bilgilerine erişebilirsiniz.

Azure CLI'yi yükleyin ve oturum açmak için aşağıdaki komutu kullanın. Azure hesabınıza bağlanmak için kimlik bilgilerinizi sağlamanız gerekir.

az login

Artık kaynaklarınız hakkındaki önemli bilgilere erişebilirsiniz.

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

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

Belirli bir aboneliği seçmek isterseniz, --subscription bayrağını ve abonelik kimliğini belirtebilirsiniz.

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

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

bağlantı dizesi depolama

İletişim Hizmetleri SDK'ları, İletişim Hizmetleri'ne yapılan istekleri yetkilendirmek için bağlantı dizesi kullanır. bağlantı dizesi depolamak için çeşitli seçenekleriniz vardır:

  • Masaüstünde veya cihazda çalışan bir uygulama, bağlantı dizesi bir app.config veya web.config dosyasında depolayabilir. Bağlantı dizisini bu dosyalardaki AppSettings bölümüne ekleyin.
  • Azure Uygulaması Hizmetinde çalışan bir uygulama, bağlantı dizesi App Service uygulama ayarlarında depolayabilir. bağlantı dizesi portaldaki Uygulama Ayarları sekmesinin Bağlantı Dizeleri bölümüne ekleyin.
  • bağlantı dizesi Azure Key Vault'ta depolayabilirsiniz. Bağlantı dizesini daha güvenli bir şekilde yönetebilirsiniz.
  • Uygulamanızı yerel olarak çalıştırıyorsanız, bağlantı dizesi bir ortam değişkeninde depolamak isteyebilirsiniz.

Bağlantı dizesini bir ortam değişkeninde depolayın

Ortam değişkenini yapılandırmak için bir konsol penceresi açın ve aşağıdaki sekmelerden işletim sisteminizi seçin. <yourconnectionstring> ile gerçek bağlantı dizesini değiştirin.

Bir konsol penceresi açın ve aşağıdaki komutu girin:

setx COMMUNICATION_SERVICES_CONNECTION_STRING "<yourConnectionString>"

Ortam değişkenini ekledikten sonra, konsol penceresi de dahil olmak üzere ortam değişkenini okuyan tüm çalışan programları yeniden başlatmanız gerekebilir. Örneğin, düzenleyici olarak Visual Studio kullanıyorsanız, örneği çalıştırmadan önce Visual Studio'yu yeniden başlatın.

Kaynakları temizleme

İletişim Hizmetleri aboneliğini temizlemek ve kaldırmak istiyorsanız, kaynağı veya kaynak grubunu silebilirsiniz. İletişim kaynağınızı silmek için aşağıdaki komutu çalıştırın.

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

Kaynak grubunun silinmesi, kaynak grubuyla ilişkili diğer tüm kaynakları da siler.

Kaynak silindikten sonra kaynağınıza atanmış telefon numaralarınız varsa, telefon numaraları kaynağınızdan otomatik olarak aynı anda serbest bırakılır.

Not

Kaynak silme kalıcıdır. Kaynağı silerseniz Event Grid filtreleri, telefon numaraları veya kaynağınıza bağlı diğer veriler de dahil olmak üzere silinmiş hiçbir veri kurtarılamaz.

Sonraki adımlar

Bu makalede şunların nasıl yapıldığını açıklanmıştır:

  • İletişim Hizmetleri kaynağı oluşturma
  • Kaynak coğrafyayı ve etiketleri yapılandırma
  • O kaynağın anahtarlarına erişin
  • Kaynağı silme

İlk kullanıcı erişim belirteçlerinizi oluşturma

  • Last updated on