Capacities - Check Name Availability

Referenz

Service:: Power BI Embedded

API Version:: 2021-01-01

Überprüfen Sie die Verfügbarkeit des Namens am Zielspeicherort.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
location	path	True	string	Der Regionsname, nach dem der Vorgang sucht.
subscriptionId	path	True	string	Ein eindeutiger Bezeichner für ein Microsoft Azure-Abonnement. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.
api-version	query	True	string	Die Client-API-Version.

Anforderungstext

Name	Typ	Beschreibung
name	string	Name zur Überprüfung der Verfügbarkeit.
type	string	Der Ressourcentyp von PowerBI dedicated.

Antworten

Name	Typ	Beschreibung
200 OK	CheckCapacityNameAvailabilityResult	OK. Die Anforderung wurde erfolgreich durchgeführt.
Other Status Codes	ErrorResponse	Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

Beispiele

Check name availability of a capacity

Sample Request

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

Sample Response

Status code:: 200

{
  "nameAvailable": true
}

Definitionen

Name	Beschreibung
CheckCapacityNameAvailabilityParameters	Details des Anforderungstexts für den Kapazitätsnamen.
CheckCapacityNameAvailabilityResult	Das Überprüfungsergebnis der Verfügbarkeit von Kapazitätsnamen.
Error	Das Fehlerobjekt
ErrorResponse	Beschreibt das Format der Fehlerantwort.

CheckCapacityNameAvailabilityParameters

Details des Anforderungstexts für den Kapazitätsnamen.

Name	Typ	Standardwert	Beschreibung
name	string		Name zur Überprüfung der Verfügbarkeit.
type	string	Microsoft.PowerBIDedicated/capacities	Der Ressourcentyp von PowerBI dedicated.

CheckCapacityNameAvailabilityResult

Das Überprüfungsergebnis der Verfügbarkeit von Kapazitätsnamen.

Name	Typ	Beschreibung
message	string	Die detaillierte Meldung der Nichtverfügbarkeit der Anforderung.
nameAvailable	boolean	Indikator für die Verfügbarkeit des Kapazitätsnamens.
reason	string	Der Grund der Nichtverfügbarkeit.

Error

Das Fehlerobjekt

Name	Typ	Beschreibung
code	string	Fehlercode
message	string	Eine Fehlermeldung, die angibt, warum der Vorgang fehlgeschlagen ist.

ErrorResponse

Beschreibt das Format der Fehlerantwort.

Name	Typ	Beschreibung
error	Error	Das Fehlerobjekt

Share via