Locations - Check Name Availability

Service:

Media Services

API Version:

2023-01-01

Comprueba la disponibilidad del nombre
Comprueba si el nombre del recurso de Media Service está disponible.

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Media/locations/{locationName}/checkNameAvailability?api-version=2023-01-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
locationName	path	True	string	Nombre de la ubicación.
subscriptionId	path	True	string	Identificador único de una suscripción de Microsoft Azure.
api-version	query	True	string	Versión de la API que se va a usar con la solicitud de cliente.

Cuerpo de la solicitud

Nombre	Tipo	Description
name	string	El nombre de la cuenta.
type	string	Tipo de cuenta. Para una cuenta de Media Services, debe ser "MediaServices".

Respuestas

Nombre	Tipo	Description
200 OK	EntityNameAvailabilityCheckOutput	Aceptar
Other Status Codes	ErrorResponse	Información detallada del error.

Ejemplos

Check Name Availability

Sample Request

HTTP

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Media/locations/japanwest/checkNameAvailability?api-version=2023-01-01

{
  "name": "contosotv",
  "type": "Microsoft.Media/mediaservices"
}

Java

import com.azure.resourcemanager.mediaservices.models.CheckNameAvailabilityInput;

/** Samples for Locations CheckNameAvailability. */
public final class Main {
    /*
     * x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/Accounts/stable/2023-01-01/examples/accounts-check-name-availability.json
     */
    /**
     * Sample code: Check Name Availability.
     *
     * @param manager Entry point to MediaServicesManager.
     */
    public static void checkNameAvailability(com.azure.resourcemanager.mediaservices.MediaServicesManager manager) {
        manager
            .locations()
            .checkNameAvailabilityWithResponse(
                "japanwest",
                new CheckNameAvailabilityInput().withName("contosotv").withType("Microsoft.Media/mediaservices"),
                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

dotnet

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

// Generated from example definition: specification/mediaservices/resource-manager/Microsoft.Media/Accounts/stable/2023-01-01/examples/accounts-check-name-availability.json
// this example is just showing the usage of "Locations_CheckNameAvailability" 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-0000-0000-0000-000000000000";
ResourceIdentifier subscriptionResourceId = SubscriptionResource.CreateResourceIdentifier(subscriptionId);
SubscriptionResource subscriptionResource = client.GetSubscriptionResource(subscriptionResourceId);

// invoke the operation
AzureLocation locationName = new AzureLocation("japanwest");
MediaServicesNameAvailabilityContent content = new MediaServicesNameAvailabilityContent()
{
    Name = "contosotv",
    ResourceType = "Microsoft.Media/mediaservices",
};
MediaServicesNameAvailabilityResult result = await subscriptionResource.CheckMediaServicesNameAvailabilityAsync(locationName, content);

Console.WriteLine($"Succeeded: {result}");

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

Sample Response

Status code:

200

{
  "nameAvailable": true,
  "reason": "None",
  "message": ""
}

Definiciones

Nombre	Description
CheckNameAvailabilityInput	Entrada de la solicitud de disponibilidad check name.
EntityNameAvailabilityCheckOutput	Respuesta de la solicitud de disponibilidad check name.
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta de error

CheckNameAvailabilityInput

Entrada de la solicitud de disponibilidad check name.

Nombre	Tipo	Description
name	string	El nombre de la cuenta.
type	string	Tipo de cuenta. Para una cuenta de Media Services, debe ser "MediaServices".

EntityNameAvailabilityCheckOutput

Respuesta de la solicitud de disponibilidad check name.

Nombre	Tipo	Description
message	string	Especifica el motivo detallado si el nombre no está disponible.
nameAvailable	boolean	Especifica si el nombre está disponible.
reason	string	Especifica el motivo si el nombre no está disponible.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre	Tipo	Description
info	object	Información adicional.
type	string	Tipo de información adicional.

ErrorDetail

Detalle del error.

Nombre	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
details	ErrorDetail[]	Los detalles del error.
message	string	El mensaje de error.
target	string	Destino del error.

ErrorResponse

Respuesta de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.