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-02-01-preview

Parametri dell'URI

Name In Required Type Description
subscriptionId
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

Name Required Type Description
name True
  • string
type True

Risposte

Name Type Description
200 OK

Completato correttamente il controllo di disponibilità.

Other Status Codes

Risposte agli errori: **

  • 400 InvalidNameAvailabilityRequest: la richiesta di disponibilità del nome di controllo non è valida.

  • 400 UnknownNameType - Tipo di risorsa sconosciuto specificato per un controllo di disponibilità del nome a livello di sottoscrizione.

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

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

{
  "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-02-01-preview

{
  "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-02-01-preview

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

Definizioni

CheckNameAvailabilityReason

Codice motivo che spiega perché il nome non è disponibile. Verrà non definito se il nome è disponibile.

CheckNameAvailabilityRequest

Richiesta di verificare se il nome specificato per una risorsa è disponibile.

CheckNameAvailabilityResourceType
CheckNameAvailabilityResponse

Risultato di un controllo di disponibilità del nome.

CheckNameAvailabilityReason

Codice motivo che spiega perché il nome non è disponibile. Verrà non definito se il nome è disponibile.

Name Type Description
AlreadyExists
  • string
Invalid
  • string

CheckNameAvailabilityRequest

Richiesta di verificare se il nome specificato per una risorsa è disponibile.

Name Type Description
name
  • string
type

CheckNameAvailabilityResourceType

Name Type Description
Microsoft.Sql/servers
  • string

CheckNameAvailabilityResponse

Risultato di un controllo di disponibilità del nome.

Name Type Description
available
  • boolean

True se il nome è disponibile, in caso contrario false.

message
  • string

Messaggio che spiega perché il nome non è disponibile. Verrà non definito se il nome è disponibile.

name
  • string

Nome la cui disponibilità è stata verificata.

reason

Codice motivo che spiega perché il nome non è disponibile. Verrà non definito se il nome è disponibile.