次の方法で共有


Servers - Check Name Availability

指定した名前でリソースを作成できるかどうかを判断します。

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Sql/checkNameAvailability?api-version=2023-08-01

URI パラメーター

名前 / 必須 説明
subscriptionId
path True

string

Azure サブスクリプションを識別するサブスクリプション ID。

api-version
query True

string

要求に使用する API バージョン。

要求本文

名前 必須 説明
name True

string

type True

CheckNameAvailabilityResourceType

応答

名前 説明
200 OK

CheckNameAvailabilityResponse

可用性チェックが正常に完了しました。

Other Status Codes

ErrorResponse

エラー応答: ***

  • 400 InvalidNameAvailabilityRequest - チェック名の可用性要求が無効です。

  • 400 UnknownNameType - サブスクリプション レベル名の可用性チェックに指定された不明なリソースの種類。

Check for a server name that already exists
Check for a server name that is available
Check for a server name that is invalid

Check for a server name that already exists

要求のサンプル

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/checkNameAvailability?api-version=2023-08-01

{
  "name": "server1",
  "type": "Microsoft.Sql/servers"
}

応答のサンプル

{
  "name": "server1",
  "available": false,
  "reason": "AlreadyExists",
  "message": "Specified server name is already used"
}

Check for a server name that is available

要求のサンプル

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/checkNameAvailability?api-version=2023-08-01

{
  "name": "server1",
  "type": "Microsoft.Sql/servers"
}

応答のサンプル

{
  "name": "server1",
  "available": true
}

Check for a server name that is invalid

要求のサンプル

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/checkNameAvailability?api-version=2023-08-01

{
  "name": "SERVER1",
  "type": "Microsoft.Sql/servers"
}

応答のサンプル

{
  "name": "SERVER1",
  "available": false,
  "reason": "Invalid",
  "message": "Specified server name contains unsupported characters or is too long. Server name must be no longer than 63 characters long, contain only lower-case characters or digits, cannot contain '.' or '_' characters and can't start or end with '-' character."
}

定義

名前 説明
CheckNameAvailabilityReason

名前が使用できない理由を説明する理由コード。 名前が使用可能な場合は未定義になります。

CheckNameAvailabilityRequest

指定したリソース名を使用できるかどうかを確認する要求。

CheckNameAvailabilityResourceType
CheckNameAvailabilityResponse

名前の可用性チェックの結果。

ErrorAdditionalInfo

リソース管理エラーの追加情報。

ErrorDetail

エラーの詳細。

ErrorResponse

エラー応答

CheckNameAvailabilityReason

名前が使用できない理由を説明する理由コード。 名前が使用可能な場合は未定義になります。

説明
Invalid
AlreadyExists

CheckNameAvailabilityRequest

指定したリソース名を使用できるかどうかを確認する要求。

名前 説明
name

string

type

CheckNameAvailabilityResourceType

CheckNameAvailabilityResourceType

説明
Microsoft.Sql/servers

CheckNameAvailabilityResponse

名前の可用性チェックの結果。

名前 説明
available

boolean

名前が使用可能な場合は True、それ以外の場合は false。

message

string

名前が使用できない理由を説明するメッセージ。 名前が使用可能な場合は未定義になります。

name

string

可用性がチェックされた名前。

reason

CheckNameAvailabilityReason

名前が使用できない理由を説明する理由コード。 名前が使用可能な場合は未定義になります。

ErrorAdditionalInfo

リソース管理エラーの追加情報。

名前 説明
info

object

追加情報。

type

string

追加情報の種類。

ErrorDetail

エラーの詳細。

名前 説明
additionalInfo

ErrorAdditionalInfo[]

エラーの追加情報。

code

string

エラー コード。

details

ErrorDetail[]

エラーの詳細。

message

string

エラー メッセージ。

target

string

エラーターゲット。

ErrorResponse

エラー応答

名前 説明
error

ErrorDetail

エラー オブジェクト。