Capacità Microsoft.ComputeReservationGroups/capacityReservations

Definizione di risorsa Bicep

Il tipo di risorsa capacityReservationGroups/capacityReservations può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.Compute/capacityReservationGroups/capacityReservations, aggiungere il bicep seguente al modello.

resource symbolicname 'Microsoft.Compute/capacityReservationGroups/capacityReservations@2025-04-01' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  properties: {
    scheduleProfile: {
      end: 'string'
      start: 'string'
    }
  }
  sku: {
    capacity: int
    name: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
  zones: [
    'string'
  ]
}

Valori delle proprietà

Microsoft.Compute/capacityReservationGroups/capacityReservations

Nome Descrizione Valore
ubicazione Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
nome Nome della risorsa stringa (obbligatorio)
genitore In Bicep è possibile specificare la risorsa padre per una risorsa figlio. È necessario aggiungere questa proprietà solo quando la risorsa figlio viene dichiarata all'esterno della risorsa padre.

Per altre informazioni, vedere risorsa figlio all'esterno della risorsa padre.
Nome simbolico per la risorsa di tipo: capacityReservationGroups
proprietà Proprietà della prenotazione della capacità. Proprietà della struttura CapacityReservationProperties
Sku SKU della risorsa per cui è necessario riservare la capacità. Il nome e la capacità dello SKU devono essere impostati. Per le prenotazioni di capacità in blocco, sku.capacity può accettare solo i valori 1, 2, 4, 8, 16, 32, 64. Attualmente sono supportati gli SKU delle macchine virtuali con la funzionalità denominata "CapacityReservationSupported" impostata su true. Quando 'CapacityReservationSupported' è true, la funzionalità SKU specifica anche 'SupportedCapacityReservationTypes', che elenca i tipi di prenotazioni di capacità (ad esempio Targeted o Block) supportati dallo SKU. Per i valori supportati, vedere Elencare gli SKU Microsoft.Compute in un'area (/rest/api/compute/resourceskus/list). sku (obbligatorio)
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli
Zone Zone di disponibilità. stringa[]

Proprietà della struttura CapacityReservationProperties

Nome Descrizione Valore
scheduleProfile Definisce la pianificazione per le prenotazioni di capacità di tipo Blocco. Specifica la pianificazione durante la quale la prenotazione della capacità è attiva e la risorsa VM o VMSS può essere allocata utilizzando la prenotazione. Questa proprietà è obbligatoria e supportata solo quando il tipo di gruppo di prenotazione della capacità è "Blocca". I campi scheduleProfile, start e end non sono modificabili dopo la creazione. Versione minima dell'API: 2025-04-01. Per altri dettagli, vedere https://aka.ms/blockcapacityreservation. Profilo programmato

Profilo programmato

Nome Descrizione Valore
end La data di fine richiesta per le prenotazioni di capacità in blocco. Deve essere successivo alla data di inizio, con una durata compresa tra 1 e 14 giorni interi o tra 3 e 26 settimane intere. Esempio: 2025-06-28. corda
start La data di inizio richiesta per le prenotazioni di capacità in blocco. Deve essere presente o entro 56 giorni in futuro. Per la programmazione nello stesso giorno, le richieste devono essere inviate prima delle 11:30 UTC. Esempio: 2025-06-27. corda

Sku

Nome Descrizione Valore
capacità Specifica il numero di macchine virtuali nel set di scalabilità. Int
nome Nome sku. corda
livello Specifica il livello di macchine virtuali in un set di scalabilità.

Valori possibili:

standard

Basic
corda

TrackedResourceTags

Nome Descrizione Valore

Esempi di utilizzo

Esempi bicep

Un esempio di base di distribuzione della Prenotazione di capacità all'interno di un gruppo di prenotazione di capacità.

param resourceName string = 'acctest0001'
param location string = 'westus'

resource capacityReservationGroup 'Microsoft.Compute/capacityReservationGroups@2022-03-01' = {
  name: '${resourceName}-ccrg'
  location: location
}

