Início Rápido: Criar um recurso dos Serviços Cognitivos usando a biblioteca de clientes do Gerenciamento do AzureQuickstart: Create a Cognitive Services resource using the Azure Management client library

Use este guia de início rápido para criar e gerenciar recursos dos Serviços Cognitivos do Azure usando a biblioteca de clientes de Gerenciamento do Azure.Use this quickstart to create and manage Azure Cognitive Services resources using the Azure Management client library.

Os Serviços Cognitivos do Azure são serviços baseados em nuvem com APIs REST e SDKs de biblioteca de cliente disponíveis para ajudar os desenvolvedores a incutir a inteligência cognitiva nos aplicativos, sem ter conhecimentos ou habilidades diretas sobre os domínios de IA (inteligência artificial) ou ciência de dados.Azure Cognitive Services are cloud-base services with REST APIs, and client library SDKs available to help developers build cognitive intelligence into applications without having direct artificial intelligence (AI) or data science skills or knowledge. Os Serviços Cognitivos do Azure permitem que os desenvolvedores adicionem com facilidade recursos cognitivos a seus aplicativos, com soluções cognitivas capazes de ver, ouvir, falar, entender e até mesmo começar a racionalizar.Azure Cognitive Services enables developers to easily add cognitive features into their applications with cognitive solutions that can see, hear, speak, understand, and even begin to reason.

Os serviços de IA individuais são representados pelos recursos do Azure que você cria em sua assinatura do Azure.Individual AI services are represented by Azure resources that you create under your Azure subscription. Depois de criar um recurso, use as chaves e o ponto de extremidade gerados para autenticar seus aplicativos.After you create a resource, you can use the keys and endpoint generated to authenticate your applications.

Documentação de referência | Código-fonte da biblioteca | Pacote (NuGet) | ExemplosReference documentation | Library source code | Package (NuGet) | Samples

Pré-requisitosPrerequisites

Criar uma entidade de serviço do AzureCreate an Azure Service Principal

Para que o aplicativo interaja com sua conta do Azure, você precisa de uma entidade de serviço do Azure para gerenciar permissões.To have your application interact with your Azure account, you need an Azure service principal to manage permissions. Siga as instruções em Criar uma entidade de serviço do Azure.Follow the instructions in Create an Azure service principal.

Ao criar uma entidade de serviço, você verá que ela tem um valor secreto, uma ID e uma ID de aplicativo.When you create a service principal, you'll see it has a secret value, an ID, and an application ID. Salve a ID do aplicativo e o segredo em um local temporário para etapas posteriores.Save the application ID and secret to a temporary location for later steps.

Criar um grupo de recursosCreate a resource group

Antes de criar um recurso dos Serviços Cognitivos, sua conta precisa ter um grupo de recursos do Azure para conter o recurso.Before you create a Cognitive Services resource, your account must have an Azure resource group to contain the resource. Se ainda não tiver um grupo de recursos, crie um no portal do Azure antes de continuar.If you don't already have a resource group, create one in the Azure portal before continuing.

Criar um aplicativo em C#Create a new C# application

Criar um aplicativo .NET Core.Create a new .NET Core application. Em uma janela de console (como cmd, PowerShell ou Bash), use o comando dotnet new para criar um novo aplicativo do console com o nome azure-management-quickstart.In a console window (such as cmd, PowerShell, or Bash), use the dotnet new command to create a new console app with the name azure-management-quickstart. Esse comando cria um projeto simples em C# do tipo "Olá, Mundo" com um arquivo de origem único: program.cs.This command creates a simple "Hello World" C# project with a single source file: program.cs.

dotnet new console -n azure-management-quickstart

Altere o diretório para a pasta do aplicativo recém-criado.Change your directory to the newly created app folder. É possível criar o aplicativo com:You can build the application with:

dotnet build

A saída de compilação não deve conter nenhum aviso ou erro.The build output should contain no warnings or errors.

...
Build succeeded.
 0 Warning(s)
 0 Error(s)
...

Instalar a biblioteca de clientesInstall the client library

No diretório do aplicativo, instale a biblioteca de clientes de Gerenciamento do Azure para .NET com o seguinte comando:Within the application directory, install the Azure Management client library for .NET with the following command:

dotnet add package Microsoft.Azure.Management.CognitiveServices
dotnet add package Microsoft.Azure.Management.Fluent
dotnet add package Microsoft.Azure.Management.ResourceManager.Fluent

Se você estiver usando o IDE do Visual Studio, a biblioteca de clientes estará disponível como um pacote baixável do NuGet.If you're using the Visual Studio IDE, the client library is available as a downloadable NuGet package.

Importar bibliotecasImport libraries

Abra program.cs e adicione as seguintes instruções using na parte superior do arquivo:Open program.cs and add the following using statements to the top of the file:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using Microsoft.Azure.Management.Fluent;
using Microsoft.Azure.Management.ResourceManager.Fluent;
using Microsoft.Azure.Management.ResourceManager.Fluent.Authentication;
using Microsoft.Azure.Management.CognitiveServices;
using Microsoft.Azure.Management.CognitiveServices.Models;

Autenticar o clienteAuthenticate the client

Adicione os campos a seguir à raiz de program.cs e preencha seus valores, usando a entidade de serviço que você criou e as informações de sua conta do Azure.Add the following fields to the root of program.cs and populate their values, using the service principal you created and your Azure account information.

const string  service_principal_application_id = "TODO_REPLACE";
const string  service_principal_secret = "TODO_REPLACE";

/* The ID of your Azure subscription. You can find this in the Azure Dashboard under Home > Subscriptions. */
const string  subscription_id = "TODO_REPLACE";

/* The Active Directory tenant ID. You can find this in the Azure Dashboard under Home > Azure Active Directory. */
const string  tenant_id = "TODO_REPLACE";

/* The name of the Azure resource group in which you want to create the resource.
You can find resource groups in the Azure Dashboard under Home > Resource groups. */
const string  resource_group_name = "TODO_REPLACE";

Em seguida, no método Main, use esses valores para construir um objeto CognitiveServicesManagementClient.Then, in your Main method, use these values to construct a CognitiveServicesManagementClient object. Esse objeto é necessário para todas as operações de gerenciamento do Azure.This object is needed for all of your Azure management operations.

var service_principal_credentials = new ServicePrincipalLoginInformation ();
service_principal_credentials.ClientId = service_principal_application_id;
service_principal_credentials.ClientSecret = service_principal_secret;

