E-posta İletişim Hizmeti kaynaklarını oluşturma ve yönetme

İ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 kaynakla aynı anda bir kaynak grubu oluşturamazsınız. Önce bir kaynak grubu oluşturmanız, ardından bunu e-posta kaynağınızı sağlarken kullanmanız 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 tıklayı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 bir grup oluşturmak için Yeni oluştur bağlantısına tıklayın.

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

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

    • Veri konumu olarak ABD'yi 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. Sonraki: Gözden geçir ve oluştur'a tıklayın.

  6. Doğrulamanın tamamlanmasını 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 istiyorsanız --subscription bayrağını belirtebilir ve abonelik kimliğini sağlayabilirsiniz.

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ı.
  • Kaynakla ilişkilendirilecek coğrafya.

Sonraki adımda, kaynağa etiket atayabilirsiniz. Ardından Etiketleri kullanarak Azure E-posta kaynaklarınızı düzenleyebilirsiniz. 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.

Uyarı

Kaynak silme kalıcıdır ve kaynağı silerseniz Event Grid filtreleri, telefon numaraları veya kaynağınıza bağlı diğer veriler 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

  • Aktif bir aboneliğe sahip 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’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. Kimliği portaldan alabilirsiniz:

  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ğrulama

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 DefaultAzureCredentialkullanmaktı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 ArmClientoluşturmanız gerekir.

Azure'da kimlik doğrulaması yapmak ve bir ArmClientoluşturmak için aşağıdaki kodu uygulayı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.Communication.Models;
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 atarı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ı belirtin.

Uyarı

Location özelliği her zaman global olur, ve açık önizleme sırasında DataLocation değeri UnitedStates olmalıdır.

// 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 = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e";
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 = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e";
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 = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e";
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 = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e";
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 = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e";
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");

Uyarı

Kaynak silme kalıcıdır ve kaynağı silerseniz Event Grid filtreleri, telefon numaraları veya kaynağınıza bağlı diğer veriler 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ükleyin.

PS C:\> Install-Module Az.Communication

Kaynak 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 istiyorsanız --subscription bayrağını belirtebilir ve abonelik kimliğini sağlayabilirsiniz.

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ı.
  • Kaynakla ilişkilendirilecek coğrafya.

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

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 Hizmetleri kaynağını 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

Uyarı

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

Sonraki adımlar

  • Last updated on