Iot Hub Resource - Check Name Availability

Service:

IoT Hub

API Version:

2018-04-01

IoT hub'ı adının kullanılabilir olup olmadığını denetleyin.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
subscriptionId	path	True	string	Abonelik tanımlayıcısı.
api-version	query	True	string	API'nin sürümü.

İstek Gövdesi

Name	Gerekli	Tür	Description
name	True	string	Denetlenecek IoT hub'ının adı.

Yanıtlar

Name	Tür	Description
200 OK	IotHubNameAvailabilityInfo	Bu zaman uyumlu bir işlemdir. Gövde, IoT hub adının kullanılabilir olup olmadığını belirten JSON serileştirilmiş bir yanıt içerir. Ad kullanılamıyorsa, gövde nedeni içerir.
Other Status Codes	ErrorDetails	DefaultErrorResponse

Güvenlik

azure_auth

Azure Active Directory OAuth2 Flow

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

Scopes

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

IotHubResource_CheckNameAvailability

Sample Request

HTTP

POST https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/providers/Microsoft.Devices/checkNameAvailability?api-version=2018-04-01

{
  "name": "test-request"
}

Sample Response

Status code:

200

{
  "nameAvailable": true,
  "reason": "Invalid",
  "message": ""
}

Tanımlar

Name	Description
ErrorDetails	Hata ayrıntıları.
IotHubNameAvailabilityInfo	Belirli bir IoT hub adının kullanılabilir olup olmadığını gösteren özellikler.
IotHubNameUnavailabilityReason	Kullanılamama nedeni.
OperationInputs	Giriş değerleri.

ErrorDetails

Hata ayrıntıları.

Name	Tür	Description
code	string	Hata kodu.
details	string	Hata ayrıntıları.
httpStatusCode	string	HTTP durum kodu.
message	string	Hata iletisi.

IotHubNameAvailabilityInfo

Belirli bir IoT hub adının kullanılabilir olup olmadığını gösteren özellikler.

Name	Tür	Description
message	string	Ayrıntılı neden iletisi.
nameAvailable	boolean	Sağlanan adın kullanılabilir olup olmadığını gösteren değer.
reason	IotHubNameUnavailabilityReason	Kullanılamama nedeni.

IotHubNameUnavailabilityReason

Kullanılamama nedeni.

Name	Tür	Description
AlreadyExists	string
Invalid	string

OperationInputs

Giriş değerleri.

Name	Tür	Description
name	string	Denetlenecek IoT hub'ının adı.