Locations - Check Name Availability

Service:

Media Services

API Version:

2023-01-01

Memeriksa Ketersediaan Nama
Memeriksa apakah nama sumber daya Media Service tersedia.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
locationName	path	True	string	Nama lokasi.
subscriptionId	path	True	string	Pengidentifikasi unik untuk langganan Microsoft Azure.
api-version	query	True	string	Versi API yang akan digunakan dengan permintaan klien.

Isi Permintaan

Nama	Jenis	Deskripsi
name	string	Nama akun.
type	string	Jenis akun. Untuk akun Media Services, ini harus 'MediaServices'.

Respons

Nama	Jenis	Deskripsi
200 OK	EntityNameAvailabilityCheckOutput	OK
Other Status Codes	ErrorResponse	Informasi kesalahan terperinci.

Contoh

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

Definisi

Nama	Deskripsi
CheckNameAvailabilityInput	Input ke permintaan ketersediaan nama pemeriksaan.
EntityNameAvailabilityCheckOutput	Respons dari permintaan ketersediaan nama pemeriksaan.
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Respons kesalahan

CheckNameAvailabilityInput

Input ke permintaan ketersediaan nama pemeriksaan.

Nama	Jenis	Deskripsi
name	string	Nama akun.
type	string	Jenis akun. Untuk akun Media Services, ini harus 'MediaServices'.

EntityNameAvailabilityCheckOutput

Respons dari permintaan ketersediaan nama pemeriksaan.

Nama	Jenis	Deskripsi
message	string	Menentukan alasan terperinci jika nama tidak tersedia.
nameAvailable	boolean	Menentukan apakah nama tersebut tersedia.
reason	string	Menentukan alasan jika nama tidak tersedia.

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Detail kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

ErrorResponse

Respons kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.