Sdílet prostřednictvím


Cost Allocation Rules - Check Name Availability

Kontroluje dostupnost a správnost názvu pravidla alokace nákladů.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
billingAccountId
path True

string

ID fakturačního účtu

api-version
query True

string

Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name Typ Description
name

string

Název pravidla

type

string

Typ prostředku. Očekává se, že se jedná o Microsoft.CostManagement/costAllocationRules.

Odpovědi

Name Typ Description
200 OK

CostAllocationRuleCheckNameAvailabilityResponse

Odpověď na dostupnost názvu pravidla alokace nákladů

Other Status Codes

ErrorResponse

Chybová odpověď popisující, proč operace selhala

Zabezpečení

azure_auth

Tok OAuth2 v Azure Active Directory

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name Description
user_impersonation zosobnění uživatelského účtu

Příklady

CostAllocationRuleCheckNameAvailability

Ukázkový požadavek

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

Ukázková odpověď

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

Definice

Name Description
CostAllocationRuleCheckNameAvailabilityRequest

Žádost o dostupnost pravidla alokace nákladů

CostAllocationRuleCheckNameAvailabilityResponse

Odpověď na odpověď na název kontroly dostupnosti pravidla alokace nákladů

ErrorDetails

Podrobnosti o chybě.

ErrorResponse

Chybová odpověď značí, že služba nemůže zpracovat příchozí požadavek. Důvod je uvedený v chybové zprávě.

Některé chybové odpovědi:

  • 429 TooManyRequests – Požadavek je omezený. Opakujte akci po čekání na dobu uvedenou v hlavičce x-ms-ratelimit-microsoft.consumption-retry-after.

  • 503 ServiceUnavailable – Služba je dočasně nedostupná. Opakujte akci po čekání na dobu uvedenou v hlavičce Opakovat až po spuštění.

Reason

Důvod, proč tento název není k dispozici.

CostAllocationRuleCheckNameAvailabilityRequest

Žádost o dostupnost pravidla alokace nákladů

Name Typ Description
name

string

Název pravidla

type

string

Typ prostředku. Očekává se, že se jedná o Microsoft.CostManagement/costAllocationRules.

CostAllocationRuleCheckNameAvailabilityResponse

Odpověď na odpověď na název kontroly dostupnosti pravidla alokace nákladů

Name Typ Description
message

string

Chybová zpráva, pokud název není k dispozici

nameAvailable

boolean

Zda je tento název pravidla k dispozici

reason

Reason

Důvod, proč tento název není k dispozici

ErrorDetails

Podrobnosti o chybě.

Name Typ Description
code

string

Kód chyby

message

string

Chybová zpráva označující, proč operace selhala.

ErrorResponse

Chybová odpověď značí, že služba nemůže zpracovat příchozí požadavek. Důvod je uvedený v chybové zprávě.

Některé chybové odpovědi:

  • 429 TooManyRequests – Požadavek je omezený. Opakujte akci po čekání na dobu uvedenou v hlavičce x-ms-ratelimit-microsoft.consumption-retry-after.

  • 503 ServiceUnavailable – Služba je dočasně nedostupná. Opakujte akci po čekání na dobu uvedenou v hlavičce Opakovat až po spuštění.

Name Typ Description
error

ErrorDetails

Podrobnosti o chybě.

Reason

Důvod, proč tento název není k dispozici.

Name Typ Description
AlreadyExists

string

Invalid

string

Valid

string