Dedicated Hosts - Create Or Update
Créez ou mettez à jour un hôte dédié .
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}/hosts/{hostName}?api-version=2024-03-01
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
host
|
path | True |
string |
Nom du groupe hôte dédié. |
host
|
path | True |
string |
Nom de l’hôte dédié . |
resource
|
path | True |
string |
Nom du groupe de ressources. |
subscription
|
path | True |
string |
Informations d’identification d’abonnement qui identifient de manière unique l’abonnement Microsoft Azure. L’ID d’abonnement fait partie de l’URI pour chaque appel de service. |
api-version
|
query | True |
string |
Version de l’API cliente. |
Corps de la demande
Nom | Obligatoire | Type | Description |
---|---|---|---|
location | True |
string |
Emplacement de la ressource |
sku | True |
Référence SKU de l’hôte dédié pour la génération de matériel et la famille de machines virtuelles. Seul le nom doit être défini. Répertoriez les références SKU Microsoft.Compute pour obtenir la liste des valeurs possibles. |
|
properties.autoReplaceOnFailure |
boolean |
Spécifie si l’hôte dédié doit être remplacé automatiquement en cas de défaillance. La valeur par défaut est « true » lorsqu’elle n’est pas fournie. |
|
properties.licenseType |
Spécifie le type de licence logicielle qui sera appliqué aux machines virtuelles déployées sur l’hôte dédié. Les valeurs possibles sont : None,Windows_Server_Hybrid,Windows_Server_Perpetual. La valeur par défaut est : None. |
||
properties.platformFaultDomain |
integer |
Domaine d’erreur de l’hôte dédié au sein d’un groupe hôte dédié. |
|
tags |
object |
Balises de ressource |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
Ok |
|
201 Created |
Date de création |
|
Other Status Codes |
Réponse d’erreur décrivant la raison de l’échec de l’opération. |
Sécurité
azure_auth
Flux OAuth2 Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nom | Description |
---|---|
user_impersonation | Emprunter l’identité de votre compte d’utilisateur |
Exemples
Create or update a dedicated host .
Sample Request
PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/hostGroups/myDedicatedHostGroup/hosts/myDedicatedHost?api-version=2024-03-01
{
"location": "westus",
"tags": {
"department": "HR"
},
"properties": {
"platformFaultDomain": 1
},
"sku": {
"name": "DSv3-Type1"
}
}
Sample Response
{
"name": "myDedicatedHost",
"location": "westus",
"id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/HostGroups/myDedicatedHostGroup/hosts/myDedicatedHost",
"tags": {
"department": "HR"
},
"sku": {
"name": "DSv3-Type1"
},
"properties": {
"platformFaultDomain": 1,
"autoReplaceOnFailure": true,
"hostId": "{GUID}"
}
}
{
"properties": {
"platformFaultDomain": 1,
"autoReplaceOnFailure": false,
"licenseType": "Windows_Server_Hybrid",
"hostId": "{GUID}"
},
"location": "westus",
"tags": {
"department": "HR"
},
"name": "myDedicatedHost",
"id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/HostGroups/myDedicatedHostGroup/hosts/myDedicatedHost",
"sku": {
"name": "DSv3-Type1"
}
}
Définitions
Nom | Description |
---|---|
Api |
Erreur d’API. |
Api |
Base d’erreurs de l’API. |
Cloud |
Réponse d’erreur du service de calcul. |
Dedicated |
Spécifie des informations sur l’hôte dédié. |
Dedicated |
Représente la capacité non utilisée de l’hôte dédié en termes de taille de machine virtuelle spécifique. |
Dedicated |
Capacité non utilisée de l’hôte dédié. |
Dedicated |
Vue instance d’un hôte dédié. |
Dedicated |
Spécifie le type de licence logicielle qui sera appliqué aux machines virtuelles déployées sur l’hôte dédié. Les valeurs possibles sont : None,Windows_Server_Hybrid,Windows_Server_Perpetual. La valeur par défaut est : None. |
Inner |
Détails internes de l’erreur. |
Instance |
Vue d’instance status. |
Sku |
Décrit une référence sku de groupe de machines virtuelles identiques. REMARQUE : Si la nouvelle référence SKU de machine virtuelle n’est pas prise en charge sur le matériel sur lequel se trouve actuellement le groupe identique, vous devez libérer les machines virtuelles dans le groupe identique avant de modifier le nom de la référence SKU. |
Status |
Code de niveau. |
Sub |
ApiError
Erreur d’API.
Nom | Type | Description |
---|---|---|
code |
string |
Code d'erreur. |
details |
Détails de l’erreur api |
|
innererror |
Erreur interne de l’API |
|
message |
string |
Message d’erreur. |
target |
string |
Cible de l’erreur particulière. |
ApiErrorBase
Base d’erreurs de l’API.
Nom | Type | Description |
---|---|---|
code |
string |
Code d'erreur. |
message |
string |
Message d’erreur. |
target |
string |
Cible de l’erreur particulière. |
CloudError
Réponse d’erreur du service de calcul.
Nom | Type | Description |
---|---|---|
error |
Erreur d’API. |
DedicatedHost
Spécifie des informations sur l’hôte dédié.
Nom | Type | Description |
---|---|---|
id |
string |
ID de ressource |
location |
string |
Emplacement de la ressource |
name |
string |
Nom de la ressource |
properties.autoReplaceOnFailure |
boolean |
Spécifie si l’hôte dédié doit être remplacé automatiquement en cas de défaillance. La valeur par défaut est « true » lorsqu’elle n’est pas fournie. |
properties.hostId |
string |
ID unique généré et affecté à l’hôte dédié par la plateforme. Ne change pas pendant toute la durée de vie de l’hôte. |
properties.instanceView |
Affichage instance hôte dédié. |
|
properties.licenseType |
Spécifie le type de licence logicielle qui sera appliqué aux machines virtuelles déployées sur l’hôte dédié. Les valeurs possibles sont : None,Windows_Server_Hybrid,Windows_Server_Perpetual. La valeur par défaut est : None. |
|
properties.platformFaultDomain |
integer |
Domaine d’erreur de l’hôte dédié au sein d’un groupe hôte dédié. |
properties.provisioningState |
string |
État d’approvisionnement, qui apparaît uniquement dans la réponse. |
properties.provisioningTime |
string |
Date à laquelle l’hôte a été approvisionné pour la première fois. |
properties.timeCreated |
string |
Spécifie l’heure à laquelle la ressource d’hôte dédié a été créée. Version minimale de l’api : 01/11/2021. |
properties.virtualMachines |
Liste des références à toutes les machines virtuelles dans l’hôte dédié. |
|
sku |
Référence SKU de l’hôte dédié pour la génération de matériel et la famille de machines virtuelles. Seul le nom doit être défini. Répertoriez les références SKU Microsoft.Compute pour obtenir la liste des valeurs possibles. |
|
tags |
object |
Balises de ressource |
type |
string |
Type de ressource |
DedicatedHostAllocatableVM
Représente la capacité non utilisée de l’hôte dédié en termes de taille de machine virtuelle spécifique.
Nom | Type | Description |
---|---|---|
count |
number |
Nombre maximal de machines virtuelles de taille vmSize pouvant tenir dans la capacité restante de l’hôte dédié. |
vmSize |
string |
Taille de machine virtuelle en termes de représentation de la capacité non utilisée. |
DedicatedHostAvailableCapacity
Capacité non utilisée de l’hôte dédié.
Nom | Type | Description |
---|---|---|
allocatableVMs |
Capacité inutilisée de l’hôte dédié représenté en termes de taille de machine virtuelle autorisée à être déployée sur l’hôte dédié. |
DedicatedHostInstanceView
Vue instance d’un hôte dédié.
Nom | Type | Description |
---|---|---|
assetId |
string |
Spécifie l’ID unique de l’ordinateur physique dédié sur lequel réside l’hôte dédié. |
availableCapacity |
Capacité non utilisée de l’hôte dédié. |
|
statuses |
La ressource status informations. |
DedicatedHostLicenseTypes
Spécifie le type de licence logicielle qui sera appliqué aux machines virtuelles déployées sur l’hôte dédié. Les valeurs possibles sont : None,Windows_Server_Hybrid,Windows_Server_Perpetual. La valeur par défaut est : None.
Nom | Type | Description |
---|---|---|
None |
string |
|
Windows_Server_Hybrid |
string |
|
Windows_Server_Perpetual |
string |
InnerError
Détails internes de l’erreur.
Nom | Type | Description |
---|---|---|
errordetail |
string |
Message d’erreur interne ou vidage d’exception. |
exceptiontype |
string |
Type d'exception. |
InstanceViewStatus
Vue d’instance status.
Nom | Type | Description |
---|---|---|
code |
string |
Code d'état. |
displayStatus |
string |
Étiquette courte localisable pour le status. |
level |
Code de niveau. |
|
message |
string |
Message de status détaillé, y compris pour les alertes et les messages d’erreur. |
time |
string |
Heure du status. |
Sku
Décrit une référence sku de groupe de machines virtuelles identiques. REMARQUE : Si la nouvelle référence SKU de machine virtuelle n’est pas prise en charge sur le matériel sur lequel se trouve actuellement le groupe identique, vous devez libérer les machines virtuelles dans le groupe identique avant de modifier le nom de la référence SKU.
Nom | Type | Description |
---|---|---|
capacity |
integer |
Spécifie le nombre de machines virtuelles dans le groupe identique. |
name |
string |
Nom de la référence sku. |
tier |
string |
Spécifie le niveau des machines virtuelles dans un groupe identique. |
StatusLevelTypes
Code de niveau.
Nom | Type | Description |
---|---|---|
Error |
string |
|
Info |
string |
|
Warning |
string |
SubResourceReadOnly
Nom | Type | Description |
---|---|---|
id |
string |
ID de ressource |