Aracılığıyla paylaş

Hızlı Başlangıç: E-posta İletişim Hizmeti kaynaklarını oluşturma ve yönetme

  • Makale

İlk E-posta İletişim Hizmeti kaynağınızı sağlayarak E-posta ile çalışmaya başlayın. Azure portalı aracılığıyla veya .NET yönetim istemci kitaplığını kullanarak E-posta İletişim Hizmeti kaynaklarını sağlayın. Yönetim istemci kitaplığı ve Azure portalı, Azure'ın 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. İstemci kitaplıklarında bulunan tüm işlevler Azure portalında kullanılabilir.

Uyarı

Azure İletişim Hizmetleri için kaynak grubuyla aynı anda kaynak grubu oluşturmanın mümkün olmadığını unutmayın. Kaynak oluştururken, önceden oluşturulmuş bir kaynak grubunun kullanılması gerekir.

Önkoşullar

Portalı kullanarak E-posta İletişim Hizmeti kaynağını oluşturma

  1. Yeni bir kaynak oluşturmak için Azure portalını açın.

  2. E-posta İletişim Hizmetleri'ne tıklayın.

    E-posta İletişim Hizmeti'nin pazar yerinde nasıl arandığını gösteren ekran görüntüsü.

  3. E-posta İletişim Hizmetleri'ne tıklayın ve Oluştur'a basın

    E-posta İletişim Hizmeti oluşturma bağlantısını gösteren ekran görüntüsü.

  4. Temel Bilgiler sekmesine gerekli bilgileri girin:

    • Mevcut bir Azure aboneliğini seçin.

    • Mevcut bir kaynak grubunu seçin veya Yeni oluştur bağlantısına tıklayarak yeni bir grup oluşturun.

    • Kaynak için geçerli bir ad belirtin.

    • Kaynağın kullanılabilir olması gereken bölgeyi seçin.

    • Veri konumu olarak Birleşik Devletler seçin.

    • Etiket eklemek için İleri: Etiketler'e tıklayın

    • Herhangi bir ad/değer çifti ekleyin.

      Gözden geçirme ve E-posta İletişim Hizmeti oluşturma özetini gösteren ekran görüntüsü.

  5. İleri: Gözden geçir ve oluştur'a tıklayın.

  6. Doğrulamanın geçmesini bekleyin ve Oluştur'a tıklayın.

  7. Dağıtımın tamamlanmasını bekleyin, ardından Kaynağa Git'e tıklayarak E-posta İletişimi Hizmetine genel bakış'ı açın.

    E-posta İletişim Hizmeti kaynağına genel bakışı gösteren ekran görüntüsü.

Önkoşullar

E-posta İletişim Hizmetleri kaynağı oluşturma

E-posta İletişim Hizmetleri kaynağı oluşturmak için Azure CLI'da oturum açın. Terminalden komutunu çalıştırarak az login ve kimlik bilgilerinizi sağlayarak oturum açabilirsiniz. Kaynağı oluşturmak için aşağıdaki komutu çalıştırın:

az communication email create --name "<EmailServiceName>" --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 email create --name "<EmailServiceName>" --location "Global" --data-location "United States" --resource-group "<resourceGroup>" --subscription "<subscriptionId>"

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

  • Kaynak grubu
  • E-posta İletişim Hizmetleri kaynağının adı
  • Kaynağın ilişkilendirileceği coğrafya

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

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

E-posta İ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 email update --name "<EmailServiceName>" --tags newTag="newVal1" --resource-group "<resourceGroup>"

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

Belirli bir Kaynak grubundaki tüm E-posta İletişim Hizmeti Kaynaklarınızı listelemek için aşağıdaki komutu kullanın:

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

Belirli bir E-posta İletişim Hizmeti kaynağındaki tüm bilgileri göstermek için aşağıdaki komutu kullanın. Belirli bir aboneliği de hedefleyebilirsiniz.

az communication email show --name "<EmailServiceName>" --resource-group "<resourceGroup>"

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

