Cost Allocation Rules - Check Name Availability

Referencia

Service:: Cost Management

API Version:: 2023-11-01

Comprueba la disponibilidad y corrección de un nombre para una regla de asignación de costos.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
billingAccountId	path	True	string	BillingAccount ID
api-version	query	True	string	Versión de API que se usará para la operación.

Cuerpo de la solicitud

Nombre	Tipo	Description
name	string	Nombre de la regla
type	string	Tipo de recurso. Se espera que sea Microsoft.CostManagement/costAllocationRules.

Respuestas

Nombre	Tipo	Description
200 OK	CostAllocationRuleCheckNameAvailabilityResponse	Respuesta de la disponibilidad del nombre de la regla de asignación de costos.
Other Status Codes	ErrorResponse	Respuesta de error que describe el motivo del error de la operación.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nombre	Description
user_impersonation	suplantación de su cuenta de usuario

Ejemplos

CostAllocationRuleCheckNameAvailability

Sample Request

HTTP

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/100/providers/Microsoft.CostManagement/costAllocationRules/checkNameAvailability?api-version=2023-11-01

{
  "name": "testRule",
  "type": "Microsoft.CostManagement/costAllocationRules"
}

Sample Response

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

Definiciones

Nombre	Description
CostAllocationRuleCheckNameAvailabilityRequest	Solicitud de disponibilidad del nombre de comprobación de la regla de asignación de costos
CostAllocationRuleCheckNameAvailabilityResponse	Respuesta de disponibilidad de la regla de asignación de costos
ErrorDetails	Detalles del error.
ErrorResponse	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 "Vuelva a intentarlo después de".
Reason	El motivo por el que este nombre no está disponible.

CostAllocationRuleCheckNameAvailabilityRequest

Solicitud de disponibilidad del nombre de comprobación de la regla de asignación de costos

Nombre	Tipo	Description
name	string	Nombre de la regla
type	string	Tipo de recurso. Se espera que sea Microsoft.CostManagement/costAllocationRules.

CostAllocationRuleCheckNameAvailabilityResponse

Respuesta de disponibilidad de la regla de asignación de costos

Nombre	Tipo	Description
message	string	Mensaje de error si el nombre no está disponible
nameAvailable	boolean	Si este nombre de regla está disponible
reason	Reason	El motivo por el que este nombre no está disponible

ErrorDetails

Detalles del error.

Nombre	Tipo	Description
code	string	Código de error.
message	string	Mensaje de error que indica por qué se produjo un error en la operación.

ErrorResponse

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 "Vuelva a intentarlo después de".

Nombre	Tipo	Description
error	ErrorDetails	Detalles del error.

Reason

El motivo por el que este nombre no está disponible.

Nombre	Tipo	Description
AlreadyExists	string
Invalid	string
Valid	string