Buat Namespace

Penting

API ini usang dan dihentikan per 11/1/2021 dan tidak boleh lagi digunakan.

Membuat namespace layanan baru. Setelah dibuat, manifes sumber daya namespace ini tidak dapat diubah. Operasi ini idempotensi.

Pengidentifikasi namespace harus mematuhi konvensi penamaan berikut:

  1. Panjang nama minimal 6 dan maksimal 50 karakter.

  2. Nama cocok dengan regex ^[a-zA-Z][a-zA-Z0-9-]*$ (nama namespace hanya boleh berisi Huruf, angka, tanda hubung "-").

  3. Nama tidak berakhiran "-", "-sb" atau "-mgmt".

  4. Nama ini tersedia melalui panggilan ke provisi, yaitu, nama harus unik di seluruh Azure agar berhasil dibuat.

  5. Nama harus dimulai dengan huruf.

  6. GUID sekarang diizinkan sebagai nama namespace.

Minta

Metode Meminta URI Versi HTTP
PUT https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace namespace} HTTP/1.1

Judul Permintaan

Tabel berikut ini menjelaskan header permintaan yang diperlukan dan opsional.

Header Permintaan Deskripsi
Jenis-Konten Atur ke application/atom+xml.
x-ms-version 2012-03-01

Permintaan ini juga memerlukan sertifikat klien. Sertifikat ini harus cocok dengan sertifikat yang Anda unggah untuk langganan tertentu.

Isi Permintaan

Deskripsi namespace. Lihat Deskripsi Namespace. Hanya Wilayah yang diperlukan; bidang lainnya bersifat opsional.

Respons

Respons mencakup kode status HTTP dan sekumpulan header respons.

Kode Respons

Catatan

Jika Anda membuat namespace dengan nama yang berisi karakter khusus atau dikodekan (misalnya, "uji? Name=value&", yang dikodekan ke "test%3FName%3Dvalue%26"), pengecualian "(400) tidak valid request body" dihasilkan.

Kode Deskripsi
200 Namespace layanan dibuat.
401 Kegagalan otorisasi.
500 Kesalahan internal.

Untuk informasi tentang kode status, lihat Status dan Kode Kesalahan.

Header Respons

Respons untuk operasi ini mencakup header berikut. Respons mungkin juga menyertakan header HTTP standar tambahan. Semua header standar sesuai dengan spesifikasi protokol HTTP/1.1.

Header Respons Deskripsi
Jenis-Konten application/atom+xml; type=entry; charset=utf-8

Isi Respons

Deskripsi Namespace dikembalikan. Jika beberapa properti deskripsi hilang dari permintaan PUT, properti ini mungkin berisi nilai default.