Cost Allocation Rules - Check Name Availability

Odwołanie

Usługa:: Cost Management

Wersja interfejsu API:: 2024-08-01

Sprawdza dostępność i poprawność nazwy reguły alokacji kosztów

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/costAllocationRules/checkNameAvailability?api-version=2024-08-01

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
billingAccountId	path	True	string	Identyfikator konta rozliczeniowego
api-version	query	True	string	Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa	Typ	Opis
name	string	Nazwa reguły
type	string	Typ zasobu. Oczekuje się, że wartość Microsoft.CostManagement/costAllocationRules

Odpowiedzi

Nazwa	Typ	Opis
200 OK	CostAllocationRuleCheckNameAvailabilityResponse	Odpowiedź na dostępność nazwy reguły alokacji kosztów.
Other Status Codes	ErrorResponse	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

CostAllocationRuleCheckNameAvailability

Przykładowe żądanie

HTTP

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

{
  "name": "testRule",
  "type": "Microsoft.CostManagement/costAllocationRules"
}

Przykładowa odpowiedź

Kod stanu:: 200

{
  "nameAvailable": false,
  "reason": "AlreadyExists",
  "message": "A cost allocation rule with name testRule is already present for the billing account 100. Please specify a differnt name."
}

Definicje

Nazwa	Opis
CostAllocationRuleCheckNameAvailabilityRequest	Żądanie dostępności nazwy sprawdzania nazwy reguły alokacji kosztów
CostAllocationRuleCheckNameAvailabilityResponse	Reguła alokacji kosztów sprawdza odpowiedź na dostępność nazwy
ErrorDetails	Szczegóły błędu.
ErrorResponse	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".
Reason	Przyczyna, dla którego ta nazwa jest niedostępna.

CostAllocationRuleCheckNameAvailabilityRequest

Żądanie dostępności nazwy sprawdzania nazwy reguły alokacji kosztów

Nazwa	Typ	Opis
name	string	Nazwa reguły
type	string	Typ zasobu. Oczekuje się, że wartość Microsoft.CostManagement/costAllocationRules

CostAllocationRuleCheckNameAvailabilityResponse

Reguła alokacji kosztów sprawdza odpowiedź na dostępność nazwy

Nazwa	Typ	Opis
message	string	Komunikat o błędzie, jeśli nazwa jest niedostępna
nameAvailable	boolean	Czy ta nazwa reguły jest dostępna
reason	Reason	Przyczyna, dla którego ta nazwa jest niedostępna

ErrorDetails

Szczegóły błędu.

Nazwa	Typ	Opis
code	string	Kod błędu.
message	string	Komunikat o błędzie wskazujący, dlaczego operacja nie powiodła się.

ErrorResponse

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	ErrorDetails	Szczegóły błędu.

Reason

Przyczyna, dla którego ta nazwa jest niedostępna.

Nazwa	Typ	Opis
AlreadyExists	string
Invalid	string
Valid	string

Udostępnij za pośrednictwem