Iot Dps Resource - Check Provisioning Service Name Availability

Service:

IoT Hub Device Provisioning Service

Version d'API:

2022-12-12

Vérifiez si un nom de service d’approvisionnement est disponible. Cela valide si le nom est valide de manière syntactique et si le nom est utilisable

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Devices/checkProvisioningServiceNameAvailability?api-version=2022-12-12

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
subscriptionId	path	True	string	Identificateur d’abonnement.
api-version	query	True	string	Version de l’API.

Corps de la demande

Nom	Obligatoire	Type	Description
name	True	string	Nom du service d’approvisionnement à vérifier.

Réponses

Nom	Type	Description
200 OK	NameAvailabilityInfo	Il s’agit d’une opération synchrone. Le corps contient une réponse sérialisée JSON qui spécifie si le nom du service d’approvisionnement est disponible. Si le nom n’est pas disponible, le corps contient la raison.
Other Status Codes	ErrorDetails	Réponse d’erreur par défaut.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

DPSCheckName

Exemple de requête

HTTP

POST https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/providers/Microsoft.Devices/checkProvisioningServiceNameAvailability?api-version=2022-12-12

{
  "name": "test213123"
}

Exemple de réponse

Code d’état:

200

{
  "nameAvailable": true,
  "reason": "Invalid",
  "message": "name is valid"
}

Définitions

Nom	Description
ErrorDetails	Détails de l’erreur.
NameAvailabilityInfo	Description de la disponibilité du nom.
NameUnavailabilityReason	spécifie la raison pour laquelle un nom n’est pas disponible
OperationInputs	Valeurs d’entrée pour l’appel de résultats d’opération.

ErrorDetails

Object

Détails de l’erreur.

Nom	Type	Description
code	integer (int32)	Code d’erreur.
details	string	Détails de l’erreur.
httpStatusCode	string	Code d’état HTTP.
message	string	Message d’erreur.

NameAvailabilityInfo

Object

Description de la disponibilité du nom.

Nom	Type	Description
message	string	message contenant un nom de raison détaillé n’est pas disponible
nameAvailable	boolean	spécifie si un nom est disponible ou non
reason	NameUnavailabilityReason	spécifie la raison pour laquelle un nom n’est pas disponible

NameUnavailabilityReason

Énumération

spécifie la raison pour laquelle un nom n’est pas disponible

Valeur	Description
AlreadyExists
Invalid

OperationInputs

Object

Valeurs d’entrée pour l’appel de résultats d’opération.

Nom	Type	Description
name	string	Nom du service d’approvisionnement à vérifier.