Capacities - Check Name Availability

Служба:: Power BI Embedded

Версия API:: 2021-01-01

Проверьте доступность имени в целевом расположении.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
location	path	True	string minLength: 1	Имя региона Azure.
subscriptionId	path	True	string minLength: 1	Идентификатор целевой подписки.
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.

Текст запроса

Имя	Тип	Описание
name	string minLength: 3 maxLength: 63 pattern: ^[a-z][a-z0-9]*$	Имя проверки доступности.
type	string	Тип ресурса выделенного powerBI.

Ответы

Имя	Тип	Описание
200 OK	CheckCapacityNameAvailabilityResult	Запрос выполнен успешно.
Other Status Codes	ErrorResponse	Непредвиденное сообщение об ошибке.

Безопасность

azure_auth

Поток OAuth2 Azure Active Directory.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

Check name availability of a capacity

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


import com.azure.resourcemanager.powerbidedicated.models.CheckCapacityNameAvailabilityParameters;

/**
 * Samples for Capacities CheckNameAvailability.
 */
public final class Main {
    /*
     * x-ms-original-file: 2021-01-01/checkNameAvailability.json
     */
    /**
     * Sample code: Check name availability of a capacity.
     * 
     * @param manager Entry point to PowerBIDedicatedManager.
     */
    public static void
        checkNameAvailabilityOfACapacity(com.azure.resourcemanager.powerbidedicated.PowerBIDedicatedManager manager) {
        manager.capacities()
            .checkNameAvailabilityWithResponse("West US", new CheckCapacityNameAvailabilityParameters()
                .withName("azsdktest").withType("Microsoft.PowerBIDedicated/capacities"),
                com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Пример ответа

Код состояния:: 200

{
  "nameAvailable": true
}

Определения

Имя	Описание
CheckCapacityNameAvailabilityParameters	Сведения о тексте запроса имени емкости.
CheckCapacityNameAvailabilityResult	Результат проверки доступности имени емкости.
Error	Объект ошибки.
ErrorResponse	Объект ошибки

CheckCapacityNameAvailabilityParameters

Объект

Сведения о тексте запроса имени емкости.

Имя	Тип	Default value	Описание
name	string minLength: 3 maxLength: 63 pattern: ^[a-z][a-z0-9]*$		Имя проверки доступности.
type	string	Microsoft.PowerBIDedicated/capacities	Тип ресурса выделенного powerBI.

CheckCapacityNameAvailabilityResult

Объект

Результат проверки доступности имени емкости.

Имя	Тип	Описание
message	string	Подробное сообщение о недоступности запроса.
nameAvailable	boolean	Индикатор доступности имени емкости.
reason	string	Причина недоступности.

Error

Объект

Объект ошибки.

Имя	Тип	Описание
code	string	Код ошибки
message	string	Сообщение об ошибке, указывающее, почему операция завершилась ошибкой.

ErrorResponse

Объект

Объект ошибки

Имя	Тип	Описание
error	Error	Объект ошибки.