Capacities - Check Name Availability

Servizio:

Power BI Embedded

Versione API:

2021-01-01

Controllare la disponibilità del nome nel percorso di destinazione.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
location	path	True	string	Nome dell'area in cui verrà eseguita la ricerca dell'operazione.
subscriptionId	path	True	string	Identificatore univoco per una sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata al servizio.
api-version	query	True	string	Versione dell'API client.

Corpo della richiesta

Nome	Tipo	Descrizione
name	string minLength: 3 maxLength: 63 pattern: ^[a-z][a-z0-9]*$	Nome per il controllo della disponibilità.
type	string	Tipo di risorsa di PowerBI dedicato.

Risposte

Nome	Tipo	Descrizione
200 OK	CheckCapacityNameAvailabilityResult	OK. La richiesta ha avuto esito positivo.
Other Status Codes	ErrorResponse	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

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 name availability of a capacity

Esempio di richiesta

HTTP

POST https://management.azure.com/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/providers/Microsoft.PowerBIDedicated/locations/West US/checkNameAvailability?api-version=2021-01-01

{
  "name": "azsdktest",
  "type": "Microsoft.PowerBIDedicated/capacities"
}

Risposta di esempio

Codice di stato:

200

{
  "nameAvailable": true
}

Definizioni

Nome	Descrizione
CheckCapacityNameAvailabilityParameters	Dettagli del corpo della richiesta del nome della capacità.
CheckCapacityNameAvailabilityResult	Risultato del controllo della disponibilità del nome della capacità.
Error	Oggetto error
ErrorResponse	Descrive il formato della risposta di errore.

CheckCapacityNameAvailabilityParameters

Object

Dettagli del corpo della richiesta del nome della capacità.

Nome	Tipo	Valore predefinito	Descrizione
name	string minLength: 3 maxLength: 63 pattern: ^[a-z][a-z0-9]*$		Nome per il controllo della disponibilità.
type	string	Microsoft.PowerBIDedicated/capacities	Tipo di risorsa di PowerBI dedicato.

CheckCapacityNameAvailabilityResult

Object

Risultato del controllo della disponibilità del nome della capacità.

Nome	Tipo	Descrizione
message	string	Messaggio dettagliato dell'indisponibilità della richiesta.
nameAvailable	boolean	Indicatore della disponibilità del nome della capacità.
reason	string	Motivo dell'indisponibilità.

Error

Object

Oggetto error

Nome	Tipo	Descrizione
code	string	Codice di errore
message	string	Messaggio di errore che indica il motivo per cui l'operazione non è riuscita.

ErrorResponse

Object

Descrive il formato della risposta di errore.

Nome	Tipo	Descrizione
error	Error	Oggetto error