Kaynağı temizleme

E-posta İletişim Hizmetleri aboneliğini temizlemek ve kaldırmak istiyorsanız, kaynağı veya kaynak grubunu silebilirsiniz. Aşağıdaki komutu çalıştırarak e-posta iletişim kaynağınızı silebilirsiniz.

az communication email delete --name "<EmailServiceName>" --resource-group "<resourceGroup>"

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

Not

Kaynak silme kalıcıdır ve kaynağı silerseniz olay kılavuzu filtreleri, telefon numaraları veya kaynağınıza bağlı diğer veriler de dahil olmak üzere hiçbir veri kurtarılamaz.

Diğer komutlar hakkında bilgi için bkz . E-posta İ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.

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 hesabınızda oturum açın
  2. Sol kenar çubuğunda Abonelikler'i 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ı AZURE_SUBSCRIPTION_IDbir ortam değişkeninde depoladığınız varsayılır.

Kimlik Doğrulaması

Azure İletişim Hizmetleri ile iletişim kurmak için önce Azure'da kimliğinizi doğrulamanız gerekir.

İstemcinin Kimliğini Doğrulama

Kimliği doğrulanmış istemci oluşturmak için varsayılan seçenek DefaultAzureCredential kullanmaktır. Tüm yönetim API'leri aynı uç noktadan geçtiğinden kaynaklarla etkileşim kurmak için yalnızca bir üst düzey ArmClient oluşturulması gerekir.

Azure'da kimlik doğrulaması yapmak ve ArmClient oluşturmak için aşağıdaki kodu yapın:

using System;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Communication;
using Azure.ResourceManager.Resources;
...
// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

Azure kaynaklarıyla etkileşim kurma

Artık kimliğiniz doğrulandı.

Aşağıdaki örneklerin her biri için, E-posta Hizmetleri kaynaklarımızı mevcut bir kaynak grubuna atayacağız.

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

E-posta Hizmetleri kaynağı oluşturma

E-posta Hizmetleri kaynağı oluştururken kaynak grubu adını ve kaynak adını belirtirsiniz.

Not

Location özelliği her zaman globalolur ve genel önizleme DataLocation sırasında değeri olmalıdırUnitedStates.

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "11112222-3333-4444-5555-666677778888";
string resourceGroupName = "MyResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this EmailServiceResource
EmailServiceResourceCollection collection = resourceGroupResource.GetEmailServiceResources();

// invoke the operation
string emailServiceName = "MyEmailServiceResource";
EmailServiceResourceData data = new EmailServiceResourceData(new AzureLocation("Global"))
{
    DataLocation = "United States",
};
ArmOperation<EmailServiceResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, emailServiceName, data);
EmailServiceResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
EmailServiceResourceData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

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

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

...
// this example assumes you already have this EmailServiceResource created on azure
// for more information of creating EmailServiceResource, please refer to the document of EmailServiceResource
string subscriptionId = "11112222-3333-4444-5555-666677778888";
string resourceGroupName = "MyResourceGroup";
string emailServiceName = "MyEmailServiceResource";
ResourceIdentifier emailServiceResourceId = EmailServiceResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, emailServiceName);
EmailServiceResource emailServiceResource = client.GetEmailServiceResource(emailServiceResourceId);

// invoke the operation
EmailServiceResourcePatch patch = new EmailServiceResourcePatch()
{
    Tags =
    {
    ["newTag"] = "newVal",
    },
};
ArmOperation<EmailServiceResource> lro = await emailServiceResource.UpdateAsync(WaitUntil.Completed, patch);
EmailServiceResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
EmailServiceResourceData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

Tüm E-posta İletişim Hizmeti kaynaklarını kaynak grubuna göre listeleme

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "11112222-3333-4444-5555-666677778888";
string resourceGroupName = "MyResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this EmailServiceResource
EmailServiceResourceCollection collection = resourceGroupResource.GetEmailServiceResources();

