Partilhar via


Capacity Reservations - Create Or Update

A operação para criar ou atualizar uma reserva de capacidade. Tenha em atenção que algumas propriedades só podem ser definidas durante a criação da reserva de capacidade. Consulte para https://aka.ms/CapacityReservation obter mais detalhes.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/capacityReservationGroups/{capacityReservationGroupName}/capacityReservations/{capacityReservationName}?api-version=2024-03-01

Parâmetros do URI

Name Em Necessário Tipo Description
capacityReservationGroupName
path True

string

O nome do grupo de reservas de capacidade.

capacityReservationName
path True

string

O nome da reserva de capacidade.

resourceGroupName
path True

string

O nome do grupo de recursos.

subscriptionId
path True

string

Credenciais de subscrição que identificam exclusivamente a subscrição do Microsoft Azure. O ID da subscrição faz parte do URI para cada chamada de serviço.

api-version
query True

string

Versão da API de Cliente.

Corpo do Pedido

Name Necessário Tipo Description
location True

string

Localização do recurso

sku True

Sku

SKU do recurso para o qual a capacidade precisa de ser reservada. É necessário definir o nome e a capacidade do SKU. Atualmente, são suportados os Skus da VM com a capacidade denominada "CapacityReservationSupported" definida como true. Veja Listar SKUs Microsoft.Compute numa região (https://docs.microsoft.com/rest/api/compute/resourceskus/list) para obter valores suportados.

tags

object

Etiquetas de recursos

zones

string[]

Zona de Disponibilidade a utilizar para esta reserva de capacidade. A zona tem de ser um valor único e também deve fazer parte da lista de zonas especificadas durante a criação do grupo de reservas de capacidade. A zona só pode ser atribuída durante a criação. Se não for fornecida, a reserva só suporta implementações não zonais. Se for fornecido, impõe a VM/VMSS através desta reserva de capacidade para estar na mesma zona.

Respostas

Name Tipo Description
200 OK

CapacityReservation

OK

201 Created

CapacityReservation

Criado

Other Status Codes

CloudError

Resposta de erro que descreve a razão pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Description
user_impersonation representar a sua conta de utilizador

Exemplos

Create or update a capacity reservation .

Pedido de amostra

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/myCapacityReservationGroup/capacityReservations/myCapacityReservation?api-version=2024-03-01

{
  "location": "westus",
  "tags": {
    "department": "HR"
  },
  "sku": {
    "name": "Standard_DS1_v2",
    "capacity": 4
  },
  "zones": [
    "1"
  ]
}

Resposta da amostra

{
  "name": "myCapacityReservation",
  "location": "westus",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/myCapacityReservationGroup/capacityReservations/myCapacityReservation",
  "tags": {
    "department": "HR"
  },
  "sku": {
    "name": "Standard_DS1_v2",
    "capacity": 4
  },
  "zones": [
    "1"
  ],
  "properties": {
    "platformFaultDomainCount": 3,
    "reservationId": "{GUID}",
    "provisioningState": "Creating",
    "provisioningTime": "2021-06-27T01:02:38.3138469+00:00"
  }
}
{
  "name": "myCapacityReservation",
  "location": "westus",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/myCapacityReservationGroup/capacityReservations/myCapacityReservation",
  "tags": {
    "department": "HR"
  },
  "sku": {
    "name": "Standard_DS1_v2",
    "capacity": 4
  },
  "zones": [
    "1"
  ],
  "properties": {
    "platformFaultDomainCount": 3,
    "reservationId": "{GUID}",
    "provisioningState": "Creating",
    "provisioningTime": "2021-06-27T01:02:38.3138469+00:00"
  }
}

Definições

Name Description
ApiError

Erro de API.

ApiErrorBase

Base de erros da API.

CapacityReservation

Especifica informações sobre a reserva de capacidade.

CapacityReservationInstanceView

A vista de instância de uma reserva de capacidade que fornece como instantâneo das propriedades do runtime da reserva de capacidade gerida pela plataforma e que pode mudar fora das operações do plano de controlo.

CapacityReservationUtilization

Representa a utilização da reserva de capacidade em termos de recursos alocados.

CloudError

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

InnerError

Detalhes do erro interno.

InstanceViewStatus

Estado da vista de instância.

Sku

Descreve um sku de conjunto de dimensionamento de máquinas virtuais. NOTA: se o novo SKU da VM não for suportado no hardware em que o conjunto de dimensionamento está atualmente ativado, terá de desalocar as VMs no conjunto de dimensionamento antes de modificar o nome do SKU.

StatusLevelTypes

O código de nível.

SubResourceReadOnly

ApiError

Erro de API.

Name 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 da API.

Name Tipo Description
code

string

O código de erro.

message

string

A mensagem de erro.

target

string

O destino do erro específico.

CapacityReservation

Especifica informações sobre a reserva de capacidade.

Name Tipo Description
id

string

ID do Recurso

location

string

Localização do recurso

name

string

Nome do recurso

properties.instanceView

CapacityReservationInstanceView

A vista Instância de reserva de capacidade.

properties.platformFaultDomainCount

integer

Especifica o valor da contagem de domínios de falha que a Reserva de Capacidade suporta para o tamanho de VM pedido. Nota: A contagem de domínios de falha especificada para um recurso (como o conjunto de dimensionamento de máquinas virtuais) tem de ser menor ou igual a este valor se implementar com a reserva de capacidade. Versão mínima da API: 2022-08-01.

properties.provisioningState

string

O estado de aprovisionamento, que só aparece na resposta.

properties.provisioningTime

string

A data em que a reserva de capacidade foi atualizada pela última vez.

properties.reservationId

string

Um ID exclusivo gerado e atribuído à reserva de capacidade pela plataforma que não é alterado ao longo da duração do recurso.

properties.timeCreated

string

Especifica o momento em que o recurso Reserva de Capacidade foi criado. Versão mínima da API: 2021-11-01.

properties.virtualMachinesAssociated

SubResourceReadOnly[]

Uma lista de todos os IDs de recursos da máquina virtual associados à reserva de capacidade.

sku

Sku

SKU do recurso para o qual a capacidade precisa de ser reservada. É necessário definir o nome e a capacidade do SKU. Atualmente, são suportados os Skus da VM com a capacidade denominada "CapacityReservationSupported" definida como true. Veja Listar SKUs Microsoft.Compute numa região (https://docs.microsoft.com/rest/api/compute/resourceskus/list) para obter valores suportados.

tags

object

Etiquetas de recursos

type

string

Tipo de recurso

zones

string[]

Zona de Disponibilidade a utilizar para esta reserva de capacidade. A zona tem de ser um valor único e também deve fazer parte da lista de zonas especificadas durante a criação do grupo de reservas de capacidade. A zona só pode ser atribuída durante a criação. Se não for fornecida, a reserva só suporta implementações não zonais. Se for fornecido, impõe a VM/VMSS através desta reserva de capacidade para estar na mesma zona.

CapacityReservationInstanceView

A vista de instância de uma reserva de capacidade que fornece como instantâneo das propriedades do runtime da reserva de capacidade gerida pela plataforma e que pode mudar fora das operações do plano de controlo.

Name Tipo Description
statuses

InstanceViewStatus[]

As informações do estado do recurso.

utilizationInfo

CapacityReservationUtilization

Capacidade não otimizada da reserva de capacidade.

CapacityReservationUtilization

Representa a utilização da reserva de capacidade em termos de recursos alocados.

Name Tipo Description
currentCapacity

integer

O valor fornece a capacidade atual do tamanho da VM que foi reservada com êxito e para a qual o cliente está a ser faturado. Versão mínima da API: 2022-08-01.

virtualMachinesAllocated

SubResourceReadOnly[]

Uma lista de todos os IDs de recursos de máquinas virtuais atribuídos à reserva de capacidade.

CloudError

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

Name Tipo Description
error

ApiError

Erro de API.

InnerError

Detalhes do erro interno.

Name Tipo Description
errordetail

string

A mensagem de erro interna ou a informação de falha de segurança da exceção.

exceptiontype

string

O tipo de exceção.

InstanceViewStatus

Estado da vista de instância.

Name Tipo Description
code

string

O código de estado.

displayStatus

string

A etiqueta localizável curta para o estado.

level

StatusLevelTypes

O código de nível.

message

string

A mensagem de estado detalhada, incluindo para alertas e mensagens de erro.

time

string

A hora do estado.

Sku

Descreve um sku de conjunto de dimensionamento de máquinas virtuais. NOTA: se o novo SKU da VM não for suportado no hardware em que o conjunto de dimensionamento está atualmente ativado, terá de desalocar as VMs no conjunto de dimensionamento antes de modificar o nome do SKU.

Name 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 num conjunto de dimensionamento.

Valores Possíveis:

Standard

Básica

StatusLevelTypes

O código de nível.

Name Tipo Description
Error

string

Info

string

Warning

string

SubResourceReadOnly

Name Tipo Description
id

string

ID do Recurso