Check Sku Availability - Check Sku Availability

Serviço:: AI Foundry

Versão da API:: 2025-06-01

Verifique os SKUs disponíveis.

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.CognitiveServices/locations/{location}/checkSkuAvailability?api-version=2025-06-01

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
location	path	True	string	Localização do recurso.
subscriptionId	path	True	string minLength: 1	A ID da assinatura de destino.
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.

Corpo do Pedido

Name	Necessário	Tipo	Description
kind	True	string	O tipo (tipo) de conta de serviço cognitivo.
skus	True	string[]	O SKU do recurso.
type	True	string	O Tipo do recurso.

Respostas

Name	Tipo	Description
200 OK	SkuAvailabilityListResult	OK.
Other Status Codes	ErrorResponse	Resposta de erro descrevendo por que a operação falhou.

Exemplos

Check SKU Availability

Pedido de amostra

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.CognitiveServices/locations/westus/checkSkuAvailability?api-version=2025-06-01

{
  "skus": [
    "S0"
  ],
  "kind": "Face",
  "type": "Microsoft.CognitiveServices/accounts"
}


import com.azure.resourcemanager.cognitiveservices.models.CheckSkuAvailabilityParameter;
import java.util.Arrays;

/**
 * Samples for ResourceProvider CheckSkuAvailability.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2025-06-01/examples/
     * CheckSkuAvailability.json
     */
    /**
     * Sample code: Check SKU Availability.
     * 
     * @param manager Entry point to CognitiveServicesManager.
     */
    public static void
        checkSKUAvailability(com.azure.resourcemanager.cognitiveservices.CognitiveServicesManager manager) {
        manager.resourceProviders()
            .checkSkuAvailabilityWithResponse("westus", new CheckSkuAvailabilityParameter()
                .withSkus(Arrays.asList("S0")).withKind("Face").withType("Microsoft.CognitiveServices/accounts"),
                com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armcognitiveservices_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/cognitiveservices/armcognitiveservices/v2"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/1004eed4202d64b48157c084fe2830760f8190f4/specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2025-06-01/examples/CheckSkuAvailability.json
func ExampleManagementClient_CheckSKUAvailability() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcognitiveservices.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewManagementClient().CheckSKUAvailability(ctx, "westus", armcognitiveservices.CheckSKUAvailabilityParameter{
		Type: to.Ptr("Microsoft.CognitiveServices/accounts"),
		Kind: to.Ptr("Face"),
		SKUs: []*string{
			to.Ptr("S0")},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.SKUAvailabilityListResult = armcognitiveservices.SKUAvailabilityListResult{
	// 	Value: []*armcognitiveservices.SKUAvailability{
	// 		{
	// 			Type: to.Ptr("Microsoft.CognitiveServices/accounts"),
	// 			Kind: to.Ptr("Face"),
	// 			SKUAvailable: to.Ptr(true),
	// 			SKUName: to.Ptr("S0"),
	// 	}},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { CognitiveServicesManagementClient } = require("@azure/arm-cognitiveservices");
const { DefaultAzureCredential } = require("@azure/identity");
require("dotenv/config");

/**
 * This sample demonstrates how to Check available SKUs.
 *
 * @summary Check available SKUs.
 * x-ms-original-file: specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2025-06-01/examples/CheckSkuAvailability.json
 */
async function checkSkuAvailability() {
  const subscriptionId =
    process.env["COGNITIVESERVICES_SUBSCRIPTION_ID"] || "00000000-1111-2222-3333-444444444444";
  const location = "westus";
  const skus = ["S0"];
  const kind = "Face";
  const typeParam = "Microsoft.CognitiveServices/accounts";
  const credential = new DefaultAzureCredential();
  const client = new CognitiveServicesManagementClient(credential, subscriptionId);
  const result = await client.checkSkuAvailability(location, skus, kind, typeParam);
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.CognitiveServices.Models;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.CognitiveServices;

// Generated from example definition: specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices/stable/2025-06-01/examples/CheckSkuAvailability.json
// this example is just showing the usage of "CheckSkuAvailability" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this SubscriptionResource created on azure
// for more information of creating SubscriptionResource, please refer to the document of SubscriptionResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
ResourceIdentifier subscriptionResourceId = SubscriptionResource.CreateResourceIdentifier(subscriptionId);
SubscriptionResource subscriptionResource = client.GetSubscriptionResource(subscriptionResourceId);

// invoke the operation and iterate over the result
AzureLocation location = new AzureLocation("westus");
CognitiveServicesSkuAvailabilityContent content = new CognitiveServicesSkuAvailabilityContent(new string[] { "S0" }, "Face", new ResourceType("Microsoft.CognitiveServices/accounts"));
await foreach (CognitiveServicesSkuAvailabilityList item in subscriptionResource.CheckSkuAvailabilityAsync(location, content))
{
    Console.WriteLine($"Succeeded: {item}");
}

Console.WriteLine("Succeeded");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Resposta da amostra

Código de estado:: 200

{
  "value": [
    {
      "kind": "Face",
      "type": "Microsoft.CognitiveServices/accounts",
      "skuName": "S0",
      "skuAvailable": true,
      "reason": null,
      "message": null
    }
  ]
}

Definições

Name	Description
CheckSkuAvailabilityParameter	Verifique o parâmetro de disponibilidade de SKU.
ErrorAdditionalInfo	O erro de gerenciamento de recursos informações adicionais.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
SkuAvailability	Disponibilidade de SKU.
SkuAvailabilityListResult	Verifique a lista de resultados de disponibilidade de SKU.

CheckSkuAvailabilityParameter

Object

Verifique o parâmetro de disponibilidade de SKU.

Name	Tipo	Description
kind	string	O tipo (tipo) de conta de serviço cognitivo.
skus	string[]	O SKU do recurso.
type	string	O Tipo do recurso.

ErrorAdditionalInfo

Object

O erro de gerenciamento de recursos informações adicionais.

Name	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Object

O detalhe do erro.

Name	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	O erro informações adicionais.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Object

Resposta de erro

Name	Tipo	Description
error	ErrorDetail	O objeto de erro.

SkuAvailability

Object

Disponibilidade de SKU.

Name	Tipo	Description
kind	string	O tipo do recurso.
message	string	Mensagem de erro adicional.
reason	string	Razão pela qual o SKU não está disponível.
skuAvailable	boolean	Indica que o SKU fornecido está disponível ou não.
skuName	string	A conta SKU dos Serviços Cognitivos.
type	string	O Tipo do recurso.

SkuAvailabilityListResult

Object

Verifique a lista de resultados de disponibilidade de SKU.

Name	Tipo	Description
value	SkuAvailability[]	Verifique a lista de resultados de disponibilidade de SKU.

Partilhar via

Check Sku Availability - Check Sku Availability

Parâmetros do URI

Corpo do Pedido

Respostas

Exemplos

Check SKU Availability

Pedido de amostra

Resposta da amostra

Definições

CheckSkuAvailabilityParameter

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

SkuAvailability

SkuAvailabilityListResult