var credentials = SdkContext.AzureCredentialsFactory.FromServicePrincipal(service_principal_application_id, service_principal_secret, tenant_id, AzureEnvironment.AzureGlobalCloud);
var client = new CognitiveServicesManagementClient(credentials);
client.SubscriptionId = subscription_id;

Chamar métodos gerenciamentoCall management methods

Adicione o código a seguir ao método Main para listar os recursos disponíveis, criar um recurso de exemplo, listar os recursos de sua propriedade e excluir o recurso de exemplo.Add the following code to your Main method to list available resources, create a sample resource, list your owned resources, and then delete the sample resource. Você definirá esses métodos nas etapas a seguir.You'll define these methods in the next steps.

    // List all available resource kinds, SKUs, and locations for your Azure account:
    list_available_kinds_skus_locations(client);

    // Create a resource with kind TextTranslation, F0 (free tier), location global.
    create_resource(client, "test_resource", "TextTranslation", "F0", "Global");

    // List all resources for your Azure account:
    list_resources(client);

    // Delete the resource.
    delete_resource(client, "test_resource");

    Console.WriteLine("Press any key to exit.");
    Console.ReadKey();

Criar um recurso dos Serviços CognitivosCreate a Cognitive Services resource

Escolher um serviço e um tipo de preçoChoose a service and pricing tier

Ao criar um recurso, você precisará saber qual "tipo" de serviço deseja usar, bem como o tipo de preço (ou SKU) desejado.When you create a new resource, you'll need to know the "kind" of service you want to use, along with the pricing tier (or SKU) you want. Você usará essa e outras informações como parâmetros ao criar o recurso.You'll use this and other information as parameters when creating the resource. Você pode encontrar uma lista dos "tipos" de Serviços Cognitivos disponíveis chamando o seguinte método em seu script:You can find a list of available Cognitive Service "kinds" by calling the following method in your script:

static void list_available_kinds_skus_locations(CognitiveServicesManagementClient client)
{

    Console.WriteLine("Available SKUs:");
    var result = client.ResourceSkus.List();
    Console.WriteLine("Kind\tSKU Name\tSKU Tier\tLocations");
    foreach (var x in result) {
        var locations = "";
        foreach (var region in x.Locations)
        {
            locations += region;
        }
        Console.WriteLine(x.Kind + "\t" + x.Name + "\t" + x.Tier + "\t" + locations);
    };
}

Você pode acessar os Serviços Cognitivos do Azure por meio de dois recursos diferentes: Um recurso de vários serviços ou um só serviço.You can access Azure Cognitive Services through two different resources: A multi-service resource, or a single-service one.

  • Recurso de vários serviços:Multi-service resource:
    • Acessar vários Serviços Cognitivos do Azure com uma chave e um ponto de extremidade.Access multiple Azure Cognitive Services with a single key and endpoint.
    • Consolida a cobrança dos serviços que você usa.Consolidates billing from the services you use.
  • Recurso de um serviço:Single-service resource:
    • Acesse um só Serviço Cognitivo do Azure com uma chave exclusiva e um ponto de extremidade para cada serviço criado.Access a single Azure Cognitive Service with a unique key and endpoint for each service created.
    • Use a camada gratuita para experimentar o serviço.Use the free tier to try out the service.

Confira abaixo a lista de SKUs e informações de preços.See the list of SKUs and pricing information below.

Vários serviçosMulti-service

ServiçoService TipoKind
Vários serviços.Multiple services. Para saber mais, consulte a página de preços.For more information, see the pricing page. CognitiveServices

VisãoVision

ServiçoService TipoKind
Pesquisa Visual ComputacionalComputer Vision ComputerVision
Visão Personalizada – PrevisãoCustom Vision - Prediction CustomVision.Prediction
Visão Personalizada – TreinamentoCustom Vision - Training CustomVision.Training
FaceFace Face
Reconhecimento de FormuláriosForm Recognizer FormRecognizer
Reconhecimento de Tinta DigitalInk Recognizer InkRecognizer
ServiçoService TipoKind
Sugestão Automática do BingBing Autosuggest Bing.Autosuggest.v7
Pesquisa Personalizada do BingBing Custom Search Bing.CustomSearch
Pesquisa de Entidade do BingBing Entity Search Bing.EntitySearch
Pesquisa do BingBing Search Bing.Search.v7
Verificação Ortográfica do BingBing Spell Check Bing.SpellCheck.v7

FalaSpeech

ServiçoService TipoKind
Serviços de FalaSpeech Services SpeechServices
Reconhecimento de falaSpeech Recognition SpeakerRecognition

IdiomaLanguage

ServiçoService TipoKind
Compreensão de FormulárioForm Understanding FormUnderstanding
LUISLUIS LUIS
QnA MakerQnA Maker QnAMaker
Análise de textoText Analytics TextAnalytics
Tradução de textoText Translation TextTranslation

DecisãoDecision

ServiçoService TipoKind
Detector de AnomaliasAnomaly Detector AnomalyDetector
Content ModeratorContent Moderator ContentModerator
PersonalizadorPersonalizer Personalizer

Tipos de preço e cobrançaPricing tiers and billing

Os tipos de preço (e o valor que é cobrado de você) são baseados no número de transações que você envia usando suas informações de autenticação.Pricing tiers (and the amount you get billed) are based on the number of transactions you send using your authentication information. Cada tipo de preço especifica:Each pricing tier specifies the:

  • o número máximo de transações permitidas por segundo (TPS).maximum number of allowed transactions per second (TPS).
  • os recursos de serviço habilitados no tipo de preço.service features enabled within the pricing tier.
  • o custo de um número predefinido de transações.cost for a predefined number of transactions. Ultrapassar esse número gera um encargo extra, conforme especificado nos detalhes do preço do serviço.Going above this number will cause an extra charge as specified in the pricing details for your service.

Observação

Muitos dos Serviços Cognitivos têm uma camada gratuita que você pode usar para experimentar o serviço.Many of the Cognitive Services have a free tier you can use to try the service. Para usar a camada gratuita, use F0 como a SKU do recurso.To use the free tier, use F0 as the SKU for your resource.

Criar um recurso dos Serviços CognitivosCreate a Cognitive Services resource

Para criar e assinar um recurso dos Serviços Cognitivos, use o método Criar.To create and subscribe to a new Cognitive Services resource, use the Create method. Esse método adiciona um novo recurso que pode ser cobrado ao grupo de recursos que você passa.This method adds a new billable resource to the resource group you pass in. Ao criar o recurso, você precisará saber qual "tipo" de serviço deseja usar, bem como o tipo de preço (ou SKU) desejado e um local do Azure.When creating your new resource, you'll need to know the "kind" of service you want to use, along with its pricing tier (or SKU) and an Azure location. O método a seguir usa todos esses argumentos e cria um recurso.The following method takes all of these as arguments and creates a resource.

