Cost Allocation Rules - Check Name Availability

Referens

Tjänst:: Cost Management

API-version:: 2024-08-01

Kontrollerar tillgänglighet och korrekthet för ett namn för en kostnadsallokeringsregel

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
billingAccountId	path	True	string	FaktureringKonto-ID
api-version	query	True	string	DEN API-version som ska användas för den här åtgärden.

Begärandetext

Name	Typ	Description
name	string	Regelnamn
type	string	Resurstyp. Detta förväntas vara Microsoft.CostManagement/costAllocationRules

Svar

Name	Typ	Description
200 OK	CostAllocationRuleCheckNameAvailabilityResponse	Svar på tillgänglighet för kostnadsallokeringsregelns namn.
Other Status Codes	ErrorResponse	Felsvar som beskriver varför åtgärden misslyckades

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

CostAllocationRuleCheckNameAvailability

Exempelbegäran

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

Exempelsvar

Statuskod:: 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."
}

Definitioner

Name	Description
CostAllocationRuleCheckNameAvailabilityRequest	Kostnadsallokeringsregeln kontrollerar namntillgänglighetsbegäran
CostAllocationRuleCheckNameAvailabilityResponse	Svar på tillgänglighetssvar för kostnadsallokeringsregeln
ErrorDetails	Information om felet.
ErrorResponse	Felsvaret anger att tjänsten inte kan bearbeta den inkommande begäran. Orsaken anges i felmeddelandet. Några felsvar: 429 TooManyRequests – Begäran begränsas. Försök igen efter att ha väntat på den tid som anges i rubriken "x-ms-ratelimit-microsoft.consumption-retry-after". 503 ServiceUnavailable – Tjänsten är inte tillgänglig för tillfället. Försök igen efter att ha väntat på den tid som anges i rubriken "Försök igen".
Reason	Orsaken till att det här namnet inte är tillgängligt.

CostAllocationRuleCheckNameAvailabilityRequest

Kostnadsallokeringsregeln kontrollerar namntillgänglighetsbegäran

Name	Typ	Description
name	string	Regelnamn
type	string	Resurstyp. Detta förväntas vara Microsoft.CostManagement/costAllocationRules

CostAllocationRuleCheckNameAvailabilityResponse

Svar på tillgänglighetssvar för kostnadsallokeringsregeln

Name	Typ	Description
message	string	Felmeddelande om namnet inte är tillgängligt
nameAvailable	boolean	Om det här regelnamnet är tillgängligt
reason	Reason	Orsaken till att det här namnet inte är tillgängligt

ErrorDetails

Information om felet.

Name	Typ	Description
code	string	Felkod.
message	string	Felmeddelande som anger varför åtgärden misslyckades.

ErrorResponse

Felsvaret anger att tjänsten inte kan bearbeta den inkommande begäran. Orsaken anges i felmeddelandet.

Några felsvar:

429 TooManyRequests – Begäran begränsas. Försök igen efter att ha väntat på den tid som anges i rubriken "x-ms-ratelimit-microsoft.consumption-retry-after".
503 ServiceUnavailable – Tjänsten är inte tillgänglig för tillfället. Försök igen efter att ha väntat på den tid som anges i rubriken "Försök igen".

Name	Typ	Description
error	ErrorDetails	Information om felet.

Reason

Orsaken till att det här namnet inte är tillgängligt.

Name	Typ	Description
AlreadyExists	string
Invalid	string
Valid	string

Dela via