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

Önkoşullar

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

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 İ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.

Markette Ara girişine veya portalın üst kısmındaki arama çubuğuna İletişim yazın.

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

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

Son olarak yapılandırmanızı gözden geçirebilir ve kaynağı oluşturabilirsiniz . 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

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

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 İ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 bayrağını --subscription belirtebilir 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'sı.

Ö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'yi yükleme

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

using Azure.ResourceManager.Communication;

Subscription ID

Azure aboneliğinizin kimliğini bilmeniz gerekir. Bu, portaldan edinilebilir:

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.

Bu hızlı başlangıçtaki ö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. Bunu genellikle bir hizmet sorumlusu kimliği kullanarak yaparsınız.

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.

• Yönetilen kimliklere genel bakış

• Yönetilen Kimlikleri destekleyen Azure hizmetleri

• App Service ve Azure İşlevleri için yönetilen kimlikleri 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 değeri açıkça öğesine ManagedIdentityCredential geçirilmelidir.

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, kendi yönettiğiniz bir hizmet sorumlusu kullanarak Azure'da kimlik doğrulaması yapmak isteyebilirsiniz. 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:

• İstemci kimliği
• İstemci Gizli Dizisi
• Kiracı Kimliği

Bu değerleri sırasıyla , AZURE_CLIENT_SECRETve AZURE_TENANT_IDadlı AZURE_CLIENT_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

Kimliğiniz doğrulandı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ı kullanarak bunu yapabilirsiniz.

İ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 globalolur ve genel önizleme DataLocation sırasında değeri olmalıdırUnitedStates.

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

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

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 İ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 bayrağını --subscription belirtebilir ve 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ı
• 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