Scheduled Actions - Check Name Availability

Referenz

Dienst:: Cost Management

API-Version:: 2024-08-01

Überprüft die Verfügbarkeit und Richtigkeit des Namens für eine geplante Aktion.

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

URI-Parameter

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

Anforderungstext

Name	Typ	Beschreibung
name	string	Der Name der Ressource, für die die Verfügbarkeit überprüft werden muss.
type	string	Der Ressourcentyp.

Antworten

Name	Typ	Beschreibung
200 OK	CheckNameAvailabilityResponse	Antwort auf die Verfügbarkeit des geplanten Aktionsnamens.
Other Status Codes	ErrorResponseWithNestedDetails	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

ScheduledActionCheckNameAvailability

Beispielanforderung

HTTP

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

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

Beispiel für eine Antwort

Statuscode:: 200

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

Definitionen

Name	Beschreibung
CheckNameAvailabilityReason	Der Grund, warum der angegebene Name nicht verfügbar ist.
CheckNameAvailabilityRequest	Der Anforderungstext der Überprüfung.
CheckNameAvailabilityResponse	Das Verfügbarkeitsergebnis der Überprüfung.
ErrorDetailsWithNestedDetails	Die Details des Fehlers.
ErrorResponseWithNestedDetails	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.

CheckNameAvailabilityReason

Der Grund, warum der angegebene Name nicht verfügbar ist.

Name	Typ	Beschreibung
AlreadyExists	string
Invalid	string

CheckNameAvailabilityRequest

Der Anforderungstext der Überprüfung.

Name	Typ	Beschreibung
name	string	Der Name der Ressource, für die die Verfügbarkeit überprüft werden muss.
type	string	Der Ressourcentyp.

CheckNameAvailabilityResponse

Das Verfügbarkeitsergebnis der Überprüfung.

Name	Typ	Beschreibung
message	string	Detaillierter Grund, warum der angegebene Name verfügbar ist.
nameAvailable	boolean	Gibt an, ob der Ressourcenname verfügbar ist.
reason	CheckNameAvailabilityReason	Der Grund, warum der angegebene Name nicht verfügbar ist.

ErrorDetailsWithNestedDetails

Die Details des Fehlers.

Name	Typ	Beschreibung
code	string	Fehlercode.
details	ErrorDetailsWithNestedDetails[]	Die zusätzlichen Details des Fehlers.
message	string	Fehlermeldung, die angibt, warum der Vorgang fehlgeschlagen ist.

ErrorResponseWithNestedDetails

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	ErrorDetailsWithNestedDetails	Die Details des Fehlers.

Freigeben über