Servers - Check Name Availability
Determina se è possibile creare una risorsa con il nome specificato.
POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Sql/checkNameAvailability?api-version=2021-11-01
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
subscription
|
path | True |
string |
ID sottoscrizione che identifica una sottoscrizione di Azure. |
api-version
|
query | True |
string |
Versione dell'API da usare per la richiesta. |
Corpo della richiesta
Nome | Necessario | Tipo | Descrizione |
---|---|---|---|
name | True |
string |
|
type | True |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Il controllo di disponibilità è stato completato correttamente. |
|
Other Status Codes |
Risposte di errore:
|
Esempio
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
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
Sample Response
{
"name": "server1",
"available": true
}
Check for a server name that is invalid
Sample Request
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."
}
Definizioni
Nome | Descrizione |
---|---|
Check |
Codice motivo che spiega perché il nome non è disponibile. Non sarà definito se il nome è disponibile. |
Check |
Richiesta di verificare se il nome specificato per una risorsa è disponibile. |
Check |
|
Check |
Risultato di un controllo di disponibilità del nome. |
CheckNameAvailabilityReason
Codice motivo che spiega perché il nome non è disponibile. Non sarà definito se il nome è disponibile.
Nome | Tipo | Descrizione |
---|---|---|
AlreadyExists |
string |
|
Invalid |
string |
CheckNameAvailabilityRequest
Richiesta di verificare se il nome specificato per una risorsa è disponibile.
Nome | Tipo | Descrizione |
---|---|---|
name |
string |
|
type |
CheckNameAvailabilityResourceType
Nome | Tipo | Descrizione |
---|---|---|
Microsoft.Sql/servers |
string |
CheckNameAvailabilityResponse
Risultato di un controllo di disponibilità del nome.
Nome | Tipo | Descrizione |
---|---|---|
available |
boolean |
True se il nome è disponibile; in caso contrario, false. |
message |
string |
Messaggio che spiega perché il nome non è disponibile. Non sarà definito se il nome è disponibile. |
name |
string |
Nome di cui è stata verificata la disponibilità. |
reason |
Codice motivo che spiega perché il nome non è disponibile. Non sarà definito se il nome è disponibile. |