Dedicated Hosts - Create Or Update

Referência

Service:: Compute

API Version:: 2024-03-01

Criar ou atualizar um host dedicado.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}/hosts/{hostName}?api-version=2024-03-01

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
hostGroupName	path	True	string	O nome do grupo de hosts dedicado.
hostName	path	True	string	O nome do host dedicado.
resourceGroupName	path	True	string	O nome do grupo de recursos.
subscriptionId	path	True	string	Credenciais de assinatura que identificam exclusivamente a assinatura do Microsoft Azure. A ID da assinatura faz parte do URI para cada chamada de serviço.
api-version	query	True	string	Versão da API do cliente.

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
location	True	string	Localização do recurso
sku	True	Sku	SKU do host dedicado para a geração de hardware e a família de VMs. Somente o nome é necessário para ser definido. Liste SKUs Microsoft.Compute para obter uma lista de valores possíveis.
properties.autoReplaceOnFailure		boolean	Especifica se o host dedicado deve ser substituído automaticamente em caso de falha. O valor é padronizado como "true" quando não fornecido.
properties.licenseType		DedicatedHostLicenseTypes	Especifica o tipo de licença de software que será aplicado às VMs implantadas no host dedicado. Os valores possíveis são: Nenhum,Windows_Server_Hybrid,Windows_Server_Perpetual. O valor padrão é: Nenhum.
properties.platformFaultDomain		integer	Domínio de falha do host dedicado em um grupo de hosts dedicado.
tags		object	Marcações de recursos

Respostas

Nome	Tipo	Description
200 OK	DedicatedHost	OK
201 Created	DedicatedHost	Criado
Other Status Codes	CloudError	Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory

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

Scopes

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

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"
  }
}


