Cost Allocation Rules - Check Name Availability

Referenz

Dienst:: Cost Management

API-Version:: 2024-08-01

Überprüft die Verfügbarkeit und Richtigkeit eines Namens für eine Kostenzuteilungsregel.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
billingAccountId	path	True	string	BillingAccount-ID
api-version	query	True	string	Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungstext

Name	Typ	Beschreibung
name	string	Regelname
type	string	Ressourcentyp. Dies wird voraussichtlich Microsoft.CostManagement/costAllocationRules sein.

Antworten

Name	Typ	Beschreibung
200 OK	CostAllocationRuleCheckNameAvailabilityResponse	Antwort der Verfügbarkeit von Kostenzuordnungsregelnamen.
Other Status Codes	ErrorResponse	Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

CostAllocationRuleCheckNameAvailability

Beispielanforderung

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

Beispiel für eine Antwort

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

Definitionen

Name	Beschreibung
CostAllocationRuleCheckNameAvailabilityRequest	Die Kostenzuordnungsregel überprüft die Namensverfügbarkeitsanforderung
CostAllocationRuleCheckNameAvailabilityResponse	Die Antwort auf die Verfügbarkeit der Kostenzuordnungsregel überprüft die Verfügbarkeit von Namen
ErrorDetails	Die Details des Fehlers.
ErrorResponse	Fehlerantwort gibt an, dass der Dienst die eingehende Anforderung nicht verarbeiten kann. Der Grund wird in der Fehlermeldung angegeben. Einige Fehlerantworten: 429 TooManyRequests – Anforderung wird gedrosselt. Wiederholen Sie den Vorgang nach dem Warten auf die im Header "x-ms-ratelimit-microsoft.consumption-retry-after" angegebene Zeit. 503 ServiceUnavailable – Dienst ist vorübergehend nicht verfügbar. Wiederholen Sie den Vorgang nach dem Warten auf die im Header "Retry-After" angegebene Zeit.
Reason	Der Grund, warum dieser Name nicht verfügbar ist.

CostAllocationRuleCheckNameAvailabilityRequest

Die Kostenzuordnungsregel überprüft die Namensverfügbarkeitsanforderung

Name	Typ	Beschreibung
name	string	Regelname
type	string	Ressourcentyp. Dies wird voraussichtlich Microsoft.CostManagement/costAllocationRules sein.

CostAllocationRuleCheckNameAvailabilityResponse

Die Antwort auf die Verfügbarkeit der Kostenzuordnungsregel überprüft die Verfügbarkeit von Namen

Name	Typ	Beschreibung
message	string	Fehlermeldung, wenn der Name nicht verfügbar ist
nameAvailable	boolean	Gibt an, ob dieser Regelname verfügbar ist.
reason	Reason	Der Grund, warum dieser Name nicht verfügbar ist

ErrorDetails

Die Details des Fehlers.

Name	Typ	Beschreibung
code	string	Fehlercode.
message	string	Fehlermeldung, die angibt, warum der Vorgang fehlgeschlagen ist.

ErrorResponse

Fehlerantwort gibt an, dass der Dienst die eingehende Anforderung nicht verarbeiten kann. Der Grund wird in der Fehlermeldung angegeben.

Einige Fehlerantworten:

429 TooManyRequests – Anforderung wird gedrosselt. Wiederholen Sie den Vorgang nach dem Warten auf die im Header "x-ms-ratelimit-microsoft.consumption-retry-after" angegebene Zeit.
503 ServiceUnavailable – Dienst ist vorübergehend nicht verfügbar. Wiederholen Sie den Vorgang nach dem Warten auf die im Header "Retry-After" angegebene Zeit.

Name	Typ	Beschreibung
error	ErrorDetails	Die Details des Fehlers.

Reason

Der Grund, warum dieser Name nicht verfügbar ist.

Name	Typ	Beschreibung
AlreadyExists	string
Invalid	string
Valid	string

Freigeben über