Capacities - Check Name Availability

Servicio:

Power BI Embedded

Versión de la API:

2021-01-01

Compruebe la disponibilidad del nombre en la ubicación de destino.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
location	path	True	string	Nombre de región en el que se buscará la operación.
subscriptionId	path	True	string	Identificador único de una suscripción de Microsoft Azure. El identificador de suscripción forma parte del URI para cada llamada al servicio.
api-version	query	True	string	La versión de la API de cliente.

Cuerpo de la solicitud

Nombre	Tipo	Description
name	string	Nombre para comprobar la disponibilidad.
type	string	Tipo de recurso de PowerBI dedicado.

Respuestas

Nombre	Tipo	Description
200 OK	CheckCapacityNameAvailabilityResult	Aceptar. La solicitud se ha realizado correctamente.
Other Status Codes	ErrorResponse	Respuesta de error que describe el motivo del error de la operación.

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantación de su cuenta de usuario

Ejemplos

Check name availability of a capacity

Solicitud de ejemplo

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

Respuesta de muestra

status code:

200

{
  "nameAvailable": true
}

Definiciones

Nombre	Description
CheckCapacityNameAvailabilityParameters	Detalles del cuerpo de la solicitud de nombre de capacidad.
CheckCapacityNameAvailabilityResult	Resultado de la comprobación de la disponibilidad del nombre de capacidad.
Error	Objeto de error
ErrorResponse	Describe el formato de respuesta de error.

CheckCapacityNameAvailabilityParameters

Detalles del cuerpo de la solicitud de nombre de capacidad.

Nombre	Tipo	Valor predeterminado	Description
name	string		Nombre para comprobar la disponibilidad.
type	string	Microsoft.PowerBIDedicated/capacities	Tipo de recurso de PowerBI dedicado.

CheckCapacityNameAvailabilityResult

Resultado de la comprobación de la disponibilidad del nombre de capacidad.

Nombre	Tipo	Description
message	string	Mensaje detallado de la falta de disponibilidad de la solicitud.
nameAvailable	boolean	Indicador de disponibilidad del nombre de la capacidad.
reason	string	Motivo de falta de disponibilidad.

Error

Objeto de error

Nombre	Tipo	Description
code	string	Código de error
message	string	Mensaje de error que indica por qué se produjo un error en la operación.

ErrorResponse

Describe el formato de respuesta de error.

Nombre	Tipo	Description
error	Error	Objeto de error