Scheduled Actions - Check Name Availability By Scope

Referentie

Service:: Cost Management

API-versie:: 2024-08-01

Controleert de beschikbaarheid en juistheid van de naam voor een geplande actie binnen het opgegeven bereik.

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

URI-parameters

Name	In	Vereist	Type	Description
scope	path	True	string	Het bereik dat is gekoppeld aan geplande actiebewerkingen. Dit omvat abonnementen/{subscriptionId} voor abonnementsbereik, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' voor resourceGroup-bereik, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' voor het bereik van de factureringsrekening, providers/Microsoft.Billing/billingAccounts/{billingAccountId}/afdelingen/{departmentId}' voor afdelingsbereik, providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{ enrollmentAccountId} voor het bereik EnrollmentAccount, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' voor het bereik BillingProfile, providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' voor het bereik InvoiceSection, providers/Microsoft.CostManagement/externalBillingAccounts/{externalBillingAccountName} voor het bereik externe factureringsaccount en providers/Microsoft. CostManagement/externalSubscriptions/{externalSubscriptionName} voor extern abonnementsbereik. Opmerking: Inzichtwaarschuwingen zijn alleen beschikbaar voor abonnementsbereik.
api-version	query	True	string	De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name	Type	Description
name	string	De naam van de resource waarvoor de beschikbaarheid moet worden gecontroleerd.
type	string	Het resourcetype.

Antwoorden

Name	Type	Description
200 OK	CheckNameAvailabilityResponse	Antwoord van de beschikbaarheid van de geplande actienaam.
Other Status Codes	ErrorResponseWithNestedDetails	Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

ScheduledActionCheckNameAvailabilityByScope

Voorbeeldaanvraag

HTTP

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

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

Voorbeeldrespons

Statuscode:: 200

{
  "nameAvailable": true
}

Definities

Name	Description
CheckNameAvailabilityReason	De reden waarom de opgegeven naam niet beschikbaar is.
CheckNameAvailabilityRequest	De hoofdtekst van de beschikbaarheidsaanvraag controleren.
CheckNameAvailabilityResponse	Het resultaat van de beschikbaarheid controleren.
ErrorDetailsWithNestedDetails	De details van de fout.
ErrorResponseWithNestedDetails	Foutreactie geeft aan dat de service de binnenkomende aanvraag niet kan verwerken. De reden is opgegeven in het foutbericht. Enkele foutberichten: 429 TooManyRequests - Aanvraag wordt beperkt. Probeer het opnieuw nadat u hebt gewacht op de tijd die is opgegeven in de header x-ms-ratelimit-microsoft.consumption-retry-after. 503 ServiceUnavailable - Service is tijdelijk niet beschikbaar. Probeer het opnieuw nadat u hebt gewacht op de tijd die is opgegeven in de header 'Opnieuw proberen-na'.

CheckNameAvailabilityReason

De reden waarom de opgegeven naam niet beschikbaar is.

Name	Type	Description
AlreadyExists	string
Invalid	string

CheckNameAvailabilityRequest

De hoofdtekst van de beschikbaarheidsaanvraag controleren.

Name	Type	Description
name	string	De naam van de resource waarvoor de beschikbaarheid moet worden gecontroleerd.
type	string	Het resourcetype.

CheckNameAvailabilityResponse

Het resultaat van de beschikbaarheid controleren.

Name	Type	Description
message	string	Gedetailleerde reden waarom de opgegeven naam beschikbaar is.
nameAvailable	boolean	Geeft aan of de resourcenaam beschikbaar is.
reason	CheckNameAvailabilityReason	De reden waarom de opgegeven naam niet beschikbaar is.

ErrorDetailsWithNestedDetails

De details van de fout.

Name	Type	Description
code	string	Foutcode.
details	ErrorDetailsWithNestedDetails[]	De aanvullende details van de fout.
message	string	Foutbericht dat aangeeft waarom de bewerking is mislukt.

ErrorResponseWithNestedDetails

Foutreactie geeft aan dat de service de binnenkomende aanvraag niet kan verwerken. De reden is opgegeven in het foutbericht.

Enkele foutberichten:

429 TooManyRequests - Aanvraag wordt beperkt. Probeer het opnieuw nadat u hebt gewacht op de tijd die is opgegeven in de header x-ms-ratelimit-microsoft.consumption-retry-after.
503 ServiceUnavailable - Service is tijdelijk niet beschikbaar. Probeer het opnieuw nadat u hebt gewacht op de tijd die is opgegeven in de header 'Opnieuw proberen-na'.

Name	Type	Description
error	ErrorDetailsWithNestedDetails	De details van de fout.

Delen via