Scheduled Actions - Check Name Availability

Usługa:

Cost Management

Wersja interfejsu API:

2024-08-01

Sprawdza dostępność i poprawność nazwy zaplanowanej akcji.

POST https://management.azure.com/providers/Microsoft.CostManagement/checkNameAvailability?api-version=2024-08-01

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa	Typ	Opis
name	string	Nazwa zasobu, dla którego należy sprawdzić dostępność.
type	string	Typ zasobu.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	CheckNameAvailabilityResponse	Odpowiedź na dostępność nazwy zaplanowanej akcji.
Other Status Codes	ErrorResponseWithNestedDetails	Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

ScheduledActionCheckNameAvailability

Przykładowe żądanie

HTTP

POST https://management.azure.com/providers/Microsoft.CostManagement/checkNameAvailability?api-version=2024-08-01

{
  "name": "testName",
  "type": "Microsoft.CostManagement/ScheduledActions"
}

Przykładowa odpowiedź

Kod stanu:

200

{
  "nameAvailable": false,
  "reason": "AlreadyExists",
  "message": "A private scheduled action with name 'testName' is already present. Please specify a differnt name."
}

Definicje

Nazwa	Opis
CheckNameAvailabilityReason	Powód, dla którego dana nazwa jest niedostępna.
CheckNameAvailabilityRequest	Treść żądania sprawdzania dostępności.
CheckNameAvailabilityResponse	Wynik sprawdzania dostępności.
ErrorDetailsWithNestedDetails	Szczegóły błędu.
ErrorResponseWithNestedDetails	Odpowiedź na błąd wskazuje, że usługa nie może przetworzyć przychodzącego żądania. Przyczyna jest podana w komunikacie o błędzie. Niektóre odpowiedzi na błędy: 429 TooManyRequests — żądanie jest ograniczane. Ponów próbę po upływie czasu określonego w nagłówku "x-ms-ratelimit-microsoft.consumption-retry-after". 503 ServiceUnavailable — usługa jest tymczasowo niedostępna. Ponów próbę po upływie czasu określonego w nagłówku "Ponów próbę po".

CheckNameAvailabilityReason

Wyliczanie

Powód, dla którego dana nazwa jest niedostępna.

Wartość	Opis
AlreadyExists
Invalid

CheckNameAvailabilityRequest

Objekt

Treść żądania sprawdzania dostępności.

Nazwa	Typ	Opis
name	string	Nazwa zasobu, dla którego należy sprawdzić dostępność.
type	string	Typ zasobu.

CheckNameAvailabilityResponse

Objekt

Wynik sprawdzania dostępności.

Nazwa	Typ	Opis
message	string	Szczegółowy powód, dla którego dana nazwa jest dostępna.
nameAvailable	boolean	Wskazuje, czy nazwa zasobu jest dostępna.
reason	CheckNameAvailabilityReason	Powód, dla którego dana nazwa jest niedostępna.

ErrorDetailsWithNestedDetails

Objekt

Szczegóły błędu.

Nazwa	Typ	Opis
code	string	Kod błędu.
details	ErrorDetailsWithNestedDetails[]	Dodatkowe szczegóły błędu.
message	string	Komunikat o błędzie wskazujący, dlaczego operacja nie powiodła się.

ErrorResponseWithNestedDetails

Objekt

Odpowiedź na błąd wskazuje, że usługa nie może przetworzyć przychodzącego żądania. Przyczyna jest podana w komunikacie o błędzie.

Niektóre odpowiedzi na błędy:

• 429 TooManyRequests — żądanie jest ograniczane. Ponów próbę po upływie czasu określonego w nagłówku "x-ms-ratelimit-microsoft.consumption-retry-after".

• 503 ServiceUnavailable — usługa jest tymczasowo niedostępna. Ponów próbę po upływie czasu określonego w nagłówku "Ponów próbę po".

Nazwa	Typ	Opis
error	ErrorDetailsWithNestedDetails	Szczegóły błędu.