static void create_resource(CognitiveServicesManagementClient client, string resource_name, string kind, string account_tier, string location)
{
    Console.WriteLine("Creating resource: " + resource_name + "...");
    // The parameter "properties" must be an empty object.
    CognitiveServicesAccount parameters = 
        new CognitiveServicesAccount(null, null, kind, location, resource_name, new CognitiveServicesAccountProperties(), new Sku(account_tier));
    var result = client.Accounts.Create(resource_group_name, account_tier, parameters);
    Console.WriteLine("Resource created.");
    Console.WriteLine("ID: " + result.Id);
    Console.WriteLine("Kind: " + result.Kind);
    Console.WriteLine();
}

Exibir os recursosView your resources

Para exibir todos os recursos em sua conta do Azure (em todos os grupos de recursos), use o seguinte método:To view all of the resources under your Azure account (across all resource groups), use the following method:

static void list_resources(CognitiveServicesManagementClient client)
{
    Console.WriteLine("Resources in resource group: " + resource_group_name);
    var result = client.Accounts.ListByResourceGroup(resource_group_name);
    foreach (var x in result)
    {
        Console.WriteLine("ID: " + x.Id);
        Console.WriteLine("Name: " + x.Name);
        Console.WriteLine("Type: " + x.Type);
        Console.WriteLine("Kind: " + x.Kind);
        Console.WriteLine();
    }
}

Excluir um recursoDelete a resource

O método a seguir exclui o recurso especificado do grupo de recursos fornecido.The following method deletes the specified resource from the given resource group.

static void delete_resource(CognitiveServicesManagementClient client, string resource_name)
{
    Console.WriteLine("Deleting resource: " + resource_name + "...");
    client.Accounts.Delete (resource_group_name, resource_name);

    Console.WriteLine("Resource deleted.");
    Console.WriteLine();
}

Executar o aplicativoRun the application

Execute o aplicativo do seu diretório de aplicativo com o comando dotnet run.Run the application from your application directory with the dotnet run command.

dotnet run

Veja tambémSee also

Documentação de referência | Código-fonte da biblioteca | Pacote (Maven)Reference documentation | Library source code | Package (Maven)

Pré-requisitosPrerequisites

Criar uma entidade de serviço do AzureCreate an Azure Service Principal

Para que o aplicativo interaja com sua conta do Azure, você precisa de uma entidade de serviço do Azure para gerenciar permissões.To have your application interact with your Azure account, you need an Azure service principal to manage permissions. Siga as instruções em Criar uma entidade de serviço do Azure.Follow the instructions in Create an Azure service principal.

Ao criar uma entidade de serviço, você verá que ela tem um valor secreto, uma ID e uma ID de aplicativo.When you create a service principal, you'll see it has a secret value, an ID, and an application ID. Salve a ID do aplicativo e o segredo em um local temporário para etapas posteriores.Save the application ID and secret to a temporary location for later steps.

Criar um grupo de recursosCreate a resource group

Antes de criar um recurso dos Serviços Cognitivos, sua conta precisa ter um grupo de recursos do Azure para conter o recurso.Before you create a Cognitive Services resource, your account must have an Azure resource group to contain the resource. Se ainda não tiver um grupo de recursos, crie um no portal do Azure antes de continuar.If you don't already have a resource group, create one in the Azure portal before continuing.

Criar um aplicativo JavaCreate a new Java application

Em uma janela de console (como cmd, PowerShell ou Bash), crie um novo diretório para seu aplicativo e navegue até ele.In a console window (such as cmd, PowerShell, or Bash), create a new directory for your app, and navigate to it.

mkdir myapp && cd myapp

Execute o comando gradle init em seu diretório de trabalho.Run the gradle init command from your working directory. Esse comando criará arquivos de build essenciais para o Gradle, incluindo build.gradle.kts, que é usado em runtime para criar e configurar seu aplicativo.This command will create essential build files for Gradle, including build.gradle.kts which is used at runtime to create and configure your application.

gradle init --type basic

Quando solicitado a escolher uma DSL, escolha Kotlin.When prompted to choose a DSL, select Kotlin.

Do diretório de trabalho, execute o seguinte comando:From your working directory, run the following command:

mkdir -p src/main/java

Instalar a biblioteca de clientesInstall the client library

Este início rápido usa o gerenciador de dependência do Gradle.This quickstart uses the Gradle dependency manager. Você pode encontrar a biblioteca de clientes e informações para outros gerenciadores de dependência no Repositório Central do Maven.You can find the client library and information for other dependency managers on the Maven Central Repository.

No arquivo build.gradle.kts do projeto, inclua a biblioteca de clientes como uma instrução implementation, juntamente com as configurações e os plug-ins necessários.In your project's build.gradle.kts file, include the client library as an implementation statement, along with the required plugins and settings.

plugins {
    java
    application
}
application {
    mainClass.set("FormRecognizer")
}
repositories {
    mavenCentral()
}
dependencies {
    implementation(group = "com.microsoft.azure", name = "azure-mgmt-cognitiveservices", version = "1.10.0-beta")
}

Importar bibliotecasImport libraries

Navegue até a nova pasta src/main/java e crie um arquivo chamado Management.java.Navigate to the new src/main/java folder and create a file called Management.java. Abra-a no editor ou IDE de sua preferência e adicione as seguintes instruções import:Open it in your preferred editor or IDE and add the following import statements:

import com.microsoft.azure.*;
import com.microsoft.azure.arm.resources.Region;
import com.microsoft.azure.credentials.*;
import com.microsoft.azure.management.cognitiveservices.v2017_04_18.*;
import com.microsoft.azure.management.cognitiveservices.v2017_04_18.implementation.*;

import java.io.*;
import java.lang.Object.*;
import java.util.*;
import java.net.*;

Autenticar o clienteAuthenticate the client

Adicione uma classe em Management.java e adicione os campos e os valores dentro dele a seguir.Add a class in Management.java, and then add the following fields and their values inside of it. Preencha os valores usando a entidade de serviço que você criou e outras informações da conta do Azure.Populate their values, using the service principal you created and your other Azure account information.

/*
Be sure to use the service pricipal application ID, not simply the ID. 
*/
private static String applicationId = "INSERT APPLICATION ID HERE";
private static String applicationSecret = "INSERT APPLICATION SECRET HERE";

