Managed Private Endpoints - Check Name Availability

Service:

Azure Kusto

API Version:

2023-08-15

Sprawdza, czy nazwa zasobu zarządzanych prywatnych punktów końcowych jest prawidłowa i nie jest jeszcze używana.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/clusters/{clusterName}/managedPrivateEndpointsCheckNameAvailability?api-version=2023-08-15

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
clusterName	path	True	string	Nazwa klastra Kusto. Regex pattern: ^.*$
resourceGroupName	path	True	string	Nazwa grupy zasobów. W nazwie jest uwzględniana wielkość liter.
subscriptionId	path	True	string	Identyfikator subskrypcji docelowej.
api-version	query	True	string	Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa	Wymagane	Typ	Opis
name	True	string	Nazwa zasobu zarządzanego prywatnego punktu końcowego.
type	True	ManagedPrivateEndpointsType	Typ zasobu, na przykład Microsoft.Kusto/clusters/managedPrivateEndpoints.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	CheckNameResult	OK — operacja sprawdzania dostępności nazwy zasobu kusto zakończyła się pomyślnie.
Other Status Codes	ErrorResponse	Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Przykłady

KustoManagedPrivateEndpointsCheckNameAvailability

Sample Request

HTTP

POST https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustorptest/providers/Microsoft.Kusto/clusters/kustoCluster/managedPrivateEndpointsCheckNameAvailability?api-version=2023-08-15

{
  "name": "pme1",
  "type": "Microsoft.Kusto/clusters/managedPrivateEndpoints"
}

Sample Response

Status code:

200

{
  "name": "pme1",
  "nameAvailable": false,
  "message": "Name 'pme1' is already taken. Please specify a different name"
}

Definicje

Nazwa	Opis
CheckNameResult	Wynik zwrócony z żądania dostępności nazwy sprawdzania.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
ManagedPrivateEndpointsCheckNameRequest	Wynik zwrócony z zarządzanejPrivateEndpoints sprawdź żądanie dostępności nazwy.
ManagedPrivateEndpointsType	Typ zasobu, na przykład Microsoft.Kusto/clusters/managedPrivateEndpoints.
reason	Komunikat informujący o przyczynie nieprawidłowej nazwy.

CheckNameResult

Wynik zwrócony z żądania dostępności nazwy sprawdzania.

Nazwa	Typ	Opis
message	string	Komunikat wskazujący niedostępną nazwę z powodu konfliktu lub opis reguł nazewnictwa, które zostały naruszone.
name	string	Sprawdzono nazwę.
nameAvailable	boolean	Określa wartość logiczną wskazującą, czy nazwa jest dostępna.
reason	reason	Komunikat informujący o przyczynie nieprawidłowej nazwy.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt błędu.

ManagedPrivateEndpointsCheckNameRequest

Wynik zwrócony z zarządzanejPrivateEndpoints sprawdź żądanie dostępności nazwy.

Nazwa	Typ	Opis
name	string	Nazwa zasobu zarządzanego prywatnego punktu końcowego.
type	ManagedPrivateEndpointsType	Typ zasobu, na przykład Microsoft.Kusto/clusters/managedPrivateEndpoints.

ManagedPrivateEndpointsType

Typ zasobu, na przykład Microsoft.Kusto/clusters/managedPrivateEndpoints.

Nazwa	Typ	Opis
Microsoft.Kusto/clusters/managedPrivateEndpoints	string

reason

Komunikat informujący o przyczynie nieprawidłowej nazwy.

Nazwa	Typ	Opis
AlreadyExists	string
Invalid	string