resource capacityReservation 'Microsoft.Compute/capacityReservationGroups/capacityReservations@2022-03-01' = {
  parent: capacityReservationGroup
  name: '${resourceName}-ccr'
  location: location
  sku: {
    capacity: 2
    name: 'Standard_F2'
  }
}

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa capacityReservationGroups/capacityReservations può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.Compute/capacityReservationGroups/capacityReservations, aggiungere il codice JSON seguente al modello.

{
  "type": "Microsoft.Compute/capacityReservationGroups/capacityReservations",
  "apiVersion": "2025-04-01",
  "name": "string",
  "location": "string",
  "properties": {
    "scheduleProfile": {
      "end": "string",
      "start": "string"
    }
  },
  "sku": {
    "capacity": "int",
    "name": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  },
  "zones": [ "string" ]
}

Valori delle proprietà

Microsoft.Compute/capacityReservationGroups/capacityReservations

Nome Descrizione Valore
versione dell'API Versione dell'API '2025-04-01'
ubicazione Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
nome Nome della risorsa stringa (obbligatorio)
proprietà Proprietà della prenotazione della capacità. Proprietà della struttura CapacityReservationProperties
Sku SKU della risorsa per cui è necessario riservare la capacità. Il nome e la capacità dello SKU devono essere impostati. Per le prenotazioni di capacità in blocco, sku.capacity può accettare solo i valori 1, 2, 4, 8, 16, 32, 64. Attualmente sono supportati gli SKU delle macchine virtuali con la funzionalità denominata "CapacityReservationSupported" impostata su true. Quando 'CapacityReservationSupported' è true, la funzionalità SKU specifica anche 'SupportedCapacityReservationTypes', che elenca i tipi di prenotazioni di capacità (ad esempio Targeted o Block) supportati dallo SKU. Per i valori supportati, vedere Elencare gli SKU Microsoft.Compute in un'area (/rest/api/compute/resourceskus/list). sku (obbligatorio)
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli
digitare Tipo di risorsa 'Microsoft.Compute/capacityReservationGroups/capacityReservations'
Zone Zone di disponibilità. stringa[]

Proprietà della struttura CapacityReservationProperties

Nome Descrizione Valore
scheduleProfile Definisce la pianificazione per le prenotazioni di capacità di tipo Blocco. Specifica la pianificazione durante la quale la prenotazione della capacità è attiva e la risorsa VM o VMSS può essere allocata utilizzando la prenotazione. Questa proprietà è obbligatoria e supportata solo quando il tipo di gruppo di prenotazione della capacità è "Blocca". I campi scheduleProfile, start e end non sono modificabili dopo la creazione. Versione minima dell'API: 2025-04-01. Per altri dettagli, vedere https://aka.ms/blockcapacityreservation. Profilo programmato

Profilo programmato

Nome Descrizione Valore
end La data di fine richiesta per le prenotazioni di capacità in blocco. Deve essere successivo alla data di inizio, con una durata compresa tra 1 e 14 giorni interi o tra 3 e 26 settimane intere. Esempio: 2025-06-28. corda
start La data di inizio richiesta per le prenotazioni di capacità in blocco. Deve essere presente o entro 56 giorni in futuro. Per la programmazione nello stesso giorno, le richieste devono essere inviate prima delle 11:30 UTC. Esempio: 2025-06-27. corda

Sku

Nome Descrizione Valore
capacità Specifica il numero di macchine virtuali nel set di scalabilità. Int
nome Nome sku. corda
livello Specifica il livello di macchine virtuali in un set di scalabilità.

Valori possibili:

standard

Basic
corda

TrackedResourceTags

Nome Descrizione Valore

Esempi di utilizzo

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa capacityReservationGroups/capacityReservations può essere distribuito con operazioni destinate a:

  • Gruppi di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.Compute/capacityReservationGroups/capacityReservations, aggiungere il codice Terraform seguente al modello.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/capacityReservationGroups/capacityReservations@2025-04-01"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      scheduleProfile = {
        end = "string"
        start = "string"
      }
    }
    sku = {
      capacity = int
      name = "string"
      tier = "string"
    }
    zones = [
      "string"
    ]
  }
}

