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 |
---|---|---|---|---|
subscription
|
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 |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
A rendelkezésre állás ellenőrzése sikeresen befejeződött. |
|
Other Status Codes |
Hibaválaszok: ***
|
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
Mintakérelem
Mintaválasz
{
"name": "server1",
"available": false,
"reason": "AlreadyExists",
"message": "Specified server name is already used"
}
Check for a server name that is available
Mintakérelem
Mintaválasz
{
"name": "server1",
"available": true
}
Check for a server name that is invalid
Mintakérelem
Mintaválasz
{
"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 |
---|---|
Check |
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ő. |
Check |
Kérés annak ellenőrzésére, hogy az erőforrás megadott neve elérhető-e. |
Check |
|
Check |
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
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 |
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ő. |