Locations - Check Name Availability

Service:

Media Services

API Version:

2023-01-01

Név rendelkezésre állásának ellenőrzése
Ellenőrzi, hogy a Media Service-erőforrásnév elérhető-e.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
locationName	path	True	string	Hely neve.
subscriptionId	path	True	string	A Microsoft Azure-előfizetés egyedi azonosítója.
api-version	query	True	string	Az ügyfélkéréshez használni kívánt API verziója.

Kérelem törzse

Name	Típus	Description
name	string	A fiók neve.
type	string	A fiók típusa. Media Services-fiók esetén ennek a "MediaServices" (MediaServices) fióknak kell lennie.

Válaszok

Name	Típus	Description
200 OK	EntityNameAvailabilityCheckOutput	OK
Other Status Codes	ErrorResponse	Részletes hibainformációk.

Példák

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": ""
}

Definíciók

Name	Description
CheckNameAvailabilityInput	Az ellenőrzőnév rendelkezésre állási kérésének bemenete.
EntityNameAvailabilityCheckOutput	Az ellenőrzőnév rendelkezésre állási kérésének válasza.
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Hibaválasz

CheckNameAvailabilityInput

Az ellenőrzőnév rendelkezésre állási kérésének bemenete.

Name	Típus	Description
name	string	A fiók neve.
type	string	A fiók típusa. Media Services-fiók esetén ennek a "MediaServices" (MediaServices) fióknak kell lennie.

EntityNameAvailabilityCheckOutput

Az ellenőrzőnév rendelkezésre állási kérésének válasza.

Name	Típus	Description
message	string	Megadja a részletes okot, ha a név nem érhető el.
nameAvailable	boolean	Megadja, hogy a név elérhető-e.
reason	string	Megadja az okot, ha a név nem érhető el.

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

Name	Típus	Description
info	object	A további információk.
type	string	A további adattípus.

ErrorDetail

A hiba részletei.

Name	Típus	Description
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorDetail[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hiba célja.

ErrorResponse

Hibaválasz

Name	Típus	Description
error	ErrorDetail	A hibaobjektum.