Valori delle proprietà

Microsoft.Compute/capacityReservationGroups/capacityReservations

Nome Descrizione Valore
ubicazione Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
nome Nome della risorsa stringa (obbligatorio)
parent_id ID della risorsa padre per questa risorsa. ID per la risorsa di tipo: capacityReservationGroups
proprietà Proprietà della prenotazione della capacità. Proprietà della struttura CapacityReservationProperties
Sku SKU della risorsa per cui è necessario riservare la capacità. Il nome e la capacità dello SKU devono essere impostati. Per le prenotazioni di capacità in blocco, sku.capacity può accettare solo i valori 1, 2, 4, 8, 16, 32, 64. Attualmente sono supportati gli SKU delle macchine virtuali con la funzionalità denominata "CapacityReservationSupported" impostata su true. Quando 'CapacityReservationSupported' è true, la funzionalità SKU specifica anche 'SupportedCapacityReservationTypes', che elenca i tipi di prenotazioni di capacità (ad esempio Targeted o Block) supportati dallo SKU. Per i valori supportati, vedere Elencare gli SKU Microsoft.Compute in un'area (/rest/api/compute/resourceskus/list). sku (obbligatorio)
Tag Tag delle risorse Dizionario di nomi e valori di tag.
digitare Tipo di risorsa "Microsoft.Compute/capacityReservationGroups/capacityReservations@2025-04-01"
Zone Zone di disponibilità. stringa[]

Proprietà della struttura CapacityReservationProperties

Nome Descrizione Valore
scheduleProfile Definisce la pianificazione per le prenotazioni di capacità di tipo Blocco. Specifica la pianificazione durante la quale la prenotazione della capacità è attiva e la risorsa VM o VMSS può essere allocata utilizzando la prenotazione. Questa proprietà è obbligatoria e supportata solo quando il tipo di gruppo di prenotazione della capacità è "Blocca". I campi scheduleProfile, start e end non sono modificabili dopo la creazione. Versione minima dell'API: 2025-04-01. Per altri dettagli, vedere https://aka.ms/blockcapacityreservation. Profilo programmato

Profilo programmato

Nome Descrizione Valore
end La data di fine richiesta per le prenotazioni di capacità in blocco. Deve essere successivo alla data di inizio, con una durata compresa tra 1 e 14 giorni interi o tra 3 e 26 settimane intere. Esempio: 2025-06-28. corda
start La data di inizio richiesta per le prenotazioni di capacità in blocco. Deve essere presente o entro 56 giorni in futuro. Per la programmazione nello stesso giorno, le richieste devono essere inviate prima delle 11:30 UTC. Esempio: 2025-06-27. corda

Sku

Nome Descrizione Valore
capacità Specifica il numero di macchine virtuali nel set di scalabilità. Int
nome Nome sku. corda
livello Specifica il livello di macchine virtuali in un set di scalabilità.

Valori possibili:

standard

Basic
corda

TrackedResourceTags

Nome Descrizione Valore

Esempi di utilizzo

Esempi di Terraform

Un esempio di base di distribuzione della Prenotazione di capacità all'interno di un gruppo di prenotazione di capacità.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westus"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "capacityReservationGroup" {
  type      = "Microsoft.Compute/capacityReservationGroups@2022-03-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = "${var.resource_name}-ccrg"
  location  = var.location
}

resource "azapi_resource" "capacityReservation" {
  type      = "Microsoft.Compute/capacityReservationGroups/capacityReservations@2022-03-01"
  parent_id = azapi_resource.capacityReservationGroup.id
  name      = "${var.resource_name}-ccr"
  location  = var.location
  body = {
    sku = {
      capacity = 2
      name     = "Standard_F2"
    }
  }
}