Servers - Check Name Availability

Hizmet:

SQL Database

API Sürümü:

2014-04-01

Bir kaynağın belirtilen adla oluşturulup oluşturulamayacağını belirler.

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Sql/checkNameAvailability?api-version=2014-04-01

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
subscriptionId	path	True	string	bir Azure aboneliği tanımlayan abonelik kimliği.
api-version	query	True	string	İstek için kullanılacak API sürümü.

İstek Gövdesi

Name	Tür	Description
parameters	CheckNameAvailabilityRequest	İsim uygunluğunu talep etmek için parametreler.

Yanıtlar

Name	Tür	Description
200 OK	CheckNameAvailabilityResponse	Tamam

Örnekler

Check for a server name that already exists

Check for a server name that is available

Check for a server name that is invalid

Check for a server name that already exists

Örnek isteği

HTTP

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/checkNameAvailability?api-version=2014-04-01

{
  "name": "server1",
  "type": "Microsoft.Sql/servers"
}

Örnek yanıt

Durum kodu:

200

{
  "name": "server1",
  "available": false,
  "reason": "AlreadyExists",
  "message": "Specified server name is already used"
}

Check for a server name that is available

Örnek isteği

HTTP

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/checkNameAvailability?api-version=2014-04-01

{
  "name": "server1",
  "type": "Microsoft.Sql/servers"
}

Örnek yanıt

Durum kodu:

200

{
  "name": "server1",
  "available": true,
  "reason": null,
  "message": null
}

Check for a server name that is invalid

Örnek isteği

HTTP

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/checkNameAvailability?api-version=2014-04-01

{
  "name": "SERVER1",
  "type": "Microsoft.Sql/servers"
}

Örnek yanıt

Durum kodu:

200

{
  "name": "SERVER1",
  "available": false,
  "reason": "Invalid",
  "message": "Specified server name contains unsupported characters or is too long. Server name must be no longer than 63 characters long, contain only lower-case characters or digits, cannot contain '.' or '_' characters and can't start or end with '-' character."
}

Tanımlar

Name	Description
CheckNameAvailabilityReason	Adın neden kullanılamadığı açıklayan neden kodu. Ad mevcutsa null olacaktır.
CheckNameAvailabilityRequest	İsim uygunluğunu talep etmek için parametreler.
CheckNameAvailabilityResourceType	Kullanılabilirlik denetiminin kapsamı olarak kullanılan kaynak türü.
CheckNameAvailabilityResponse	Bir kaynağın belirtilen isminin mevcut olup olmadığını belirten bir yanıt.

CheckNameAvailabilityReason

Numaralandırma

Adın neden kullanılamadığı açıklayan neden kodu. Ad mevcutsa null olacaktır.

Değer	Description
Invalid
AlreadyExists

CheckNameAvailabilityRequest

Nesne

İsim uygunluğunu talep etmek için parametreler.

Name	Tür	Description
name	string	Müsaitliği kontrol edilecek isim.
type	CheckNameAvailabilityResourceType	Kullanılabilirlik denetiminin kapsamı olarak kullanılan kaynak türü.

CheckNameAvailabilityResourceType

Numaralandırma

Kullanılabilirlik denetiminin kapsamı olarak kullanılan kaynak türü.

Değer	Description
Microsoft.Sql/servers

CheckNameAvailabilityResponse

Nesne

Bir kaynağın belirtilen isminin mevcut olup olmadığını belirten bir yanıt.

Name	Tür	Description
available	boolean	Ad kullanılabiliyorsa True, aksi takdirde false.
message	string	Adın neden kullanılamadığıyla ilgili bir ileti. Ad mevcutsa null olacaktır.
name	string	Kullanılabilirliği denetlenen ad.
reason	CheckNameAvailabilityReason	Adın neden kullanılamadığı açıklayan neden kodu. Ad mevcutsa null olacaktır.