Aracılığıyla paylaş


Communication Services - Check Name Availability

Ad Kullanılabilirliğini Denetle
CommunicationService adının geçerli olduğunu ve kullanımda olmadığını denetler.

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Communication/checkNameAvailability?api-version=2023-03-31

URI Parametreleri

Name İçinde Gerekli Tür Description
subscriptionId
path True

string

uuid

Hedef aboneliğin kimliği. Değer bir UUID olmalıdır.

api-version
query True

string

Bu işlem için kullanılacak API sürümü.

İstek Gövdesi

Name Gerekli Tür Description
name True

string

Kullanılabilirliğinin denetlenmesi gereken kaynağın adı.

type True

string

Kaynak türü.

Yanıtlar

Name Tür Description
200 OK

CheckNameAvailabilityResponse

Başarılı. Yanıtta ad kullanılabilirliği açıklanır.

Other Status Codes

ErrorResponse

İşlemin neden başarısız olduğunu açıklayan hata yanıtı.

Örnekler

Check name availability available
Check name availability unavailable

Check name availability available

Örnek isteği

POST https://management.azure.com/subscriptions/11112222-3333-4444-5555-666677778888/providers/Microsoft.Communication/checkNameAvailability?api-version=2023-03-31

{
  "type": "Microsoft.Communication/CommunicationServices",
  "name": "MyCommunicationService"
}

Örnek yanıt

{
  "nameAvailable": true,
  "reason": "NameAvailable",
  "message": "Requested name is available for the requested type"
}

Check name availability unavailable

Örnek isteği

POST https://management.azure.com/subscriptions/11112222-3333-4444-5555-666677778888/providers/Microsoft.Communication/checkNameAvailability?api-version=2023-03-31

{
  "type": "Microsoft.Communication/CommunicationServices",
  "name": "MyCommunicationService"
}

Örnek yanıt

{
  "nameAvailable": false,
  "reason": "AlreadyExists",
  "message": "Requested name is unavailable for the requested type"
}

Tanımlar

Name Description
CheckNameAvailabilityReason

Verilen adın kullanılamama nedeni.

CheckNameAvailabilityResponse

Kullanılabilirlik sonucunu denetleyin.

ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.

ErrorDetail

Hata ayrıntısı.

ErrorResponse

Hata yanıtı

NameAvailabilityParameters

NameAvailability eylemine post-ed verileri

CheckNameAvailabilityReason

Verilen adın kullanılamama nedeni.

Name Tür Description
AlreadyExists

string

Invalid

string

CheckNameAvailabilityResponse

Kullanılabilirlik sonucunu denetleyin.

Name Tür Description
message

string

Verilen adın kullanılabilir olmasının ayrıntılı nedeni.

nameAvailable

boolean

Kaynak adının kullanılabilir olup olmadığını gösterir.

reason

CheckNameAvailabilityReason

Verilen adın kullanılamama nedeni.

ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.

Name Tür Description
info

object

Ek bilgiler.

type

string

Ek bilgi türü.

ErrorDetail

Hata ayrıntısı.

Name Tür Description
additionalInfo

ErrorAdditionalInfo[]

Hata ek bilgileri.

code

string

Hata kodu.

details

ErrorDetail[]

Hata ayrıntıları.

message

string

Hata iletisi.

target

string

Hata hedefi.

ErrorResponse

Hata yanıtı

Name Tür Description
error

ErrorDetail

Hata nesnesi.

NameAvailabilityParameters

NameAvailability eylemine post-ed verileri

Name Tür Description
name

string

Kullanılabilirliğinin denetlenmesi gereken kaynağın adı.

type

string

Kaynak türü.