Name Availability - Check With Location

Controllare la disponibilità del nome per la risorsa

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.DBforPostgreSQL/locations/{locationName}/checkNameAvailability?api-version=2025-08-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
locationName
path True

string

minLength: 1
pattern: ^[-\w\._]+$

Nome della posizione.

subscriptionId
path True

string (uuid)

ID della sottoscrizione di destinazione. Il valore deve essere un UUID.

api-version
query True

string

minLength: 1

Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome Tipo Descrizione
name

string

Nome della risorsa per cui deve essere verificata la disponibilità.

type

string

Tipo di risorsa.

Risposte

Nome Tipo Descrizione
200 OK

NameAvailabilityModel

La richiesta ha avuto esito positivo.

Other Status Codes

ErrorResponse

Risposta di errore imprevista.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

Check the validity and availability of the given name, in the given location, to assign it to a new server or to use it as the base name of a new pair of virtual endpoints

Esempio di richiesta

POST https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforPostgreSQL/locations/eastus/checkNameAvailability?api-version=2025-08-01

{
  "name": "exampleserver",
  "type": "Microsoft.DBforPostgreSQL/flexibleServers"
}

Risposta di esempio

{
  "name": "exampleserver",
  "type": "Microsoft.DBforPostgreSQL/flexibleServers",
  "message": "",
  "nameAvailable": true
}

Definizioni

Nome Descrizione
CheckNameAvailabilityReason

Motivo per cui il nome specificato non è disponibile.

CheckNameAvailabilityRequest

Corpo della richiesta di disponibilità del controllo.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

NameAvailabilityModel

Disponibilità di un nome.

CheckNameAvailabilityReason

Motivo per cui il nome specificato non è disponibile.

Valore Descrizione
Invalid
AlreadyExists

CheckNameAvailabilityRequest

Corpo della richiesta di disponibilità del controllo.

Nome Tipo Descrizione
name

string

Nome della risorsa per cui deve essere verificata la disponibilità.

type

string

Tipo di risorsa.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorDetail[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.

NameAvailabilityModel

Disponibilità di un nome.

Nome Tipo Descrizione
message

string

Motivo dettagliato per cui il nome specificato è disponibile.

name

string

Nome per il quale è stata verificata validità e disponibilità.

nameAvailable

boolean

Indica se il nome della risorsa è disponibile.

reason

CheckNameAvailabilityReason

Motivo per cui il nome specificato non è disponibile.

type

string

Tipo di risorsa. Può essere 'Microsoft.DBforPostgreSQL/flexibleServers' oppure 'Microsoft.DBforPostgreSQL/flexibleServers/virtualendpoints'.