Cost Allocation Rules - Check Name Availability

참조

서비스:: Cost Management

API 버전:: 2024-08-01

비용 할당 규칙에 대한 이름의 가용성 및 정확성을 확인합니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
billingAccountId	path	True	string	BillingAccount ID
api-version	query	True	string	이 작업에 사용할 API 버전입니다.

요청 본문

Name	형식	Description
name	string	규칙 이름
type	string	리소스 종류입니다. Microsoft.CostManagement/costAllocationRules가 될 것으로 예상됩니다.

응답

Name	형식	Description
200 OK	CostAllocationRuleCheckNameAvailabilityResponse	비용 할당 규칙 이름 가용성에 대한 응답입니다.
Other Status Codes	ErrorResponse	작업이 실패한 이유를 설명하는 오류 응답

보안

azure_auth

Azure Active Directory OAuth2 Flow.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

CostAllocationRuleCheckNameAvailability

샘플 요청

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

샘플 응답

상태 코드:: 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."
}

정의

Name	Description
CostAllocationRuleCheckNameAvailabilityRequest	비용 할당 규칙 확인 이름 가용성 요청
CostAllocationRuleCheckNameAvailabilityResponse	비용 할당 규칙 확인 이름 가용성 응답
ErrorDetails	오류의 세부 정보입니다.
ErrorResponse	오류 응답은 서비스에서 들어오는 요청을 처리할 수 없음을 나타냅니다. 그 이유는 오류 메시지에 제공됩니다. 일부 오류 응답: 429 TooManyRequests - 요청이 제한됩니다. "x-ms-ratelimit-microsoft.consumption-retry-after" 헤더에 지정된 시간을 기다린 후 다시 시도합니다. 503 ServiceUnavailable - 서비스를 일시적으로 사용할 수 없습니다. "Retry-After" 헤더에 지정된 시간을 기다린 후 다시 시도합니다.
Reason	이 이름을 사용할 수 없는 이유입니다.

CostAllocationRuleCheckNameAvailabilityRequest

비용 할당 규칙 확인 이름 가용성 요청

Name	형식	Description
name	string	규칙 이름
type	string	리소스 종류입니다. Microsoft.CostManagement/costAllocationRules가 될 것으로 예상됩니다.

CostAllocationRuleCheckNameAvailabilityResponse

비용 할당 규칙 확인 이름 가용성 응답

Name	형식	Description
message	string	이름을 사용할 수 없는 경우 오류 메시지
nameAvailable	boolean	이 규칙 이름을 사용할 수 있는지 여부
reason	Reason	이 이름을 사용할 수 없는 이유

ErrorDetails

오류의 세부 정보입니다.

Name	형식	Description
code	string	오류 코드입니다.
message	string	작업이 실패한 이유를 나타내는 오류 메시지입니다.

ErrorResponse

오류 응답은 서비스에서 들어오는 요청을 처리할 수 없음을 나타냅니다. 그 이유는 오류 메시지에 제공됩니다.

일부 오류 응답:

429 TooManyRequests - 요청이 제한됩니다. "x-ms-ratelimit-microsoft.consumption-retry-after" 헤더에 지정된 시간을 기다린 후 다시 시도합니다.
503 ServiceUnavailable - 서비스를 일시적으로 사용할 수 없습니다. "Retry-After" 헤더에 지정된 시간을 기다린 후 다시 시도합니다.

Name	형식	Description
error	ErrorDetails	오류의 세부 정보입니다.

Reason

이 이름을 사용할 수 없는 이유입니다.

Name	형식	Description
AlreadyExists	string
Invalid	string
Valid	string

다음을 통해 공유