import com.azure.resourcemanager.compute.fluent.models.DedicatedHostInner;
import com.azure.resourcemanager.compute.models.Sku;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for DedicatedHosts CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/
     * dedicatedHostExamples/DedicatedHost_CreateOrUpdate.json
     */
    /**
     * Sample code: Create or update a dedicated host .
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createOrUpdateADedicatedHost(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().manager().serviceClient().getDedicatedHosts().createOrUpdate("myResourceGroup",
            "myDedicatedHostGroup", "myDedicatedHost",
            new DedicatedHostInner().withLocation("westus").withTags(mapOf("department", "HR"))
                .withSku(new Sku().withName("DSv3-Type1")).withPlatformFaultDomain(1),
            com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armcompute_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/compute/armcompute/v5"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/92de53a5f1e0e03c94b40475d2135d97148ed014/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/dedicatedHostExamples/DedicatedHost_CreateOrUpdate.json
func ExampleDedicatedHostsClient_BeginCreateOrUpdate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcompute.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewDedicatedHostsClient().BeginCreateOrUpdate(ctx, "myResourceGroup", "myDedicatedHostGroup", "myDedicatedHost", armcompute.DedicatedHost{
		Location: to.Ptr("westus"),
		Tags: map[string]*string{
			"department": to.Ptr("HR"),
		},
		Properties: &armcompute.DedicatedHostProperties{
			PlatformFaultDomain: to.Ptr[int32](1),
		},
		SKU: &armcompute.SKU{
			Name: to.Ptr("DSv3-Type1"),
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.DedicatedHost = armcompute.DedicatedHost{
	// 	Name: to.Ptr("myDedicatedHost"),
	// 	ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/HostGroups/myDedicatedHostGroup/hosts/myDedicatedHost"),
	// 	Location: to.Ptr("westus"),
	// 	Tags: map[string]*string{
	// 		"department": to.Ptr("HR"),
	// 	},
	// 	Properties: &armcompute.DedicatedHostProperties{
	// 		AutoReplaceOnFailure: to.Ptr(false),
	// 		HostID: to.Ptr("{GUID}"),
	// 		LicenseType: to.Ptr(armcompute.DedicatedHostLicenseTypesWindowsServerHybrid),
	// 		PlatformFaultDomain: to.Ptr[int32](1),
	// 	},
	// 	SKU: &armcompute.SKU{
	// 		Name: to.Ptr("DSv3-Type1"),
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:: 201

{
  "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}"
  }
}

Status code:: 200

{
  "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"
  }
}

Definições

Nome	Description
ApiError	Erro de API.
ApiErrorBase	Base de erros de API.
CloudError	Uma resposta de erro do serviço de computação.
DedicatedHost	Especifica informações sobre o host dedicado.
DedicatedHostAllocatableVM	Representa a capacidade não utilizada do host dedicado em termos de um tamanho de VM específico.
DedicatedHostAvailableCapacity	Capacidade não utilizada do host dedicado.
DedicatedHostInstanceView	A exibição de instância de um host dedicado.
DedicatedHostLicenseTypes	Especifica o tipo de licença de software que será aplicado às VMs implantadas no host dedicado. Os valores possíveis são: Nenhum,Windows_Server_Hybrid,Windows_Server_Perpetual. O valor padrão é: Nenhum.
InnerError	Detalhes do erro interno.
InstanceViewStatus	Exibição de instância status.
Sku	Descreve um sku de conjunto de dimensionamento de máquinas virtuais. OBSERVAÇÃO: se o novo SKU de VM não tiver suporte no hardware em que o conjunto de dimensionamento está atualmente, você precisará desalocar as VMs no conjunto de dimensionamento antes de modificar o nome da SKU.
StatusLevelTypes	O código de nível.
SubResourceReadOnly

ApiError

Erro de API.

Nome	Tipo	Description
code	string	O código de erro.
details	ApiErrorBase[]	Os detalhes do erro da API
innererror	InnerError	O erro interno da API
message	string	A mensagem de erro.
target	string	O destino do erro específico.

ApiErrorBase

Base de erros de API.

Nome	Tipo	Description
code	string	O código de erro.
message	string	A mensagem de erro.
target	string	O destino do erro específico.

CloudError

Uma resposta de erro do serviço de computação.

Nome	Tipo	Description
error	ApiError	Erro de API.

DedicatedHost

Especifica informações sobre o host dedicado.

Nome	Tipo	Description
id	string	ID do recurso
location	string	Localização do recurso
name	string	Nome do recurso
properties.autoReplaceOnFailure	boolean	Especifica se o host dedicado deve ser substituído automaticamente em caso de falha. O valor é padronizado como "true" quando não fornecido.
properties.hostId	string	Uma ID exclusiva gerada e atribuída ao host dedicado pela plataforma. Não muda ao longo do tempo de vida do host.
properties.instanceView	DedicatedHostInstanceView	A exibição de instância de host dedicada.
properties.licenseType	DedicatedHostLicenseTypes	Especifica o tipo de licença de software que será aplicado às VMs implantadas no host dedicado. Os valores possíveis são: Nenhum,Windows_Server_Hybrid,Windows_Server_Perpetual. O valor padrão é: Nenhum.
properties.platformFaultDomain	integer	Domínio de falha do host dedicado em um grupo de hosts dedicado.
properties.provisioningState	string	O estado de provisionamento, que aparece apenas na resposta.
properties.provisioningTime	string	A data em que o host foi provisionado pela primeira vez.
properties.timeCreated	string	Especifica a hora em que o recurso Host Dedicado foi criado. Versão mínima da api: 2021-11-01.
properties.virtualMachines	SubResourceReadOnly[]	Uma lista de referências a todas as máquinas virtuais no Host Dedicado.
sku	Sku	SKU do host dedicado para a geração de hardware e a família de VMs. Somente o nome é necessário para ser definido. Liste SKUs Microsoft.Compute para obter uma lista de valores possíveis.
tags	object	Marcações de recursos
type	string	Tipo de recurso

DedicatedHostAllocatableVM

Representa a capacidade não utilizada do host dedicado em termos de um tamanho de VM específico.

Nome	Tipo	Description
count	number	Número máximo de VMs de tamanho vmSize que podem caber na capacidade restante do host dedicado.
vmSize	string	Tamanho da VM em termos dos quais a capacidade não utilizada é representada.

DedicatedHostAvailableCapacity

Capacidade não utilizada do host dedicado.

Nome	Tipo	Description
allocatableVMs	DedicatedHostAllocatableVM[]	A capacidade não utilizada do host dedicado representado em termos de cada tamanho de VM que tem permissão para ser implantado no host dedicado.

DedicatedHostInstanceView

A exibição de instância de um host dedicado.

Nome	Tipo	Description
assetId	string	Especifica a ID exclusiva do computador físico dedicado no qual o host dedicado reside.
availableCapacity	DedicatedHostAvailableCapacity	Capacidade não utilizada do host dedicado.
statuses	InstanceViewStatus[]	O recurso status informações.

DedicatedHostLicenseTypes

Especifica o tipo de licença de software que será aplicado às VMs implantadas no host dedicado. Os valores possíveis são: Nenhum,Windows_Server_Hybrid,Windows_Server_Perpetual. O valor padrão é: Nenhum.

Nome	Tipo	Description
None	string
Windows_Server_Hybrid	string
Windows_Server_Perpetual	string

InnerError

Detalhes do erro interno.

Nome	Tipo	Description
errordetail	string	A mensagem de erro interna ou despejo de exceção.
exceptiontype	string	O tipo de exceção.

InstanceViewStatus

Exibição de instância status.

Nome	Tipo	Description
code	string	O código do status.
displayStatus	string	O rótulo localizável curto para o status.
level	StatusLevelTypes	O código de nível.
message	string	A mensagem de status detalhada, inclusive para alertas e mensagens de erro.
time	string	A hora do status.

Sku

Descreve um sku de conjunto de dimensionamento de máquinas virtuais. OBSERVAÇÃO: se o novo SKU de VM não tiver suporte no hardware em que o conjunto de dimensionamento está atualmente, você precisará desalocar as VMs no conjunto de dimensionamento antes de modificar o nome da SKU.

Nome	Tipo	Description
capacity	integer	Especifica o número de máquinas virtuais no conjunto de dimensionamento.
name	string	O nome do sku.
tier	string	Especifica a camada de máquinas virtuais em um conjunto de dimensionamento. Valores possíveis: Standard Basic

StatusLevelTypes

O código de nível.

Nome	Tipo	Description
Error	string
Info	string
Warning	string

SubResourceReadOnly

Nome	Tipo	Description
id	string	ID do recurso