Virtual Networks - Check IP Address Availability

プライベート IP アドレスを使用できるかどうかを確認します。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/CheckIPAddressAvailability?ipAddress={ipAddress}&api-version=2023-09-01

URI パラメーター

名前 / 必須 説明
resourceGroupName
path True

string

リソース グループの名前。

subscriptionId
path True

string

Microsoft Azure サブスクリプションを一意に識別するサブスクリプションの資格情報。 サブスクリプション ID は、全ての修理依頼についてURI の一部を生じさせます。

virtualNetworkName
path True

string

仮想ネットワークの名前。

api-version
query True

string

クライアント API バージョン。

ipAddress
query True

string

検証するプライベート IP アドレス。

応答

名前 説明
200 OK

IPAddressAvailabilityResult

プライベート IP アドレスの可用性と、要求されたアドレスが使用できない場合のその他の空きアドレスの一覧。

Other Status Codes

CloudError

操作に失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

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

Scopes

名前 説明
user_impersonation ユーザー アカウントの借用

Check IP address availability

Sample Request

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/test-vnet/CheckIPAddressAvailability?ipAddress=10.0.1.4&api-version=2023-09-01

Sample Response

{
  "available": false,
  "availableIPAddresses": [
    "10.0.1.5",
    "10.0.1.6",
    "10.0.1.7",
    "10.0.1.8",
    "10.0.1.9"
  ]
}

定義

名前 説明
CloudError

サービスからのエラー応答。

CloudErrorBody

サービスからのエラー応答。

IPAddressAvailabilityResult

CheckIPAddressAvailability API サービス呼び出しに対する応答。

CloudError

サービスからのエラー応答。

名前 説明
error

CloudErrorBody

クラウド エラー本文。

CloudErrorBody

サービスからのエラー応答。

名前 説明
code

string

エラーの識別子。 コードは不変であり、プログラムによって使用されることを意図しています。

details

CloudErrorBody[]

エラーに関する追加の詳細の一覧。

message

string

ユーザー インターフェイスでの表示に適したエラーを説明するメッセージ。

target

string

特定のエラーのターゲット。 たとえば、エラーが発生したプロパティの名前です。

IPAddressAvailabilityResult

CheckIPAddressAvailability API サービス呼び出しに対する応答。

名前 説明
available

boolean

プライベート IP アドレスの可用性。

availableIPAddresses

string[]

要求されたアドレスが取得された場合は、他の使用可能なプライベート IP アドレスが含まれます。

isPlatformReserved

boolean

プライベート IP アドレス プラットフォームが予約されています。