/* The ID of your Azure subscription. You can find this in the Azure Dashboard under Home > Subscriptions. */
private static String subscriptionId = "INSERT SUBSCRIPTION ID HERE";

/* The Active Directory tenant ID. You can find this in the Azure Dashboard under Home > Azure Active Directory. */
private static String tenantId = "INSERT TENANT ID HERE";

/* The name of the Azure resource group in which you want to create the resource.
You can find resource groups in the Azure Dashboard under Home > Resource groups. */
private static String resourceGroupName = "INSERT RESOURCE GROUP NAME HERE";

Em seguida, no método main, use esses valores para construir um objeto CognitiveServicesManager.Then, in your main method, use these values to construct a CognitiveServicesManager object. Esse objeto é necessário para todas as operações de gerenciamento do Azure.This object is needed for all of your Azure management operations.

// auth
private static ApplicationTokenCredentials credentials = new ApplicationTokenCredentials(applicationId, tenantId, applicationSecret, AzureEnvironment.AZURE);

CognitiveServicesManager client = CognitiveServicesManager.authenticate(credentials, subscriptionId);

Chamar métodos gerenciamentoCall management methods

Adicione o código a seguir ao método Main para listar os recursos disponíveis, criar um recurso de exemplo, listar os recursos de sua propriedade e excluir o recurso de exemplo.Add the following code to your Main method to list available resources, create a sample resource, list your owned resources, and then delete the sample resource. Você definirá esses métodos nas etapas a seguir.You'll define these methods in the next steps.

    // list all available resource kinds, SKUs, and locations for your Azure account.
    list_available_kinds_skus_locations (client);

    // list all resources for your Azure account.
    list_resources (client);

    // Create a resource with kind Text Translation, SKU F0 (free tier), location global.
    String resourceId = create_resource (client, "test_resource", resourceGroupName, "TextAnalytics", "S0", Region.US_WEST);

    // Delete the resource.
    delete_resource (client, resourceId);
}

Criar um recurso dos Serviços CognitivosCreate a Cognitive Services resource

Escolher um serviço e um tipo de preçoChoose a service and pricing tier

Ao criar um recurso, você precisará saber qual "tipo" de serviço deseja usar, bem como o tipo de preço (ou SKU) desejado.When you create a new resource, you'll need to know the "kind" of service you want to use, along with the pricing tier (or SKU) you want. Você usará essa e outras informações como parâmetros ao criar o recurso.You'll use this and other information as parameters when creating the resource. Você pode encontrar uma lista dos "tipos" de Serviços Cognitivos disponíveis chamando o seguinte método:You can find a list of available Cognitive Service "kinds" by calling the following method:

public void list_available_kinds_skus_locations (CognitiveServicesManager client) {
    System.out.println ("Available SKUs:");
    System.out.println("Kind\tSKU Name\tSKU Tier\tLocations");
    ResourceSkus skus = client.resourceSkus();
    // See https://github.com/ReactiveX/RxJava/wiki/Blocking-Observable-Operators
    for (ResourceSku sku : skus.listAsync().toBlocking().toIterable()) {
        String locations = String.join (",", sku.locations());
        System.out.println (sku.kind() + "\t" + sku.name() + "\t" + sku.tier() + "\t" + locations);
    }
}

Você pode acessar os Serviços Cognitivos do Azure por meio de dois recursos diferentes: Um recurso de vários serviços ou um só serviço.You can access Azure Cognitive Services through two different resources: A multi-service resource, or a single-service one.

  • Recurso de vários serviços:Multi-service resource:
    • Acessar vários Serviços Cognitivos do Azure com uma chave e um ponto de extremidade.Access multiple Azure Cognitive Services with a single key and endpoint.
    • Consolida a cobrança dos serviços que você usa.Consolidates billing from the services you use.
  • Recurso de um serviço:Single-service resource:
    • Acesse um só Serviço Cognitivo do Azure com uma chave exclusiva e um ponto de extremidade para cada serviço criado.Access a single Azure Cognitive Service with a unique key and endpoint for each service created.
    • Use a camada gratuita para experimentar o serviço.Use the free tier to try out the service.

Confira abaixo a lista de SKUs e informações de preços.See the list of SKUs and pricing information below.

Vários serviçosMulti-service

ServiçoService TipoKind
Vários serviços.Multiple services. Para saber mais, consulte a página de preços.For more information, see the pricing page. CognitiveServices

VisãoVision

ServiçoService TipoKind
Pesquisa Visual ComputacionalComputer Vision ComputerVision
Visão Personalizada – PrevisãoCustom Vision - Prediction CustomVision.Prediction
Visão Personalizada – TreinamentoCustom Vision - Training CustomVision.Training
FaceFace Face
Reconhecimento de FormuláriosForm Recognizer FormRecognizer
Reconhecimento de Tinta DigitalInk Recognizer InkRecognizer
ServiçoService TipoKind
Sugestão Automática do BingBing Autosuggest Bing.Autosuggest.v7
Pesquisa Personalizada do BingBing Custom Search Bing.CustomSearch
Pesquisa de Entidade do BingBing Entity Search Bing.EntitySearch
Pesquisa do BingBing Search Bing.Search.v7
Verificação Ortográfica do BingBing Spell Check Bing.SpellCheck.v7

FalaSpeech

ServiçoService TipoKind
Serviços de FalaSpeech Services SpeechServices
Reconhecimento de falaSpeech Recognition SpeakerRecognition

IdiomaLanguage

ServiçoService TipoKind
Compreensão de FormulárioForm Understanding FormUnderstanding
LUISLUIS LUIS
QnA MakerQnA Maker QnAMaker
Análise de textoText Analytics TextAnalytics
Tradução de textoText Translation TextTranslation

DecisãoDecision

ServiçoService TipoKind
Detector de AnomaliasAnomaly Detector AnomalyDetector
Content ModeratorContent Moderator ContentModerator
PersonalizadorPersonalizer Personalizer

Tipos de preço e cobrançaPricing tiers and billing

Os tipos de preço (e o valor que é cobrado de você) são baseados no número de transações que você envia usando suas informações de autenticação.Pricing tiers (and the amount you get billed) are based on the number of transactions you send using your authentication information. Cada tipo de preço especifica:Each pricing tier specifies the:

  • o número máximo de transações permitidas por segundo (TPS).maximum number of allowed transactions per second (TPS).
  • os recursos de serviço habilitados no tipo de preço.service features enabled within the pricing tier.
  • o custo de um número predefinido de transações.cost for a predefined number of transactions. Ultrapassar esse número gera um encargo extra, conforme especificado nos detalhes do preço do serviço.Going above this number will cause an extra charge as specified in the pricing details for your service.