// invoke the operation and iterate over the result
await foreach (EmailServiceResource item in collection.GetAllAsync())
{
    // the variable item is a resource, you could call other operations on this instance as well
    // but just for demo, we get its data from this resource instance
    EmailServiceResourceData resourceData = item.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

Console.WriteLine($"Succeeded");

Aboneliğe göre tüm E-posta İletişim Hizmeti kaynaklarını listeleme

// this example assumes you already have this SubscriptionResource created on azure
// for more information of creating SubscriptionResource, please refer to the document of SubscriptionResource
string subscriptionId = "11112222-3333-4444-5555-666677778888";
ResourceIdentifier subscriptionResourceId = SubscriptionResource.CreateResourceIdentifier(subscriptionId);
SubscriptionResource subscriptionResource = client.GetSubscriptionResource(subscriptionResourceId);

// invoke the operation and iterate over the result
await foreach (EmailServiceResource item in subscriptionResource.GetEmailServiceResourcesAsync())
{
    // the variable item is a resource, you could call other operations on this instance as well
    // but just for demo, we get its data from this resource instance
    EmailServiceResourceData resourceData = item.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

Console.WriteLine($"Succeeded");

Kaynağı temizleme

// this example assumes you already have this EmailServiceResource created on azure
// for more information of creating EmailServiceResource, please refer to the document of EmailServiceResource
string subscriptionId = "11112222-3333-4444-5555-666677778888";
string resourceGroupName = "MyResourceGroup";
string emailServiceName = "MyEmailServiceResource";
ResourceIdentifier emailServiceResourceId = EmailServiceResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, emailServiceName);
EmailServiceResource emailServiceResource = client.GetEmailServiceResource(emailServiceResourceId);

// invoke the operation
await emailServiceResource.DeleteAsync(WaitUntil.Completed);

Console.WriteLine($"Succeeded");

Not

Kaynak silme kalıcıdır ve kaynağı silerseniz olay kılavuzu filtreleri, telefon numaraları veya kaynağınıza bağlı diğer veriler de dahil olmak üzere hiçbir veri kurtarılamaz.

Önkoşullar

E-posta İletişim Hizmeti kaynağı oluşturma

E-posta İletişim Hizmeti kaynağı oluşturmak için aşağıdaki komutu kullanarak Connect-AzAccount Azure hesabınızda oturum açın ve kimlik bilgilerinizi sağlayın.

PS C:\> Connect-AzAccount

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

PS C:\> Install-Module Az.Communication

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

PS C:\> New-AzEmailService -ResourceGroupName ContosoResourceProvider1 -Name ContosoEmailServiceResource1 -DataLocation UnitedStates

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

PS C:\> New-AzEmailService -ResourceGroupName ContosoResourceProvider1 -Name ContosoEmailServiceResource1 -DataLocation UnitedStates -SubscriptionId SubscriptionID

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

  • Kaynak grubu
  • E-posta İletişim Hizmetleri kaynağının adı
  • Kaynağın ilişkilendirileceği coğrafya

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

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

E-posta İ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-AzEmailService -Name ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1 -Tag @{ExampleKey1="ExampleValue1"}

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

Belirli bir abonelikteki tüm E-posta İletişim Hizmeti kaynaklarınızı listelemek için aşağıdaki komutu kullanın:

PS C:\> Get-AzEmailService -SubscriptionId SubscriptionID

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

PS C:\> Get-AzEmailService -Name ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1

Kaynağı temizleme

E-posta İletişim Hizmetlerini temizlemek ve kaldırmak istiyorsanız, aşağıdaki komutu çalıştırarak E-posta iletişim kaynağınızı silebilirsiniz:

PS C:\> Remove-AzEmailService -Name ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1

Not

Kaynak silme kalıcıdır ve kaynağı silerseniz olay kılavuzu filtreleri, telefon numaraları veya kaynağınıza bağlı diğer veriler de dahil olmak üzere hiçbir veri kurtarılamaz.

Sonraki adımlar