Hızlı Başlangıç: İletişim Hizmetleri kaynaklarını oluşturma ve yönetme

Önkoşullar

• Etkin aboneliği olan bir Azure hesabı. Ücretsiz bir hesap oluşturun.

Telefon numaralarını kullanmayı planlıyorsanız ücretsiz deneme hesabını kullanamayabilirsiniz. Kaynağınızı oluşturmadan önce telefon numarası satın alma planınız varsa aboneliğinizin tüm gereksinimleri karşılar mı?

Kaynak Azure İletişim Hizmetleri oluşturma

Yeni bir Azure İletişim Hizmetleri oluşturmak için önce Azure portal. Sayfanın sol üst köşesinde + Kaynak oluştur'a tıklayın.

Markette ara girişine veya portalın üst kısmında arama çubuğuna İletişim girin.

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

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

• Abonelik
• Kaynak grubu (yeni bir tane oluşturabilir veya var olan bir kaynak grubunu seçebilirsiniz)
• İletişim Hizmetleri kaynağının adı
• Kaynağın ilişkilendirilecek olduğu coğrafya

Sonraki adımda, kaynağa etiketler atabilirsiniz. Etiketler, Azure kaynaklarınızı düzenlemek için kullanılabilir. Etiketler hakkında daha fazla bilgi için kaynak etiketleme belgelerine bakın.

Son olarak yapılandırmanızı gözden geçirebilirsiniz ve Kaynağı oluşturabilirsiniz. Dağıtımın tamamlanmasının birkaç dakika sürebilir.

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

İletişim Hizmetleri kaynağınızı yönetmek için, iletişim Azure portal gidinve öğesini Azure İletişim Hizmetleri.

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

Kaynağınıza ilişkin Genel Bakış sayfası göz atma, durdurma, başlatma, yeniden başlatma ve silme gibi temel yönetim seçenekleri içerir. Kaynak sayfasının sol menüsünde daha fazla yapılandırma seçeneği bulabilirsiniz.

Önkoşullar

• Etkin aboneliği olan bir Azure hesabı. Ücretsiz hesap oluşturun.
• Azure CLI 'yı yükler

Telefon numaralarını kullanmayı planlıyorsanız, ücretsiz deneme hesabını kullanamazsınız. Kaynağınızı oluşturmadan önce telefon numaralarını satın almayı planlıyorsanız, aboneliğinizin tüm gereksinimleri karşıladığından emin olun.

Azure Communication Services kaynağı oluşturma

Azure Communication Services kaynağı oluşturmak için Azure CLI 'da oturum açın. Bunu, az login komutunu kullanarak ve kimlik bilgilerinizi sunarak terminalden yapabilirsiniz. Kaynağı oluşturmak için aşağıdaki komutu çalıştırın:

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

Belirli bir abonelik seçmek isterseniz, bayrağı da belirtebilir --subscription ve ABONELIK kimliğini sağlayabilirsiniz.

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

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

• Kaynak grubu
• Iletişim Hizmetleri kaynağının adı
• Kaynağın ilişkilendirileceği Coğrafya

Sonraki adımda, kaynağa etiketler atayabilirsiniz. Etiketler, Azure kaynaklarınızı düzenlemek için kullanılabilir. Etiketler hakkında daha fazla bilgi için bkz. kaynak etiketleme belgeleri .

Iletişim Hizmetleri kaynağınızı yönetme

Iletişim Hizmetleri kaynağına Etiketler 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>"

Ek komutlar hakkında daha fazla bilgi için bkz. az Communication.

Ö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 .
• .NET Identity SDK 'sınınen son sürümünü alın.
• .NET Yönetim SDK 'sınınen son sürümünü alın.

Telefon numaralarını kullanmayı planlıyorsanız, ücretsiz deneme hesabını kullanamazsınız. Kaynağınızı oluşturmadan önce telefon numaralarını satın almayı planlıyorsanız, aboneliğinizin tüm gereksinimleri karşıladığından emin olun.

SDK 'Yı yükleme

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

using Azure.ResourceManager.Communication;

Abonelik Kimliği

Azure aboneliğinizin KIMLIĞINI bilmeniz gerekir. Bu, portaldan elde edilebilir:

1. Azure hesabınızda oturum açın
2. Sol kenar çubuğundan abonelikler seçin
3. Hangi aboneliğin gerekli olduğunu seçin
4. Genel Bakış ' a tıklayın
5. Abonelik KIMLIĞINIZI seçin

Bu hızlı başlangıçta, abonelik KIMLIĞINI adlı bir ortam değişkeninde depoladığınız varsayılmaktadır AZURE_SUBSCRIPTION_ID .

Kimlik Doğrulaması

Azure Iletişim hizmetleriyle iletişim kurmak için öncelikle Azure 'da kimlik doğrulaması yapmanız gerekir. Genellikle bunu bir hizmet sorumlusu kimliği kullanarak yapabilirsiniz.

Seçenek 1: yönetilen kimlik

Kodunuz Azure 'da bir hizmet olarak çalışıyorsa, kimlik doğrulamasının en kolay yolu Azure 'dan yönetilen bir kimlik elde etmek için kullanılır. Yönetilen kimliklerhakkında daha fazla bilgi edinin.

