Scheduled Actions - Check Name Availability By Scope

Referencia

Servicio:: Cost Management

Versión de la API:: 2024-08-01

Comprueba la disponibilidad y la exactitud del nombre de una acción programada dentro del ámbito especificado.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
scope	path	True	string	Ámbito asociado a las operaciones de acción programadas. Esto incluye "subscriptions/{subscriptionId}" para el ámbito de la suscripción, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' para el ámbito resourceGroup, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' para el ámbito de la cuenta de facturación, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' para el ámbito department, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{ enrollmentAccountId}' para el ámbito EnrollmentAccount, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' para el ámbito BillingProfile, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' para el ámbito invoiceSection, 'providers/Microsoft.CostManagement/externalBillingAccounts/{externalBillingAccountName}' para el ámbito de la cuenta de facturación externa y 'providers/Microsoft'. CostManagement/externalSubscriptions/{externalSubscriptionName}' para el ámbito de suscripción externa. Nota: Las alertas de información solo están disponibles en el ámbito de la suscripción.
api-version	query	True	string	Versión de la API que se va a usar para esta operación.

Cuerpo de la solicitud

Nombre	Tipo	Description
name	string	Nombre del recurso para el que se debe comprobar la disponibilidad.
type	string	Tipo de recurso.

Respuestas

Nombre	Tipo	Description
200 OK	CheckNameAvailabilityResponse	Respuesta de la disponibilidad del nombre de acción programada.
Other Status Codes	ErrorResponseWithNestedDetails	Respuesta de error que describe por qué se produjo un error en la operación.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

ScheduledActionCheckNameAvailabilityByScope

Solicitud de ejemplo

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

Respuesta de muestra

status code:: 200

{
  "nameAvailable": true
}

Definiciones

Nombre	Description
CheckNameAvailabilityReason	Motivo por el que el nombre especificado no está disponible.
CheckNameAvailabilityRequest	Cuerpo de la solicitud de comprobación de disponibilidad.
CheckNameAvailabilityResponse	Resultado de la comprobación de disponibilidad.
ErrorDetailsWithNestedDetails	Detalles del error.
ErrorResponseWithNestedDetails	La respuesta de error indica que el servicio no puede procesar la solicitud entrante. El motivo se proporciona en el mensaje de error. Algunas respuestas de error: 429 TooManyRequests: la solicitud está limitada. Vuelva a intentarlo después de esperar el tiempo especificado en el encabezado "x-ms-ratelimit-microsoft.consumption-retry-after". 503 ServiceUnavailable: el servicio no está disponible temporalmente. Vuelva a intentarlo después de esperar el tiempo especificado en el encabezado "Retry-After".

CheckNameAvailabilityReason

Motivo por el que el nombre especificado no está disponible.

Nombre	Tipo	Description
AlreadyExists	string
Invalid	string

CheckNameAvailabilityRequest

Cuerpo de la solicitud de comprobación de disponibilidad.

Nombre	Tipo	Description
name	string	Nombre del recurso para el que se debe comprobar la disponibilidad.
type	string	Tipo de recurso.

CheckNameAvailabilityResponse

Resultado de la comprobación de disponibilidad.

Nombre	Tipo	Description
message	string	Motivo detallado por el que el nombre especificado está disponible.
nameAvailable	boolean	Indica si el nombre del recurso está disponible.
reason	CheckNameAvailabilityReason	Motivo por el que el nombre especificado no está disponible.

ErrorDetailsWithNestedDetails

Detalles del error.

Nombre	Tipo	Description
code	string	Código de error.
details	ErrorDetailsWithNestedDetails[]	Detalles adicionales del error.
message	string	Mensaje de error que indica por qué se produjo un error en la operación.

ErrorResponseWithNestedDetails

La respuesta de error indica que el servicio no puede procesar la solicitud entrante. El motivo se proporciona en el mensaje de error.

Algunas respuestas de error:

429 TooManyRequests: la solicitud está limitada. Vuelva a intentarlo después de esperar el tiempo especificado en el encabezado "x-ms-ratelimit-microsoft.consumption-retry-after".
503 ServiceUnavailable: el servicio no está disponible temporalmente. Vuelva a intentarlo después de esperar el tiempo especificado en el encabezado "Retry-After".

Nombre	Tipo	Description
error	ErrorDetailsWithNestedDetails	Detalles del error.

Compartir a través de