Periksa Ketersediaan Nama Layanan Cloud

Operasi Check Hosted Service Name Availability memeriksa ketersediaan nama layanan cloud yang ditentukan.

Minta

Permintaan Check Hosted Service Name Availability dapat ditentukan sebagai berikut. Ganti <subscription-id> dengan ID langganan Anda dan <cloudservice-name> dengan nama layanan awan yang ingin Anda gunakan.

Metode	URI Permintaan
GET	`https://management.core.windows.net/<subscription-id>/services/hostedservices/operations/isavailable/<cloudservice-name>`

Parameter URI

Tidak ada.

Judul Permintaan

Tabel berikut ini menjelaskan header permintaan.

Header Permintaan	Deskripsi
`x-ms-version`	Wajib diisi. Menentukan versi operasi yang akan digunakan untuk permintaan ini. Header ini harus diatur ke `2012-03-01` atau lebih tinggi.

Isi Permintaan

Tidak ada.

Respons

Respons mencakup kode status HTTP, sekumpulan header respons, dan isi respons.

Kode Status

Operasi yang berhasil mengembalikan kode status 200 (OK).

Header Respons

Respons untuk operasi ini mencakup header berikut. Respons juga dapat mencakup header HTTP standar tambahan.

Header Respons	Deskripsi
`x-ms-request-id`	Nilai yang secara unik mengidentifikasi permintaan yang dibuat terhadap layanan manajemen.

Isi Respons

Format isi respons adalah sebagai berikut:

  
<?xml version="1.0" encoding="utf-8"?>  
<AvailabilityResponse xmlns=”http://schemas.microsoft.com/windowsazure”>  
  <Result>name-availability</Result>  
  <Reason>reason</Reason>  
</AvailabilityResponse>

Tabel berikut ini menjelaskan elemen dalam isi respons.

Nama elemen Deskripsi

Hasil Nilai boolean yang menunjukkan apakah nama tersedia untuk Anda gunakan. true jika nama tersedia; jika tidak false.

Untuk versi sebelum 2013-03-01, operasi dikembalikan true untuk nama yang tidak diambil meskipun dicadangkan atau tidak sopan. Dengan header versi 2013-03-01 dan yang lebih baru, operasi mengembalikan false kata yang dicadangkan atau tidak fana.

Alasan Menunjukkan mengapa nama tidak dapat digunakan untuk membuat layanan cloud.

Potensi nilai:

- HostedServiceAlreadyExists – dikembalikan jika nama layanan awan sudah ada.
- HostedServiceNameNotValid – dikembalikan jika nama layanan cloud menggunakan karakter yang tidak didukung, kata yang dipesan, atau kata-kata yang tidak fasih.

Elemen Reason ini hanya tersedia menggunakan versi 2013-03-01 atau lebih tinggi.

Nama elemen	Deskripsi
Hasil	Nilai boolean yang menunjukkan apakah nama tersedia untuk Anda gunakan. `true` jika nama tersedia; jika tidak `false`. Untuk versi sebelum 2013-03-01, operasi dikembalikan `true` untuk nama yang tidak diambil meskipun dicadangkan atau tidak sopan. Dengan header versi 2013-03-01 dan yang lebih baru, operasi mengembalikan `false` kata yang dicadangkan atau tidak fana.
Alasan	Menunjukkan mengapa nama tidak dapat digunakan untuk membuat layanan cloud. Potensi nilai: - `HostedServiceAlreadyExists` – dikembalikan jika nama layanan awan sudah ada. - `HostedServiceNameNotValid` – dikembalikan jika nama layanan cloud menggunakan karakter yang tidak didukung, kata yang dipesan, atau kata-kata yang tidak fasih. Elemen `Reason` ini hanya tersedia menggunakan versi 2013-03-01 atau lebih tinggi.

Last updated on 2025-03-28