Uwaga
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Rozpocznij pracę z pocztą e-mail, inicjując obsługę administracyjną pierwszego zasobu usługi komunikacji e-mail. Aprowizuj zasoby usługi komunikacji e-mail za pośrednictwem Azure Portal lub biblioteki klienta zarządzania platformy .NET. Biblioteka klienta zarządzania i Azure Portal umożliwiają tworzenie, konfigurowanie, aktualizowanie i usuwanie zasobów i interfejsu przy użyciu usługi wdrażania i zarządzania platformy Azure: Azure Resource Manager. Wszystkie funkcje dostępne w bibliotekach klienckich są dostępne w Azure Portal.
Ostrzeżenie
Nie można jednocześnie utworzyć grupy zasobów jako zasobu dla usług Azure Communication Services. Najpierw należy utworzyć grupę zasobów, a następnie użyć jej podczas aprowizacji zasobu poczty e-mail.
Wymagania wstępne
- Konto Azure z aktywną subskrypcją. Utwórz konto bezpłatnie.
Tworzenie zasobu Usługi komunikacji e-mail przy użyciu portalu
Otwórz Azure Portal , aby utworzyć nowy zasób.
Wyszukaj usługi komunikacji e-mail.
Wybierz pozycję Usługi komunikacji e-mail i kliknij przycisk Utwórz.
Wprowadź wymagane informacje w zakładce Podstawy :
Wybierz istniejącą subskrypcję platformy Azure.
Wybierz istniejącą grupę zasobów lub, aby utworzyć nową, kliknij link Utwórz nową .
Podaj prawidłową nazwę zasobu.
Wybierz region, w którym zasób ma być dostępny.
Wybierz Stany Zjednoczone jako lokalizację danych.
Aby dodać tagi, kliknij przycisk Dalej: Tagi
Dodaj dowolne pary nazwa/wartość.
Kliknij przycisk Dalej: Przejrzyj i utwórz.
Poczekaj na zakończenie sprawdzania poprawności, a następnie kliknij przycisk Utwórz.
Poczekaj na zakończenie wdrażania, a następnie kliknij pozycję Przejdź do zasobu , aby otworzyć omówienie usługi komunikacji e-mail.
Wymagania wstępne
- Konto Azure z aktywną subskrypcją. Utwórz konto bezpłatnie.
- Zainstaluj Azure CLI.
Tworzenie zasobu usług komunikacji poczty e-mail
Aby utworzyć zasób usług komunikacji poczty e-mail, zaloguj się do interfejsu wiersza polecenia platformy Azure. Możesz zalogować się, uruchamiając polecenie z poziomu terminalu az login
i podając swoje poświadczenia. Aby utworzyć zasób, uruchom następujące polecenie:
az communication email create --name "<EmailServiceName>" --location "Global" --data-location "United States" --resource-group "<resourceGroup>"
Jeśli chcesz wybrać określoną subskrypcję, możesz również określić flagę --subscription
i podać identyfikator subskrypcji.
az communication email create --name "<EmailServiceName>" --location "Global" --data-location "United States" --resource-group "<resourceGroup>" --subscription "<subscriptionId>"
Zasób usług komunikacji e-mail można skonfigurować przy użyciu następujących opcji:
- Grupa zasobów.
- Nazwa zasobu usług komunikacji poczty e-mail.
- Lokalizacja geograficzna do skojarzenia z zasobem.
W następnym kroku można przypisać tagi do zasobu. Następnie możesz użyć tagów do organizowania zasobów poczty e-mail platformy Azure. Aby uzyskać więcej informacji na temat tagów, zobacz dokumentację tagowania zasobów.
Zarządzanie zasobem usług komunikacji e-mail
Aby dodać tagi do zasobu usług komunikacji poczty e-mail, uruchom następujące polecenia. Możesz również wybrać konkretną subskrypcję.
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>"
Aby wyświetlić listę wszystkich zasobów usługi komunikacji poczty e-mail w danej grupie zasobów, użyj następującego polecenia:
az communication email list --resource-group "<resourceGroup>"
Aby wyświetlić wszystkie informacje o danym zasobie usługi komunikacji poczty e-mail, użyj następującego polecenia. Możesz również wybrać konkretną subskrypcję.
az communication email show --name "<EmailServiceName>" --resource-group "<resourceGroup>"
az communication email show --name "<EmailServiceName>" --resource-group "<resourceGroup>" --subscription "<subscriptionId>"
Czyszczenie zasobu
Jeśli chcesz wyczyścić i usunąć subskrypcję usług komunikacji poczty e-mail, możesz usunąć zasób lub grupę zasobów. Zasób komunikacji e-mail można usunąć, uruchamiając następujące polecenie.
az communication email delete --name "<EmailServiceName>" --resource-group "<resourceGroup>"
Usunięcie grupy zasobów powoduje również usunięcie wszelkich innych skojarzonych z nią zasobów.
Uwaga / Notatka
Usuwanie zasobów jest trwałe i nie można odzyskać żadnych danych, w tym filtrów usługi Event Grid, numerów telefonów lub innych danych powiązanych z zasobem.
Aby uzyskać informacje o innych poleceniach, zobacz Interfejs wiersza polecenia komunikacji e-mail.
Wymagania wstępne
- Konto Azure z aktywną subskrypcją. Utwórz konto bezpłatnie.
- Najnowsza wersja zestawu .NET Core SDK dla systemu operacyjnego.
- Pobierz najnowszą wersję zestawu .NET Identity SDK.
- Pobierz najnowszą wersję zestawu .NET Management SDK.
Zainstaluj zestaw SDK
Najpierw uwzględnij zestaw SDK zarządzania usługami komunikacyjnymi w projekcie języka C#:
using Azure.ResourceManager.Communication;
Identyfikator subskrypcji
Musisz znać identyfikator subskrypcji platformy Azure. Identyfikator można uzyskać z portalu:
- Zaloguj się do konta platformy Azure.
- Wybierz Subskrypcje na lewym pasku bocznym.
- Wybierz dowolną wymaganą subskrypcję.
- Kliknij pozycję Przegląd.
- Wybierz swój identyfikator subskrypcji.
W tym przewodniku Szybki start założono, że identyfikator subskrypcji został zapisany w zmiennej środowiskowej o nazwie AZURE_SUBSCRIPTION_ID
.
Uwierzytelnianie
Aby komunikować się z usługami Azure Communication Services, musisz najpierw uwierzytelnić się na platformie Azure.
Uwierzytelnianie klienta
Domyślną opcją utworzenia uwierzytelnionego klienta jest użycie DefaultAzureCredential
. Ponieważ wszystkie interfejsy API zarządzania przechodzą przez ten sam punkt końcowy, aby wchodzić w interakcje z zasobami, musisz utworzyć tylko jeden najwyższy poziom ArmClient
.
Aby uwierzytelnić się na platformie Azure i utworzyć ArmClient
plik , wykonaj następujący kod:
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);
Interakcja z zasobami platformy Azure
Teraz, gdy jesteś uwierzytelniony.
W każdym z poniższych przykładów przypiszemy nasze zasoby usług poczty e-mail do istniejącej grupy zasobów.
Jeśli musisz utworzyć grupę zasobów, możesz to zrobić przy użyciu witryny Azure Portal lub zestawu SDK usługi Azure Resource Manager.
Tworzenie zasobu usług poczty e-mail
Podczas tworzenia zasobu usług poczty e-mail określ nazwę grupy zasobów i nazwę zasobu.
Uwaga / Notatka
Właściwość Location
jest zawsze global
, a w publicznej wersji zapoznawczej DataLocation
wartość musi mieć wartość UnitedStates
.
// 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}");
Zarządzanie zasobem usług komunikacji e-mail
Aktualizowanie zasobu usług komunikacji e-mail
...
// 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}");
Wyświetlanie listy wszystkich zasobów usługi komunikacji poczty e-mail według grupy zasobów
// 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");
Wyświetlanie listy wszystkich zasobów usługi komunikacji e-mail według subskrypcji
// 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");
Czyszczenie zasobu
// 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");
Uwaga / Notatka
Usuwanie zasobów jest trwałe i nie można odzyskać żadnych danych, w tym filtrów usługi Event Grid, numerów telefonów lub innych danych powiązanych z zasobem.
Wymagania wstępne
- Konto Azure z aktywną subskrypcją. Utwórz konto bezpłatnie.
- Zainstaluj Azure Az PowerShell.
Tworzenie zasobu usługi komunikacji e-mail
Aby utworzyć zasób usługi komunikacji e-mail, zaloguj się do konta platformy Azure przy użyciu następującego Connect-AzAccount
polecenia i podaj swoje poświadczenia.
PS C:\> Connect-AzAccount
Najpierw zainstaluj moduł Az.Communication
Azure Communication Services przy użyciu następującego polecenia.
PS C:\> Install-Module Az.Communication
Aby utworzyć zasób, uruchom następujące polecenie:
PS C:\> New-AzEmailService -ResourceGroupName ContosoResourceProvider1 -Name ContosoEmailServiceResource1 -DataLocation UnitedStates
Jeśli chcesz wybrać określoną subskrypcję, możesz również określić flagę --subscription
i podać identyfikator subskrypcji.
PS C:\> New-AzEmailService -ResourceGroupName ContosoResourceProvider1 -Name ContosoEmailServiceResource1 -DataLocation UnitedStates -SubscriptionId SubscriptionID
Zasób usług Communication Services można skonfigurować przy użyciu następujących opcji:
- Grupa zasobów.
- Nazwa zasobu usług komunikacji poczty e-mail.
- Lokalizacja geograficzna, która ma być skojarzona z zasobem.
W następnym kroku można przypisać tagi do zasobu. Użyj tagów, aby uporządkować zasoby poczty e-mail platformy Azure. Aby uzyskać więcej informacji na temat tagów, zobacz tagowanie zasobów.
Zarządzanie zasobem usług komunikacji e-mail
Aby dodać tagi do zasobu usług komunikacji poczty e-mail, uruchom następujące polecenia. Możesz również wybrać konkretną subskrypcję.
PS C:\> Update-AzEmailService -Name ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1 -Tag @{ExampleKey1="ExampleValue1"}
PS C:\> Update-AzEmailService -Name ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1 -Tag @{ExampleKey1="ExampleValue1"} -SubscriptionId SubscriptionID
Aby wyświetlić listę wszystkich zasobów usługi komunikacji poczty e-mail w danej subskrypcji, użyj następującego polecenia:
PS C:\> Get-AzEmailService -SubscriptionId SubscriptionID
Aby wyświetlić listę wszystkich informacji dotyczących danego zasobu, użyj następującego polecenia:
PS C:\> Get-AzEmailService -Name ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1
Czyszczenie zasobu
Jeśli chcesz wyczyścić i usunąć zasób usług komunikacji poczty e-mail, możesz usunąć zasób komunikacji e-mail, uruchamiając następujące polecenie:
PS C:\> Remove-AzEmailService -Name ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1
Uwaga / Notatka
Usuwanie zasobów jest trwałe i nie można odzyskać żadnych danych, w tym filtrów usługi Event Grid, numerów telefonów lub innych danych powiązanych z zasobem.
Dalsze kroki
Domeny poczty e-mail i uwierzytelnianie nadawcy dla usług Azure Communication Services
Szybki start: jak połączyć zweryfikowaną domenę poczty e-mail
Powiązane artykuły
- Zapoznaj się z Email client library
- Dowiedz się, jak wysyłać wiadomości e-mail z niestandardowymi zweryfikowanymi domenami w przewodniku Szybki start: jak dodać niestandardowe zweryfikowane domeny poczty e-mail
- Dowiedz się, jak wysyłać wiadomości e-mail za pomocą usługi Azure Managed Domains w przewodniku Szybki start: Jak dodać usługę Azure Managed Domains do poczty e-mail