Observação

Muitos dos Serviços Cognitivos têm uma camada gratuita que você pode usar para experimentar o serviço.Many of the Cognitive Services have a free tier you can use to try the service. Para usar a camada gratuita, use F0 como a SKU do recurso.To use the free tier, use F0 as the SKU for your resource.

Criar um recurso dos Serviços CognitivosCreate a Cognitive Services resource

Para criar e assinar um recurso dos Serviços Cognitivos, use o método create.To create and subscribe to a new Cognitive Services resource, use the create method. Esse método adiciona um novo recurso que pode ser cobrado ao grupo de recursos que você passa.This method adds a new billable resource to the resource group you pass in. Ao criar o recurso, você precisará saber qual "tipo" de serviço deseja usar, bem como o tipo de preço (ou SKU) desejado e um local do Azure.When creating your new resource, you'll need to know the "kind" of service you want to use, along with its pricing tier (or SKU) and an Azure location. O método a seguir usa todos esses argumentos e cria um recurso.The following method takes all of these as arguments and creates a resource.

public String create_resource (CognitiveServicesManager client, String resourceName, String resourceGroupName, String kind, String skuName, Region region) {
    System.out.println ("Creating resource: " + resourceName + "...");

    CognitiveServicesAccount result = client.accounts().define(resourceName)
        .withRegion(region)
        .withExistingResourceGroup(resourceGroupName)
        .withKind(kind)
        .withSku(new Sku().withName(skuName))
        .create();

    System.out.println ("Resource created.");
    System.out.println ("ID: " + result.id());
    System.out.println ("Provisioning state: " + result.properties().provisioningState().toString());
    System.out.println ();

    return result.id();
}

Exibir os recursosView your resources

Para exibir todos os recursos em sua conta do Azure (em todos os grupos de recursos), use o seguinte método:To view all of the resources under your Azure account (across all resource groups), use the following method:

public void list_resources (CognitiveServicesManager client) {
    System.out.println ("Resources in resource group: " + resourceGroupName);
    // Note Azure resources are also sometimes referred to as accounts.
    Accounts accounts = client.accounts();
    for (CognitiveServicesAccount account : accounts.listByResourceGroupAsync(resourceGroupName).toBlocking().toIterable()) {
        System.out.println ("Kind: " + account.kind ());
        System.out.println ("SKU Name: " + account.sku().name());
        System.out.println ();
    }
}

Excluir um recursoDelete a resource

O método a seguir exclui o recurso especificado do grupo de recursos fornecido.The following method deletes the specified resource from the given resource group.

public void delete_resource (CognitiveServicesManager client, String resourceId) {
    System.out.println ("Deleting resource: " + resourceId + "...");
    client.accounts().deleteByIds (resourceId);
    System.out.println ("Resource deleted.");
    System.out.println ();
}

Veja tambémSee also

Documentação de referência | Código-fonte da biblioteca | Pacote (NPM) | ExemplosReference documentation | Library source code | Package (NPM) | Samples

Pré-requisitosPrerequisites

Criar uma entidade de serviço do AzureCreate an Azure Service Principal

Para que o aplicativo interaja com sua conta do Azure, você precisa de uma entidade de serviço do Azure para gerenciar permissões.To have your application interact with your Azure account, you need an Azure service principal to manage permissions. Siga as instruções em Criar uma entidade de serviço do Azure.Follow the instructions in Create an Azure service principal.

Ao criar uma entidade de serviço, você verá que ela tem um valor secreto, uma ID e uma ID de aplicativo.When you create a service principal, you'll see it has a secret value, an ID, and an application ID. Salve a ID do aplicativo e o segredo em um local temporário para etapas posteriores.Save the application ID and secret to a temporary location for later steps.

Criar um grupo de recursosCreate a resource group

Antes de criar um recurso dos Serviços Cognitivos, sua conta precisa ter um grupo de recursos do Azure para conter o recurso.Before you create a Cognitive Services resource, your account must have an Azure resource group to contain the resource. Se ainda não tiver um grupo de recursos, crie um no portal do Azure antes de continuar.If you don't already have a resource group, create one in the Azure portal before continuing.

Criar um novo aplicativo do Node.jsCreate a new Node.js application

Em uma janela de console (como cmd, PowerShell ou Bash), crie um novo diretório para seu aplicativo e navegue até ele.In a console window (such as cmd, PowerShell, or Bash), create a new directory for your app, and navigate to it.

mkdir myapp && cd myapp

Execute o comando npm init para criar um aplicativo do Node com um arquivo package.json.Run the npm init command to create a node application with a package.json file.

npm init

Crie um arquivo chamado index.js antes de continuar.Create a file named index.js before going on.

Instalar a biblioteca de clientesInstall the client library

Instale os seguintes pacotes NPM:Install the following NPM packages:

npm install @azure/arm-cognitiveservices
npm install @azure/ms-rest-js
npm install @azure/ms-rest-nodeauth

O arquivo package.json do seu aplicativo será atualizado com as dependências.Your app's package.json file will be updated with the dependencies.

Importar bibliotecasImport libraries

Abra o script index.js e importe as bibliotecas a seguir.Open your index.js script and import the following libraries.

"use strict";
/* To run this sample, install the following modules.
 * npm install @azure/arm-cognitiveservices
 * npm install @azure/ms-rest-js
 * npm install @azure/ms-rest-nodeauth
 */
var Arm = require("@azure/arm-cognitiveservices");
var msRestNodeAuth = require("@azure/ms-rest-nodeauth");

Autenticar o clienteAuthenticate the client

Adicione os campos a seguir à raiz do script e preencha seus valores, usando a entidade de serviço que você criou e as informações de sua conta do Azure.Add the following fields to the root of your script and fill in their values, using the service principal you created and your Azure account information.

const service_principal_application_id = "TODO_REPLACE";
const service_principal_secret = "TODO_REPLACE";

/* The ID of your Azure subscription. You can find this in the Azure Dashboard under Home > Subscriptions. */
const subscription_id = "TODO_REPLACE";

/* The Active Directory tenant ID. You can find this in the Azure Dashboard under Home > Azure Active Directory. */
const tenant_id = "TODO_REPLACE";

/* The name of the Azure resource group in which you want to create the resource.
You can find resource groups in the Azure Dashboard under Home > Resource groups. */
const resource_group_name = "TODO_REPLACE";

