Servers - Check Name Availability

Meghatározza, hogy létre lehet-e hozni egy erőforrást a megadott névvel.

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

URI-paraméterek

Name In Kötelező Típus Description
subscriptionId
path True

string

Az Azure-előfizetést azonosító előfizetés-azonosító.

api-version
query True

string

A kéréshez használandó API-verzió.

Kérelem törzse

Name Kötelező Típus Description
name True

string

type True

CheckNameAvailabilityResourceType

Válaszok

Name Típus Description
200 OK

CheckNameAvailabilityResponse

A rendelkezésre állás ellenőrzése sikeresen befejeződött.

Other Status Codes

Hibaválaszok: ***

  • 400 InvalidNameAvailabilityRequest – Az ellenőrzőnév rendelkezésre állási kérése érvénytelen.

  • 400 UnknownNameType – Az előfizetési szintű név rendelkezésre állásának ellenőrzéséhez megadott ismeretlen erőforrástípus.

Példák

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

Sample Request

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

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

Sample Response

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

Check for a server name that is available

Sample Request

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

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

Sample Response

{
  "name": "server1",
  "available": true
}

Check for a server name that is invalid

Sample Request

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

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

Sample Response

{
  "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."
}

Definíciók

Name Description
CheckNameAvailabilityReason

Az okkód, amely azt ismerteti, hogy miért nem érhető el a név. A név nem lesz definiálva, ha a név elérhető.

CheckNameAvailabilityRequest

Kérés annak ellenőrzésére, hogy az erőforrás megadott neve elérhető-e.

CheckNameAvailabilityResourceType
CheckNameAvailabilityResponse

A név rendelkezésre állásának ellenőrzése.

CheckNameAvailabilityReason

Az okkód, amely azt ismerteti, hogy miért nem érhető el a név. A név nem lesz definiálva, ha a név elérhető.

Name Típus Description
AlreadyExists

string

Invalid

string

CheckNameAvailabilityRequest

Kérés annak ellenőrzésére, hogy az erőforrás megadott neve elérhető-e.

Name Típus Description
name

string

type

CheckNameAvailabilityResourceType

CheckNameAvailabilityResourceType

Name Típus Description
Microsoft.Sql/servers

string

CheckNameAvailabilityResponse

A név rendelkezésre állásának ellenőrzése.

Name Típus Description
available

boolean

Igaz, ha a név elérhető, egyébként hamis.

message

string

Egy üzenet, amely ismerteti, hogy miért nem érhető el a név. A név nem lesz definiálva, ha a név elérhető.

name

string

Annak a névnek a neve, amelynek rendelkezésre állását ellenőrizték.

reason

CheckNameAvailabilityReason

Az okkód, amely azt ismerteti, hogy miért nem érhető el a név. A név nem lesz definiálva, ha a név elérhető.