Rövid útmutató: Communication Services-erőforrások létrehozása és kezelése
Ismerkedjen meg az Azure Communication Services szolgáltatással az első Communication Services-erőforrás kiépítésével. A Communication Services-erőforrások az Azure Portalon vagy a .NET felügyeleti SDK-val építhetők ki. A felügyeleti SDK és az Azure Portal lehetővé teszi az erőforrások és felületek létrehozását, konfigurálását, frissítését és törlését az új üzembe helyezési és felügyeleti szolgáltatás , az Azure Resource Manager használatával. Az SDK-kban elérhető összes függvény elérhető az Azure Portalon.
Figyelmeztetés
Vegye figyelembe, hogy az Azure Communication Services erőforrásával egy időben nem hozhat létre erőforráscsoportot. Erőforrás létrehozása előtt létre kell hoznia egy erőforráscsoportot.
Előfeltételek
- Egy Azure-fiók, aktív előfizetéssel. Fiók ingyenes létrehozása.
Ha telefonszámokat szeretne használni, nem használhatja az ingyenes próbaverziós fiókot. Ellenőrizze, hogy az előfizetés megfelel-e az összes követelménynek , ha telefonszámokat szeretne vásárolni az erőforrás létrehozása előtt.
Azure Communication Services-erőforrás létrehozása
Azure Communication Services-erőforrás létrehozásához először jelentkezzen be az Azure Portalra. A lap bal felső sarkában válassza az + Erőforrás létrehozása lehetőséget.
Írja be a Kommunikáció kifejezést a Marketplace-bemenet keresésébe vagy a portál tetején található keresősávba.
Válassza a Kommunikációs szolgáltatások lehetőséget az eredmények között, majd válassza a Létrehozás lehetőséget.
Most már konfigurálhatja a Communication Services-erőforrást. A létrehozási folyamat első lapján meg kell adnia a következőket:
- Az előfizetés
- Az erőforráscsoport (létrehozhat egy újat, vagy választhat egy meglévő erőforráscsoportot)
- A Communication Services-erőforrás neve
- Az erőforráshoz társított földrajzi hely
A következő lépésben címkéket rendelhet az erőforráshoz. Címkék használatával rendszerezheti az Azure-erőforrásokat. További információ a címkékről: Címkék használata az Azure-erőforrások és a felügyeleti hierarchia rendszerezéséhez.
Végül áttekintheti a konfigurációt, és létrehozhatja az erőforrást. Az üzembe helyezés néhány percet vesz igénybe.
A Communication Services-erőforrás kezelése
A Communication Services-erőforrás kezeléséhez jelentkezzen be az Azure Portalra, és keresse meg és válassza ki az Azure Communication Servicest.
A Communication Services lapon válassza ki az erőforrás nevét.
Az erőforrás Áttekintés lapja olyan alapvető felügyeleti lehetőségeket tartalmaz, mint a tallózás, a leállítás, az indítás, az újraindítás és a törlés. További konfigurációs beállításokért tekintse meg az erőforráslap bal oldali menüjét.
Előfeltételek
- Egy Azure-fiók, aktív előfizetéssel. Fiók ingyenes létrehozása.
- Az Azure CLI telepítése
Ha telefonszámokat szeretne használni, nem használhatja az ingyenes próbaverziós fiókot. Ellenőrizze, hogy az előfizetés megfelel-e az összes követelménynek , ha telefonszámokat szeretne vásárolni az erőforrás létrehozása előtt.
Azure Communication Services-erőforrás létrehozása
Azure Communication Services-erőforrás létrehozásához jelentkezzen be az Azure CLI-be. A parancs futtatásával bejelentkezhet a az login
terminálról, és megadhatja a hitelesítő adatait. Futtassa a következő parancsot az erőforrás létrehozásához:
az communication create --name "<acsResourceName>" --location "Global" --data-location "United States" --resource-group "<resourceGroup>"
Ha egy adott előfizetést szeretne kiválasztani, megadhatja a --subscription
jelölőt is, és megadhatja az előfizetés azonosítóját.
az communication create --name "<acsResourceName>" --location "Global" --data-location "United States" --resource-group "<resourceGroup> --subscription "<subscriptionId>"
A Communication Services-erőforrást a következő beállításokkal konfigurálhatja:
- Az erőforráscsoport
- A Communication Services-erőforrás neve
- Az erőforráshoz társított földrajzi hely
A következő lépésben címkéket rendelhet az erőforráshoz. Címkék használatával rendszerezheti az Azure-erőforrásokat. További információ a címkékről: Címkék használata az Azure-erőforrások és a felügyeleti hierarchia rendszerezéséhez.
A Communication Services-erőforrás kezelése
Ha címkéket szeretne hozzáadni a Communication Services-erőforráshoz, futtassa az alábbi parancsokat. Egy adott előfizetést is megcélzhat.
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>"
További információ az egyéb parancsokról: Azure Communication CLI.
Előfeltételek
- Egy Azure-fiók, aktív előfizetéssel. Fiók ingyenes létrehozása.
- A .NET Core SDK legújabb verziója az operációs rendszerhez.
- Szerezze be a .NET Identity SDK legújabb verzióját.
- Szerezze be a .NET Management SDK legújabb verzióját.
Ha telefonszámokat szeretne használni, nem használhatja az ingyenes próbaverziós fiókot. Ellenőrizze, hogy az előfizetés megfelel-e az összes követelménynek , ha telefonszámokat szeretne vásárolni az erőforrás létrehozása előtt.
Az SDK telepítése
Először is vegye fel a Communication Services Management SDK-t a C#-projektbe:
using Azure.ResourceManager.Communication;
Előfizetés azonosítója
Ismernie kell az Azure-előfizetés azonosítóját. Ez a portálról szerezhető be:
- Jelentkezzen be a fiókjába az Azure Portalon.
- A bal oldali oldalsávon válassza az Előfizetések lehetőséget.
- Válassza ki a használni kívánt előfizetést.
- Kattintson az Áttekintés elemre.
- Válassza ki az előfizetés azonosítóját.
Az ebben a rövid útmutatóban szereplő példák működéséhez az előfizetés azonosítóját egy úgynevezett AZURE_SUBSCRIPTION_ID
környezeti változóban kell tárolnia.
Hitelesítés
Az Azure Communication Services szolgáltatással való kommunikációhoz először hitelesítenie kell magát az Azure-ban. Ezt általában szolgáltatásnév-identitással fogja elvégezni.
1. lehetőség: Felügyelt identitás
Ha a kód szolgáltatásként fut az Azure-ban, a hitelesítés legegyszerűbb módja egy felügyelt identitás beszerzése az Azure-ból. További információk:
Rendszer által hozzárendelt felügyelt identitás
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());
Felhasználó által hozzárendelt felügyelt identitás
A létrehozott felügyelt identitás ügyfélazonosítóját explicit módon kell átadni a ManagedIdentityCredential
rendszernek.
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);
2. lehetőség: Egyszerű szolgáltatás
Felügyelt identitás használata helyett érdemes lehet saját maga által felügyelt szolgáltatásnévvel hitelesíteni az Azure-ban. További információ: Szolgáltatásnév létrehozása és kezelése a Microsoft Entra ID-ban.
A szolgáltatásnév létrehozása után a következő adatokat kell összegyűjtenie az Azure Portalról:
- Ügyfélazonosító
- Titkos ügyfélkód
- Bérlőazonosító
Ezeket az értékeket a nevesített AZURE_CLIENT_ID
AZURE_CLIENT_SECRET
környezeti változókként, illetve AZURE_TENANT_ID
azok neveként tárolja. Ezután létrehozhat egy Communication Services felügyeleti ügyfelet a következő módon:
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());
3. lehetőség: Felhasználói identitás
Ha szolgáltatásidentitás használata helyett interaktív felhasználó nevében szeretné meghívni az Azure-t, az alábbi kóddal létrehozhat egy Azure Communication Services Management-ügyfelet. Ekkor megnyílik egy böngészőablak, amely megkéri a felhasználót az MSA- vagy a Microsoft Entra-hitelesítő adataik megadására.
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());
Kommunikációs szolgáltatások erőforrásainak kezelése
Azure-erőforrások használata
A hitelesítés után a felügyeleti ügyfélprogram használatával API-hívásokat kezdeményezhet.
Az alábbi példák mindegyikéhez hozzárendeljük a Communication Services-erőforrásokat egy meglévő erőforráscsoporthoz.
Ha erőforráscsoportot kell létrehoznia, ezt az Azure Portalon vagy az Azure Resource Manager SDK-val teheti meg.
Communication Services-erőforrás létrehozása és kezelése
A Communication Services Management SDK-ügyfél (Azure.ResourceManager.Communication.CommunicationManagementClient
) példányával műveleteket hajthat végre a Communication Services-erőforrásokon.
Communication Services-erőforrás létrehozása
Communication Services-erőforrás létrehozásakor adja meg az erőforráscsoport nevét és az erőforrás nevét. A Location
tulajdonság mindig global
az , és a nyilvános előzetes verzióban az DataLocation
értéknek kell lennie 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();
Communication Services-erőforrás frissítése
...
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();
Az összes Communication Services-erőforrás listázása
var resources = acsClient.CommunicationService.ListBySubscription();
foreach (var resource in resources)
{
Console.WriteLine(resource.Name);
}
Communication Services-erőforrás törlése
var resourceGroupName = "myResourceGroupName";
var resourceName = "myResource";
await acsClient.CommunicationService.StartDeleteAsync(resourceGroupName, resourceName);
Kulcsok és kapcsolati sztring kezelése
Minden Communication Services-erőforrás rendelkezik hozzáférési kulcsokkal és megfelelő kapcsolati sztring. Ezeket a kulcsokat a Felügyeleti SDK-val érheti el, majd elérhetővé teheti őket más Communication Services SDK-k számára, hogy hitelesítsék magukat az Azure Communication Servicesben.
Hozzáférési kulcsok lekérése Egy Communication Services-erőforráshoz
var resourceGroupName = "myResourceGroupName";
var resourceName = "myResource";
var keys = await acsClient.CommunicationService.ListKeysAsync(resourceGroupName, resourceName);
Console.WriteLine(keys.Value.PrimaryConnectionString);
Console.WriteLine(keys.Value.SecondaryConnectionString);
Hozzáférési kulcs újragenerálása egy Communication Services-erőforráshoz
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);
Előfeltételek
- Egy Azure-fiók, aktív előfizetéssel. Fiók ingyenes létrehozása.
- Az Azure Az PowerShell-modul telepítése
Ha telefonszámokat szeretne használni, nem használhatja az ingyenes próbaverziós fiókot. Ellenőrizze, hogy az előfizetés megfelel-e az összes követelménynek , ha telefonszámokat szeretne vásárolni az erőforrás létrehozása előtt.
Azure Communication Services-erőforrás létrehozása
Azure Communication Services-erőforrás létrehozásához jelentkezzen be az Azure CLI-be. A parancs használatával és a hitelesítő adatok megadásával létrehozhat egy erőforrást a Connect-AzAccount
terminálon keresztül.
Először telepítse az Azure Communication Services modult Az.Communication
az alábbi paranccsal.
PS C:\> Install-Module Az.Communication
Futtassa a következő parancsot az erőforrás létrehozásához:
PS C:\> New-AzCommunicationService -ResourceGroupName ContosoResourceProvider1 -Name ContosoAcsResource1 -DataLocation UnitedStates -Location Global
Ha ki szeretne választani egy adott előfizetést, megadhatja a --subscription
jelölőt is, és megadhatja az előfizetés azonosítóját.
PS C:\> New-AzCommunicationService -ResourceGroupName ContosoResourceProvider1 -Name ContosoAcsResource1 -DataLocation UnitedStates -Location Global -SubscriptionId SubscriptionID
A Communication Services-erőforrást a következő beállításokkal konfigurálhatja:
- Az erőforráscsoport
- A Communication Services-erőforrás neve
- Az erőforráshoz társítandó földrajzi hely
A következő lépésben címkéket rendelhet az erőforráshoz. Címkék használatával rendszerezheti az Azure-erőforrásokat. További információ: Címkék használata az Azure-erőforrások és a felügyeleti hierarchia rendszerezéséhez.
A Communication Services-erőforrás kezelése
Ha címkéket szeretne hozzáadni a Communication Services-erőforráshoz, futtassa az alábbi parancsokat. Egy adott előfizetést is megcélozhat.
PS C:\> Update-AzCommunicationService -Name ContosoAcsResource1 -ResourceGroupName ContosoResourceProvider1 -Tag @{ExampleKey1="ExampleValue1"}
PS C:\> Update-AzCommunicationService -Name ContosoAcsResource1 -ResourceGroupName ContosoResourceProvider1 -Tag @{ExampleKey1="ExampleValue1"} -SubscriptionId SubscriptionID
Egy adott előfizetés összes Azure Communication Services-erőforrásának listázásához használja a következő parancsot:
PS C:\> Get-AzCommunicationService -SubscriptionId SubscriptionID
Egy adott erőforrás összes információjának listázásához használja a következő parancsot:
PS C:\> Get-AzCommunicationService -Name ContosoAcsResource1 -ResourceGroupName ContosoResourceProvider1
A kapcsolati sztring és a szolgáltatásvégpontok elérése
A kapcsolati sztringek lehetővé teszik a Communication Services SDK-k számára az Azure-hoz való csatlakozást és hitelesítést. A Kommunikációs szolgáltatások kapcsolati sztring és szolgáltatásvégpontjait az Azure Portalon, vagy programozott módon, az Azure Resource Manager API-kkal érheti el.
Miután navigált a Communication Services-erőforrásra, válassza a navigációs menü Kulcsok elemét, és másolja a Kapcsolati sztringet vagy a Végpont értékeket a Communication Services SDK-k általi használathoz. Hozzáféréssel rendelkezik az elsődleges és másodlagos kulcsokhoz. Ez akkor lehet hasznos, ha ideiglenes hozzáférést szeretne biztosítani a Communication Services-erőforrásokhoz egy külső vagy átmeneti környezethez.
A kapcsolati sztring és szolgáltatásvégpontok elérése az Azure CLI használatával
A kulcsinformációkat az Azure CLI használatával is elérheti, például az erőforráscsoportot vagy egy adott erőforrás kulcsait.
Telepítse az Azure CLI-t , és a következő paranccsal jelentkezzen be. Meg kell adnia a hitelesítő adatait az Azure-fiókhoz való csatlakozáshoz.
az login
Most már hozzáférhet az erőforrások fontos információihoz.
az communication list --resource-group "<resourceGroup>"
az communication list-key --name "<acsResourceName>" --resource-group "<resourceGroup>"
Ha egy adott előfizetést szeretne kiválasztani, megadhatja a --subscription
jelölőt is, és megadhatja az előfizetés azonosítóját.
az communication list --resource-group "<resourceGroup>" --subscription "<subscriptionId>"
az communication list-key --name "<acsResourceName>" --resource-group "<resourceGroup>" --subscription "<subscriptionId>"
A kapcsolati sztring tárolása
A Communication Services SDK-k kapcsolati sztring használnak a Communication Services felé irányuló kérések engedélyezéséhez. A kapcsolati sztring többféleképpen is tárolhatja:
- Az asztalon vagy eszközön futó alkalmazások tárolhatják a kapcsolati sztring egy app.config vagy web.config fájlban. Adja hozzá a kapcsolati sztring a fájlok AppSettings szakaszához.
- A Azure-alkalmazás Szolgáltatásban futó alkalmazások az App Service-alkalmazás beállításai között tárolhatják a kapcsolati sztring. Adja hozzá a kapcsolati sztring az Alkalmazásbeállítások lap Kapcsolati sztringek szakaszához a portálon.
- A kapcsolati sztring az Azure Key Vaultban tárolhatja. További biztonságosan kezelheti a kapcsolati sztring.
- Ha helyileg futtatja az alkalmazást, érdemes lehet a kapcsolati sztring egy környezeti változóban tárolni.
A kapcsolati sztring tárolása környezeti változóban
Környezeti változó konfigurálásához nyisson meg egy konzolablakot, és válassza ki az operációs rendszert az alábbi lapokról. Cserélje le <yourconnectionstring>
a tényleges kapcsolati sztring.
Nyisson meg egy konzolablakot, és írja be a következő parancsot:
setx COMMUNICATION_SERVICES_CONNECTION_STRING "<yourConnectionString>"
A környezeti változó hozzáadása után előfordulhat, hogy újra kell indítania a környezeti változót olvasó futó programokat, beleértve a konzolablakot is. Ha például a Visual Studiót használja szerkesztőként, indítsa újra a Visual Studiót a példa futtatása előtt.
Az erőforrások eltávolítása
Ha törölni és eltávolítani szeretne egy Communication Services-előfizetést, törölheti az erőforrást vagy az erőforráscsoportot. A kommunikációs erőforrás törléséhez futtassa a következő parancsot.
az communication delete --name "acsResourceName" --resource-group "resourceGroup"
Az erőforráscsoport törlése a hozzá társított egyéb erőforrásokat is törli.
Ha az erőforrás törlésekor bármilyen telefonszám van hozzárendelve az erőforráshoz, a telefonszámok automatikusan ki lesznek adva az erőforrásból egyszerre.
Feljegyzés
Az erőforrás törlése végleges , és az erőforrás törlésekor nem állíthatók helyre adatok( például eseményrácsszűrők, telefonszámok vagy más, az erőforráshoz kapcsolódó adatok).
Következő lépések
Ebben a rövid útmutatóban megtanulta, hogyan:
- Communication Services-erőforrás létrehozása
- Erőforrás földrajzi helyének és címkéinek konfigurálása
- Az erőforrás kulcsainak elérése
- Az erőforrás törlése