Em seguida, adicione a função quickstart a seguir para cuidar do trabalho principal do programa.Next, add the following quickstart function to handle the main work of your program. O primeiro bloco de código constrói um objeto CognitiveServicesManagementClient usando as variáveis de credencial que você inseriu acima.The first block of code constructs a CognitiveServicesManagementClient object using the credential variables you entered above. Esse objeto é necessário para todas as operações de gerenciamento do Azure.This object is needed for all of your Azure management operations.

async function quickstart() {
    const credentials = await msRestNodeAuth.loginWithServicePrincipalSecret (service_principal_application_id, service_principal_secret, tenant_id);
    const client = new Arm.CognitiveServicesManagementClient (credentials, subscription_id);
    // Note Azure resources are also sometimes referred to as accounts.
    const accounts_client = new Arm.Accounts (client);
    const resource_skus_client = new Arm.ResourceSkus (client);

Chamar funções de gerenciamentoCall management functions

Adicione o código a seguir ao final de sua função quickstart para listar os recursos disponíveis, criar um recurso de exemplo, listar os recursos de sua propriedade e excluir o recurso de exemplo.Add the following code to the end of your quickstart function to list available resources, create a sample resource, list your owned resources, and then delete the sample resource. Você definirá essas funções nas etapas a seguir.You'll define these functions in the next steps.

Criar um recurso dos Serviços CognitivosCreate a Cognitive Services resource

Escolher um serviço e um tipo de preçoChoose a service and pricing tier

Ao criar um recurso, você precisará saber qual "tipo" de serviço deseja usar, bem como o tipo de preço (ou SKU) desejado.When you create a new resource, you'll need to know the "kind" of service you want to use, along with the pricing tier (or SKU) you want. Você usará essa e outras informações como parâmetros ao criar o recurso.You'll use this and other information as parameters when creating the resource. A função a seguir lista os "tipos" de Serviços Cognitivos disponíveis.The following function lists the available Cognitive Service "kinds."

async function list_available_kinds_skus_locations (client) {
    console.log ("Available SKUs:");
    var result = await client.list ();
    console.log("Kind\tSKU Name\tSKU Tier\tLocations");
    result.forEach (function (x) {
        var locations = x.locations.join(",");
        console.log(x.kind + "\t" + x.name + "\t" + x.tier + "\t" + locations);
    });
}

Você pode acessar os Serviços Cognitivos do Azure por meio de dois recursos diferentes: Um recurso de vários serviços ou um só serviço.You can access Azure Cognitive Services through two different resources: A multi-service resource, or a single-service one.

  • Recurso de vários serviços:Multi-service resource:
    • Acessar vários Serviços Cognitivos do Azure com uma chave e um ponto de extremidade.Access multiple Azure Cognitive Services with a single key and endpoint.
    • Consolida a cobrança dos serviços que você usa.Consolidates billing from the services you use.
  • Recurso de um serviço:Single-service resource:
    • Acesse um só Serviço Cognitivo do Azure com uma chave exclusiva e um ponto de extremidade para cada serviço criado.Access a single Azure Cognitive Service with a unique key and endpoint for each service created.
    • Use a camada gratuita para experimentar o serviço.Use the free tier to try out the service.

Confira abaixo a lista de SKUs e informações de preços.See the list of SKUs and pricing information below.

Vários serviçosMulti-service

ServiçoService TipoKind
Vários serviços.Multiple services. Para saber mais, consulte a página de preços.For more information, see the pricing page. CognitiveServices

VisãoVision

ServiçoService TipoKind
Pesquisa Visual ComputacionalComputer Vision ComputerVision
Visão Personalizada – PrevisãoCustom Vision - Prediction CustomVision.Prediction
Visão Personalizada – TreinamentoCustom Vision - Training CustomVision.Training
FaceFace Face
Reconhecimento de FormuláriosForm Recognizer FormRecognizer
Reconhecimento de Tinta DigitalInk Recognizer InkRecognizer
ServiçoService TipoKind
Sugestão Automática do BingBing Autosuggest Bing.Autosuggest.v7
Pesquisa Personalizada do BingBing Custom Search Bing.CustomSearch
Pesquisa de Entidade do BingBing Entity Search Bing.EntitySearch
Pesquisa do BingBing Search Bing.Search.v7
Verificação Ortográfica do BingBing Spell Check Bing.SpellCheck.v7

FalaSpeech

ServiçoService TipoKind
Serviços de FalaSpeech Services SpeechServices
Reconhecimento de falaSpeech Recognition SpeakerRecognition

IdiomaLanguage

ServiçoService TipoKind
Compreensão de FormulárioForm Understanding FormUnderstanding
LUISLUIS LUIS
QnA MakerQnA Maker QnAMaker
Análise de textoText Analytics TextAnalytics
Tradução de textoText Translation TextTranslation

DecisãoDecision

ServiçoService TipoKind
Detector de AnomaliasAnomaly Detector AnomalyDetector
Content ModeratorContent Moderator ContentModerator
PersonalizadorPersonalizer Personalizer

Tipos de preço e cobrançaPricing tiers and billing

Os tipos de preço (e o valor que é cobrado de você) são baseados no número de transações que você envia usando suas informações de autenticação.Pricing tiers (and the amount you get billed) are based on the number of transactions you send using your authentication information. Cada tipo de preço especifica:Each pricing tier specifies the:

  • o número máximo de transações permitidas por segundo (TPS).maximum number of allowed transactions per second (TPS).
  • os recursos de serviço habilitados no tipo de preço.service features enabled within the pricing tier.
  • o custo de um número predefinido de transações.cost for a predefined number of transactions. Ultrapassar esse número gera um encargo extra, conforme especificado nos detalhes do preço do serviço.Going above this number will cause an extra charge as specified in the pricing details for your service.

Observação

Muitos dos Serviços Cognitivos têm uma camada gratuita que você pode usar para experimentar o serviço.Many of the Cognitive Services have a free tier you can use to try the service. Para usar a camada gratuita, use F0 como a SKU do recurso.To use the free tier, use F0 as the SKU for your resource.

Criar um recurso dos Serviços CognitivosCreate a Cognitive Services resource

Para criar e assinar um recurso dos Serviços Cognitivos, use a função Criar.To create and subscribe to a new Cognitive Services resource, use the Create function. Essa função adiciona um novo recurso que pode ser cobrado ao grupo de recursos que você passa.This function adds a new billable resource to the resource group you pass in. Ao criar o recurso, você precisará saber qual "tipo" de serviço deseja usar, bem como o tipo de preço (ou SKU) desejado e um local do Azure.When you create your new resource, you'll need to know the "kind" of service you want to use, along with its pricing tier (or SKU) and an Azure location. A função a seguir usa todos esses argumentos e cria um recurso.The following function takes all of these arguments and creates a resource.

function create_resource (client, resource_name, kind, sku_name, location) {
    console.log ("Creating resource: " + resource_name + "...");
    // The parameter "properties" must be an empty object.
    var parameters = { sku : { name: sku_name }, kind : kind, location : location, properties : {} };

    return client.create(resource_group_name, resource_name, parameters)
        .then((result) => {
        console.log("Resource created.");
        print();
        console.log("ID: " + result.id);
        console.log("Kind: " + result.kind);
        console.log();
        })
        .catch((err) =>{ 
                console.log(err)
        })
}

Exibir os recursosView your resources

Para exibir todos os recursos em sua conta do Azure (em todos os grupos de recursos), use a seguinte função:To view all of the resources under your Azure account (across all resource groups), use the following function:

async function list_resources (client) {
    console.log ("Resources in resource group: " + resource_group_name);
    var result = await client.listByResourceGroup (resource_group_name);
    result.forEach (function (x) {
        console.log(x);
        console.log();
    });
}

Excluir um recursoDelete a resource

A função a seguir exclui o recurso especificado do grupo de recursos fornecido.The following function deletes the specified resource from the given resource group.

async function delete_resource (client, resource_name) {
    console.log ("Deleting resource: " + resource_name + "...");
    await client.deleteMethod (resource_group_name, resource_name)
    console.log ("Resource deleted.");
    console.log ();
}

Executar o aplicativoRun the application

Adicione o código a seguir à parte inferior do script para chamar sua função quickstart principal com tratamento de erro.Add the following code to the bottom of your script to call your main quickstart function with error handling.

try {
    quickstart();
}
catch (error) {
    console.log(error);
}

Em seguida, na janela do console, execute o aplicativo com o comando node.Then, in your console window, run the application with the node command.

node index.js

Veja tambémSee also

Documentação de referência | Código-fonte da biblioteca | Pacote (PyPi) | AmostrasReference documentation | Library source code | Package (PyPi) | Samples

Pré-requisitosPrerequisites

Criar uma entidade de serviço do AzureCreate an Azure Service Principal

Para que o aplicativo interaja com sua conta do Azure, você precisa de uma entidade de serviço do Azure para gerenciar permissões.To have your application interact with your Azure account, you need an Azure service principal to manage permissions. Siga as instruções em Criar uma entidade de serviço do Azure.Follow the instructions in Create an Azure service principal.

Ao criar uma entidade de serviço, você verá que ela tem um valor secreto, uma ID e uma ID de aplicativo.When you create a service principal, you'll see it has a secret value, an ID, and an application ID. Salve a ID do aplicativo e o segredo em um local temporário para etapas posteriores.Save the application ID and secret to a temporary location for later steps.

Criar um grupo de recursosCreate a resource group

Antes de criar um recurso dos Serviços Cognitivos, sua conta precisa ter um grupo de recursos do Azure para conter o recurso.Before you create a Cognitive Services resource, your account must have an Azure resource group to contain the resource. Se ainda não tiver um grupo de recursos, crie um no portal do Azure antes de continuar.If you don't already have a resource group, create one in the Azure portal before continuing.

Criar um novo aplicativo PythonCreate a new Python application

Crie um aplicativo Python no editor ou IDE de sua preferência e navegue até o projeto em uma janela de console.Create a new Python application in your preferred editor or IDE and navigate to your project in a console window.

Instalar a biblioteca de clientesInstall the client library

É possível instalar a biblioteca de clientes com:You can install the client library with:

pip install azure-mgmt-cognitiveservices

Se você estiver usando o IDE do Visual Studio, a biblioteca de clientes estará disponível como um pacote baixável do NuGet.If you're using the Visual Studio IDE, the client library is available as a downloadable NuGet package.

Importar bibliotecasImport libraries

Abra o script de Python e importe as bibliotecas a seguir.Open your Python script and import the following libraries.

from msrestazure.azure_active_directory import ServicePrincipalCredentials
from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient
from azure.mgmt.cognitiveservices.models import CognitiveServicesAccount, Sku

Autenticar o clienteAuthenticate the client

Adicione os campos a seguir à raiz do script e preencha seus valores, usando a entidade de serviço que você criou e as informações de sua conta do Azure.Add the following fields to the root of your script and fill in their values, using the service principal you created and your Azure account information.

# Be sure to use the service pricipal application ID, not simply the ID. 
service_principal_application_id = "MY-SERVICE-PRINCIPAL-APPLICATION-ID"
service_principal_secret = "MY-SERVICE-PRINCIPAL-SECRET"

# The ID of your Azure subscription. You can find this in the Azure Dashboard under Home > Subscriptions.
subscription_id = "MY-SUBSCRIPTION-ID"

# The Active Directory tenant ID. You can find this in the Azure Dashboard under Home > Azure Active Directory.
tenant_id = "MY-TENANT-ID"

# The name of the Azure resource group in which you want to create the resource.
# You can find resource groups in the Azure Dashboard under Home > Resource groups.
resource_group_name = "MY-RESOURCE-GROUP"

Em seguida, adicione o código a seguir para construir um objeto CognitiveServicesManagementClient.Then add the following code to construct a CognitiveServicesManagementClient object. Esse objeto é necessário para todas as operações de gerenciamento do Azure.This object is needed for all of your Azure management operations.

credentials = ServicePrincipalCredentials(service_principal_application_id, service_principal_secret, tenant=tenant_id)
client = CognitiveServicesManagementClient(credentials, subscription_id)

Criar um recurso dos Serviços CognitivosCreate a Cognitive Services resource

Escolher um serviço e um tipo de preçoChoose a service and pricing tier

Ao criar um recurso, você precisará saber qual "tipo" de serviço deseja usar, bem como o tipo de preço (ou SKU) desejado.When you create a new resource, you'll need to know the "kind" of service you want to use, along with the pricing tier (or SKU) you want. Você usará essa e outras informações como parâmetros ao criar o recurso.You'll use this and other information as parameters when creating the resource. A função a seguir lista os "tipos" de Serviços Cognitivos disponíveis.The following function lists the available Cognitive Service "kinds."

def list_available_kinds_skus_locations():
    print("Available SKUs:")
    result = client.resource_skus.list()
    print("Kind\tSKU Name\tSKU Tier\tLocations")
    for x in result:
        locations = ",".join(x.locations)
        print(x.kind + "\t" + x.name + "\t" + x.tier + "\t" + locations)

Você pode acessar os Serviços Cognitivos do Azure por meio de dois recursos diferentes: Um recurso de vários serviços ou um só serviço.You can access Azure Cognitive Services through two different resources: A multi-service resource, or a single-service one.

  • Recurso de vários serviços:Multi-service resource:
    • Acessar vários Serviços Cognitivos do Azure com uma chave e um ponto de extremidade.Access multiple Azure Cognitive Services with a single key and endpoint.
    • Consolida a cobrança dos serviços que você usa.Consolidates billing from the services you use.
  • Recurso de um serviço:Single-service resource:
    • Acesse um só Serviço Cognitivo do Azure com uma chave exclusiva e um ponto de extremidade para cada serviço criado.Access a single Azure Cognitive Service with a unique key and endpoint for each service created.
    • Use a camada gratuita para experimentar o serviço.Use the free tier to try out the service.

Confira abaixo a lista de SKUs e informações de preços.See the list of SKUs and pricing information below.

Vários serviçosMulti-service

ServiçoService TipoKind
Vários serviços.Multiple services. Para saber mais, consulte a página de preços.For more information, see the pricing page. CognitiveServices

VisãoVision

ServiçoService TipoKind
Pesquisa Visual ComputacionalComputer Vision ComputerVision
Visão Personalizada – PrevisãoCustom Vision - Prediction CustomVision.Prediction
Visão Personalizada – TreinamentoCustom Vision - Training CustomVision.Training
FaceFace Face
Reconhecimento de FormuláriosForm Recognizer FormRecognizer
Reconhecimento de Tinta DigitalInk Recognizer InkRecognizer
ServiçoService TipoKind
Sugestão Automática do BingBing Autosuggest Bing.Autosuggest.v7
Pesquisa Personalizada do BingBing Custom Search Bing.CustomSearch
Pesquisa de Entidade do BingBing Entity Search Bing.EntitySearch
Pesquisa do BingBing Search Bing.Search.v7
Verificação Ortográfica do BingBing Spell Check Bing.SpellCheck.v7

FalaSpeech

ServiçoService TipoKind
Serviços de FalaSpeech Services SpeechServices
Reconhecimento de falaSpeech Recognition SpeakerRecognition

IdiomaLanguage

ServiçoService TipoKind
Compreensão de FormulárioForm Understanding FormUnderstanding
LUISLUIS LUIS
QnA MakerQnA Maker QnAMaker
Análise de textoText Analytics TextAnalytics
Tradução de textoText Translation TextTranslation

DecisãoDecision

ServiçoService TipoKind
Detector de AnomaliasAnomaly Detector AnomalyDetector
Content ModeratorContent Moderator ContentModerator
PersonalizadorPersonalizer Personalizer

Tipos de preço e cobrançaPricing tiers and billing

Os tipos de preço (e o valor que é cobrado de você) são baseados no número de transações que você envia usando suas informações de autenticação.Pricing tiers (and the amount you get billed) are based on the number of transactions you send using your authentication information. Cada tipo de preço especifica:Each pricing tier specifies the:

  • o número máximo de transações permitidas por segundo (TPS).maximum number of allowed transactions per second (TPS).
  • os recursos de serviço habilitados no tipo de preço.service features enabled within the pricing tier.
  • o custo de um número predefinido de transações.cost for a predefined number of transactions. Ultrapassar esse número gera um encargo extra, conforme especificado nos detalhes do preço do serviço.Going above this number will cause an extra charge as specified in the pricing details for your service.

Observação

Muitos dos Serviços Cognitivos têm uma camada gratuita que você pode usar para experimentar o serviço.Many of the Cognitive Services have a free tier you can use to try the service. Para usar a camada gratuita, use F0 como a SKU do recurso.To use the free tier, use F0 as the SKU for your resource.

Criar um recurso dos Serviços CognitivosCreate a Cognitive Services resource

Para criar e assinar um recurso dos Serviços Cognitivos, use a função Criar.To create and subscribe to a new Cognitive Services resource, use the Create function. Essa função adiciona um novo recurso que pode ser cobrado ao grupo de recursos que você passa.This function adds a new billable resource to the resource group you pass in. Ao criar o recurso, você precisará saber qual "tipo" de serviço deseja usar, bem como o tipo de preço (ou SKU) desejado e um local do Azure.When you create your new resource, you'll need to know the "kind" of service you want to use, along with its pricing tier (or SKU) and an Azure location. A função a seguir usa todos esses argumentos e cria um recurso.The following function takes all of these arguments and creates a resource.

def create_resource (resource_name, kind, sku_name, location):
    print("Creating resource: " + resource_name + "...")
# The parameter "properties" must be an empty object.
    parameters = CognitiveServicesAccount(sku=Sku(name=sku_name), kind=kind, location=location, properties={})
    result = client.accounts.create(resource_group_name, resource_name, parameters)
    print("Resource created.")
    print()
    print("ID: " + result.id)
    print("Name: " + result.name)
    print("Type: " + result.type)
    print()

Exibir os recursosView your resources

Para exibir todos os recursos em sua conta do Azure (em todos os grupos de recursos), use a seguinte função:To view all of the resources under your Azure account (across all resource groups), use the following function:

def list_resources():
    print("Resources in resource group: " + resource_group_name)
    result = client.accounts.list_by_resource_group(resource_group_name)
    for x in result:
        print(x)
        print()

Excluir um recursoDelete a resource

A função a seguir exclui o recurso especificado do grupo de recursos fornecido.The following function deletes the specified resource from the given resource group.

def delete_resource(resource_name) :
    print("Deleting resource: " + resource_name + "...")
    client.accounts.delete(resource_group_name, resource_name)
    print("Resource deleted.")

Chamar funções de gerenciamentoCall management functions

Adicione o código a seguir à parte inferior do script para chamar as funções acima.Add the following code to the bottom of your script to call the above functions. Esse código lista os recursos disponíveis, cria um recurso de exemplo, lista os recursos de sua propriedade e exclui o recurso de exemplo.This code lists available resources, creates a sample resource, lists your owned resources, and then deletes the sample resource.

# Uncomment this to list all available resource kinds, SKUs, and locations for your Azure account.
list_available_kinds_skus_locations()

# Create a resource with kind Text Translation, SKU F0 (free tier), location global.
create_resource("test_resource", "TextTranslation", "F0", "Global")

# Uncomment this to list all resources for your Azure account.
list_resources()

# Delete the resource.
delete_resource("test_resource")

Executar o aplicativoRun the application

Execute o aplicativo na linha de comando com o comando python.Run your application from the command line with the python command.

python <your-script-name>.py

Veja tambémSee also