Servers - Name Availability - Check Name Availability

サービス:

SQL Database

API バージョン:

2014-04-01

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

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

URI パラメーター

名前	/	必須	型	説明
subscriptionId	path	True	string	Azure サブスクリプションを識別するサブスクリプション ID。
api-version	query	True	string	要求で使用する API のバージョン。

要求本文

名前	必須	型	説明
name	True	string	可用性を確認する名前。
type	True	CheckNameAvailabilityResourceType	可用性チェックのスコープとして使用されるリソースの種類。

応答

名前	型	説明
200 OK	CheckNameAvailabilityResponse	OK

例

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

要求のサンプル

HTTP

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

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

応答のサンプル

状態コード:

200

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

Check for a server name that is available

要求のサンプル

HTTP

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

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

応答のサンプル

状態コード:

200

{
  "name": "server1",
  "available": true,
  "reason": null,
  "message": null
}

Check for a server name that is invalid

要求のサンプル

HTTP

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

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

応答のサンプル

状態コード:

200

{
  "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	名前が使用できない理由を説明する理由コード。 名前が使用可能な場合は null になります。
CheckNameAvailabilityRequest	リソースの指定した名前を使用できるかどうかをチェックする要求。
CheckNameAvailabilityResourceType	可用性チェックのスコープとして使用されるリソースの種類。
CheckNameAvailabilityResponse	指定したリソース名を使用できるかどうかを示す応答。

CheckNameAvailabilityReason

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

名前	型	説明
AlreadyExists	string
Invalid	string

CheckNameAvailabilityRequest

リソースの指定した名前を使用できるかどうかをチェックする要求。

名前	型	説明
name	string	可用性を確認する名前。
type	CheckNameAvailabilityResourceType	可用性チェックのスコープとして使用されるリソースの種類。

CheckNameAvailabilityResourceType

可用性チェックのスコープとして使用されるリソースの種類。

名前	型	説明
Microsoft.Sql/servers	string

CheckNameAvailabilityResponse

指定したリソース名を使用できるかどうかを示す応答。

名前	型	説明
available	boolean	名前が使用可能な場合は True、それ以外の場合は false。
message	string	名前が使用できない理由を説明するメッセージ。 名前が使用可能な場合は null になります。
name	string	可用性がチェックされた名前。
reason	CheckNameAvailabilityReason	名前が使用できない理由を説明する理由コード。 名前が使用可能な場合は null になります。