Yönetilen kimlikleri destekleyen Azure hizmetleri

App Service ve Azure Işlevleri için Yönetilen kimlikler kullanma

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 'si açıkça geçirilmesi gerekir ManagedIdentityCredential .

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 bir kimlik kullanmak yerine, kendinizi yönettiğiniz hizmet sorumlusunu kullanarak Azure 'da kimlik doğrulaması yapmak isteyebilirsiniz. Azure Active Directory ' de bir hizmet sorumlusu oluşturma ve yönetmeile ilgili belgeler hakkında daha fazla bilgi edinin.

Hizmet sorumlunuzu oluşturduktan sonra, Azure portal hakkında aşağıdaki bilgileri toplamanız gerekir:

• İstemci Kimliği
• İstemci parolası
• Kiracı Kimliği

Bu değerleri AZURE_CLIENT_ID sırasıyla,, ve adlı ortam değişkenlerine depolayın AZURE_CLIENT_SECRET AZURE_TENANT_ID . Daha sonra şu şekilde bir Iletiş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 'u bir hizmet kimliği kullanmak yerine etkileşimli bir kullanıcı adına çağırmak isterseniz, bir Azure Communication Services yönetim istemcisi oluşturmak için aşağıdaki kodu kullanabilirsiniz. Bu, kullanıcıdan MSA veya Azure AD kimlik bilgilerini isteyecek 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());

Iletişim Hizmetleri kaynaklarını yönetme

Azure kaynaklarıyla etkileşim kurma

Artık kimliğiniz doğrulandıktan sonra, API çağrıları yapmak için yönetim istemcinizi kullanabilirsiniz.

Aşağıdaki örneklerden her biri için, Iletişim Hizmetleri kaynaklarınızı var olan bir kaynak grubuna atacağız.

Bir kaynak grubu oluşturmanız gerekiyorsa, Azure Portal veya Azure Resource Manager SDK 'sınıkullanarak bunu yapabilirsiniz.

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

İletişim Hizmetleri Yönetimi SDK 'Sı istemcisi () örneğimiz, Azure.ResourceManager.Communication.CommunicationManagementClient Iletişim Hizmetleri kaynakları üzerinde işlemler gerçekleştirmek için kullanılabilir.

İletişim Hizmetleri kaynağı oluşturma

Bir Iletişim Hizmetleri kaynağı oluştururken, kaynak grubu adını ve kaynak adını belirtirsiniz. LocationÖzelliğin her zaman olacağını global ve genel önizleme sırasında DataLocation değerin olması gerektiğini unutmayın 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();

Iletiş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 Iletişim Hizmetleri kaynaklarını listeleyin

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

Iletişim Hizmetleri kaynağını silme

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

Anahtarları ve bağlantı dizelerini yönetme

Her Iletişim Hizmetleri kaynağında, bir dizi erişim anahtarı ve karşılık gelen bağlantı dizesi vardır. Bu anahtarlara Yönetim SDK 'Sı ile erişilebilir ve ardından diğer Iletişim Hizmetleri SDK 'Ları tarafından Azure Iletişim hizmetlerinde kimlik doğrulaması için kullanılır.

Iletişim Hizmetleri kaynağı için erişim anahtarları alın

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

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

Iletiş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

• Etkin aboneliği olan bir Azure hesabı. Ücretsiz bir hesap oluşturun.
• Azure Az PowerShell Modülünü yükleme

Telefon numaralarını kullanmayı planlıyorsanız ücretsiz deneme hesabını kullanamayabilirsiniz. Kaynağınızı oluşturmadan önce telefon numarası satın alma planınız varsa aboneliğinizin tüm gereksinimleri karşılar mı?

Kaynak Azure İletişim Hizmetleri oluşturma

Kaynak oluşturmak Azure İletişim Hizmetleri Azure CLI'da oturum açma. Bunu komutunu kullanarak ve kimlik bilgilerinizi sağlayarak terminal Connect-AzAccount aracılığıyla da kullanabilirsiniz.

İlk olarak aşağıdaki komutu kullanarak Azure İletişim Hizmetleri Az.Communication emin olun.

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 için bayrağını da --subscription belirtip abonelik kimliğini belirtebilirsiniz.

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ı
• Kaynağın ilişkilendirilecek olduğu coğrafya

Sonraki adımda, kaynağa etiketler atabilirsiniz. Etiketler, Azure kaynaklarınızı düzenlemek için kullanılabilir. Etiketler hakkında daha fazla bilgi için kaynak etiketleme belgelerine bakın.

İ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

Tüm kaynak kaynaklarınızı Azure İletişim Hizmetleri abonelikte aşağıdaki komutu kullanın:

PS C:\> Get-AzCommunicationService -SubscriptionId SubscriptionID

Belirli bir kaynakla ilgili tüm bilgileri listeleyen aşağıdaki komutu kullanın:

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

az login

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

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

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

az communication list-key --name "<communicationName>" --resource-group "resourceGroup>" --subscription "<subscriptionID>"

setx COMMUNICATION_SERVICES_CONNECTION_STRING "<yourconnectionstring>"

export COMMUNICATION_SERVICES_CONNECTION_STRING="<yourconnectionstring>"

export COMMUNICATION_SERVICES_CONNECTION_STRING="<yourconnectionstring>"