Rövid útmutató: Communication Services-erőforrások létrehozása és kezelése

Válasszon egy programozási nyelvet

Azure Portal Azure CLI .NET PowerShell

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:

Azure PowerShell

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.

Azure PowerShell

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.

Azure PowerShell

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:

C#

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:

1. Jelentkezzen be a fiókjába az Azure Portalon.
2. A bal oldali oldalsávon válassza az Előfizetések lehetőséget.
3. Válassza ki a használni kívánt előfizetést.
4. Kattintson az Áttekintés elemre.
5. 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_IDkö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:

• Felügyelt identitások áttekintése

• Felügyelt identitásokat támogató Azure-szolgáltatások

• Felügyelt identitások használata az App Service-hez és az Azure Functionshez

Rendszer által hozzárendelt felügyelt identitás

C#

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.

C#

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_IDAZURE_CLIENT_SECRETkörnyezeti változókként, illetve AZURE_TENANT_IDazok neveként tárolja. Ezután létrehozhat egy Communication Services felügyeleti ügyfelet a következő módon:

C#

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.

C#

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 globalaz , és a nyilvános előzetes verzióban az DataLocation értéknek kell lennie UnitedStates.

C#

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

C#

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

C#

var resources = acsClient.CommunicationService.ListBySubscription();
foreach (var resource in resources)
{
    Console.WriteLine(resource.Name);
}

Communication Services-erőforrás törlése

C#

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

C#

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

C#

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.

PowerShell

PS C:\> Install-Module Az.Communication

Futtassa a következő parancsot az erőforrás létrehozásához:

PowerShell

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.

PowerShell

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.

PowerShell

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:

PowerShell

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:

PowerShell

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.

Azure PowerShell

az login

Most már hozzáférhet az erőforrások fontos információihoz.

Azure PowerShell

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.

Azure PowerShell

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.

Windows

Nyisson meg egy konzolablakot, és írja be a következő parancsot:

Console

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.

macOS

Szerkessze a .zshrc fájlt, és adja hozzá a környezeti változót:

Bash

export COMMUNICATION_SERVICES_CONNECTION_STRING="<yourConnectionString>"

A környezeti változó hozzáadását követően futtassa a source ~/.zshrc parancsot a konzolablakban a módosítások érvénybe léptetéséhez. Ha megnyitott IDE-vel hozta létre a környezeti változót, előfordulhat, hogy be kell zárnia és újra meg kell nyitnia a szerkesztőt, az IDE-t vagy a rendszerhéjat a változó eléréséhez.

Linux

Szerkessze a .bash_profile fájlt, és adja hozzá a környezeti változót:

Bash

export COMMUNICATION_SERVICES_CONNECTION_STRING="<yourConnectionString>"

A környezeti változó hozzáadását követően futtassa a source ~/.bash_profile parancsot a konzolablakban a módosítások érvénybe léptetéséhez. Ha megnyitott IDE-vel hozta létre a környezeti változót, előfordulhat, hogy be kell zárnia és újra meg kell nyitnia a szerkesztőt, az IDE-t vagy a rendszerhéjat a változó eléréséhez.

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.

Azure CLI

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.

Megjegyzé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

Az első felhasználói hozzáférési jogkivonatok létrehozása