Disks - Create Or Update

Cria ou atualiza um disco.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/disks/{diskName}?api-version=2021-12-01

Parâmetros de URI

Name In Required Type Description
diskName
path True
  • string

O nome do disco gerenciado que está sendo criado. O nome não pode ser alterado depois que o disco é criado. Os caracteres com suporte para o nome são a-z, A-Z, 0-9, _ e -. O tamanho máximo do nome é de 80 caracteres.

resourceGroupName
path True
  • string

O nome do grupo de recursos.

subscriptionId
path True
  • string

Credenciais de assinatura que identificam exclusivamente Microsoft Azure assinatura. 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

Name Required Type Description
location True
  • string

Localização do recurso

properties.creationData True

Informações de origem do disco. As informações de CreationData não podem ser alteradas após a criação do disco.

extendedLocation

O local estendido em que o disco será criado. O local estendido não pode ser alterado.

properties.burstingEnabled
  • boolean

Defina como true para habilitar a intermitência além do destino de desempenho provisionado do disco. O bursting está desabilitado por padrão. Não se aplica a discos Ultra.

properties.completionPercent
  • number

Porcentagem concluída para a cópia em segundo plano quando um recurso é criado por meio da operação CopyStart.

properties.dataAccessAuthMode

Requisitos de autenticação adicionais ao exportar ou carregar em um disco ou instantâneo.

properties.diskAccessId
  • string

ID do ARM do recurso DiskAccess para usar pontos de extremidade privados em discos.

properties.diskIOPSReadOnly
  • integer

O número total de IOPS que serão permitidos em todas as VMs que montam o disco compartilhado como ReadOnly. Uma operação pode transferir entre 4k e 256 mil bytes.

properties.diskIOPSReadWrite
  • integer

O número de IOPS permitido para este disco; somente settable para discos UltraSSD. Uma operação pode transferir entre 4k e 256 mil bytes.

properties.diskMBpsReadOnly
  • integer

A taxa de transferência total (MBps) que será permitida em todas as VMs que montam o disco compartilhado como ReadOnly. MBps significa milhões de bytes por segundo – o MB aqui usa a notação ISO, de potências de 10.

properties.diskMBpsReadWrite
  • integer

A largura de banda permitida para este disco; somente settable para discos UltraSSD. MBps significa milhões de bytes por segundo – o MB aqui usa a notação ISO, de potências de 10.

properties.diskSizeGB
  • integer

Se creationData.createOption estiver vazio, esse campo será obrigatório e indicará o tamanho do disco a ser criado. Se esse campo estiver presente para atualizações ou criação com outras opções, ele indicará um redimensionamento. Os redimensionamentos só serão permitidos se o disco não estiver anexado a uma VM em execução e só puderem aumentar o tamanho do disco.

properties.encryption

A propriedade encryption pode ser usada para criptografar dados em repouso com chaves gerenciadas pelo cliente ou chaves gerenciadas pela plataforma.

properties.encryptionSettingsCollection

A coleção de configurações de criptografia usada para Azure Disk Encryption pode conter várias configurações de criptografia por disco ou instantâneo.

properties.hyperVGeneration

A geração de hipervisor da Máquina Virtual. Aplicável somente a discos do sistema operacional.

properties.maxShares
  • integer

O número máximo de VMs que podem ser anexadas ao disco ao mesmo tempo. Valor maior que um indica um disco que pode ser montado em várias VMs ao mesmo tempo.

properties.networkAccessPolicy

Política para acessar o disco por meio da rede.

properties.osType

O tipo de sistema operacional.

properties.publicNetworkAccess

Política para controlar a exportação no disco.

properties.purchasePlan

Informações do plano de compra para a imagem da qual o disco do sistema operacional foi criado. Por exemplo: {name: 2019-Datacenter, publisher: MicrosoftWindowsServer, product: WindowsServer}

properties.securityProfile

Contém as informações relacionadas à segurança do recurso.

properties.supportedCapabilities

Lista de recursos com suporte para a imagem da qual o disco do sistema operacional foi criado.

properties.supportsHibernation
  • boolean

Indica que o sistema operacional em um disco dá suporte à hibernação.

properties.tier
  • string

Camada de desempenho do disco (por exemplo, P4, S10), conforme descrito aqui: https://azure.microsoft.com/en-us/pricing/details/managed-disks/. Não se aplica a discos Ultra.

sku

O nome do sku dos discos. Pode ser Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS, Premium_ZRS ou StandardSSD_ZRS.

tags
  • object

Marcações de recursos

zones
  • string[]

A lista de zonas lógicas para Disco.

Respostas

Name Type Description
200 OK

OK

202 Accepted

Aceito

Segurança

azure_auth

Flow Azure Active Directory OAuth2

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

Scopes

Name Description
user_impersonation representar sua conta de usuário

Exemplos

Create a confidential VM supported disk encrypted with customer managed key
Create a managed disk and associate with disk access resource.
Create a managed disk and associate with disk encryption set.
Create a managed disk by copying a snapshot.
Create a managed disk by importing an unmanaged blob from a different subscription.
Create a managed disk by importing an unmanaged blob from the same subscription.
Create a managed disk from a platform image.
Create a managed disk from an existing managed disk in the same or different subscription.
Create a managed disk from ImportSecure create option
Create a managed disk from UploadPreparedSecure create option
Create a managed disk with dataAccessAuthMode
Create a managed disk with security profile
Create a managed disk with ssd zrs account type.
Create a managed upload disk.
Create an empty managed disk in extended location.
Create an empty managed disk.
Create an ultra managed disk with logicalSectorSize 512E

Create a confidential VM supported disk encrypted with customer managed key

Sample Request

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2021-12-01

{
  "location": "West US",
  "properties": {
    "osType": "Windows",
    "securityProfile": {
      "securityType": "ConfidentialVM_DiskEncryptedWithCustomerKey",
      "secureVMDiskEncryptionSetId": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{diskEncryptionSetName}"
    },
    "creationData": {
      "createOption": "FromImage",
      "imageReference": {
        "id": "/Subscriptions/{subscriptionId}/Providers/Microsoft.Compute/Locations/westus/Publishers/{publisher}/ArtifactTypes/VMImage/Offers/{offer}/Skus/{sku}/Versions/1.0.0"
      }
    }
  }
}

Sample Response

{
  "name": "myDisk",
  "location": "West US",
  "properties": {
    "provisioningState": "Updating",
    "osType": "Windows",
    "securityProfile": {
      "securityType": "ConfidentialVM_DiskEncryptedWithCustomerKey",
      "secureVMDiskEncryptionSetId": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{diskEncryptionSetName}"
    },
    "creationData": {
      "createOption": "FromImage",
      "imageReference": {
        "id": "/Subscriptions/{subscriptionId}/Providers/Microsoft.Compute/Locations/westus/Publishers/{publisher}/ArtifactTypes/VMImage/Offers/{offer}/Skus/{sku}/Versions/1.0.0"
      }
    }
  }
}
{
  "name": "myDisk",
  "location": "West US",
  "properties": {
    "provisioningState": "Succeeded",
    "osType": "Windows",
    "securityProfile": {
      "securityType": "ConfidentialVM_DiskEncryptedWithCustomerKey",
      "secureVMDiskEncryptionSetId": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{diskEncryptionSetName}"
    },
    "creationData": {
      "createOption": "FromImage",
      "imageReference": {
        "id": "/Subscriptions/{subscriptionId}/Providers/Microsoft.Compute/Locations/westus/Publishers/{publisher}/ArtifactTypes/VMImage/Offers/{offer}/Skus/{sku}/Versions/1.0.0"
      }
    }
  }
}

Create a managed disk and associate with disk access resource.

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2021-12-01

{
  "location": "West US",
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "networkAccessPolicy": "AllowPrivate",
    "diskAccessId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskAccesses/{existing-diskAccess-name}"
  }
}

Sample Response

{
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myDisk"
}
{
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "provisioningState": "Succeeded",
    "networkAccessPolicy": "AllowPrivate",
    "diskAccessId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskAccesses/{existing-diskAccess-name}",
    "publicNetworkAccess": "Enabled"
  },
  "location": "West US",
  "name": "myDisk"
}

Create a managed disk and associate with disk encryption set.

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2021-12-01

{
  "location": "West US",
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "encryption": {
      "diskEncryptionSetId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"
    }
  }
}

Sample Response

{
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myDisk"
}
{
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "provisioningState": "Succeeded",
    "encryption": {
      "diskEncryptionSetId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"
    }
  },
  "location": "West US",
  "name": "myDisk"
}

Create a managed disk by copying a snapshot.

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2021-12-01

{
  "location": "West US",
  "properties": {
    "creationData": {
      "createOption": "Copy",
      "sourceResourceId": "subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/snapshots/mySnapshot"
    }
  }
}

Sample Response

{
  "name": "myDisk",
  "location": "West US",
  "properties": {
    "provisioningState": "Updating",
    "creationData": {
      "createOption": "Copy",
      "sourceResourceId": "subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/snapshots/mySnapshot"
    }
  }
}
{
  "name": "myDisk",
  "location": "West US",
  "properties": {
    "provisioningState": "Updating",
    "creationData": {
      "createOption": "Copy",
      "sourceResourceId": "subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/snapshots/mySnapshot"
    }
  }
}

Create a managed disk by importing an unmanaged blob from a different subscription.

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2021-12-01

{
  "location": "West US",
  "properties": {
    "creationData": {
      "createOption": "Import",
      "storageAccountId": "subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Storage/storageAccounts/myStorageAccount",
      "sourceUri": "https://mystorageaccount.blob.core.windows.net/osimages/osimage.vhd"
    }
  }
}

Sample Response

{
  "name": "myDisk",
  "location": "West US",
  "properties": {
    "provisioningState": "Updating",
    "creationData": {
      "createOption": "Import",
      "storageAccountId": "subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Storage/storageAccounts/myStorageAccount",
      "sourceUri": "https://mystorageaccount.blob.core.windows.net/osimages/osimage.vhd"
    }
  }
}
{
  "name": "myDisk",
  "location": "West US",
  "properties": {
    "provisioningState": "Updating",
    "creationData": {
      "createOption": "Import",
      "storageAccountId": "subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Storage/storageAccounts/myStorageAccount",
      "sourceUri": "https://mystorageaccount.blob.core.windows.net/osimages/osimage.vhd"
    }
  }
}

Create a managed disk by importing an unmanaged blob from the same subscription.

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2021-12-01

{
  "location": "West US",
  "properties": {
    "creationData": {
      "createOption": "Import",
      "sourceUri": "https://mystorageaccount.blob.core.windows.net/osimages/osimage.vhd"
    }
  }
}

Sample Response

{
  "name": "myDisk",
  "location": "West US",
  "properties": {
    "provisioningState": "Updating",
    "creationData": {
      "createOption": "Import",
      "sourceUri": "https://mystorageaccount.blob.core.windows.net/osimages/osimage.vhd"
    }
  }
}
{
  "name": "myDisk",
  "location": "West US",
  "properties": {
    "provisioningState": "Updating",
    "creationData": {
      "createOption": "Import",
      "sourceUri": "https://mystorageaccount.blob.core.windows.net/osimages/osimage.vhd"
    }
  }
}

Create a managed disk from a platform image.

Sample Request

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2021-12-01

{
  "location": "West US",
  "properties": {
    "osType": "Windows",
    "creationData": {
      "createOption": "FromImage",
      "imageReference": {
        "id": "/Subscriptions/{subscriptionId}/Providers/Microsoft.Compute/Locations/westus/Publishers/{publisher}/ArtifactTypes/VMImage/Offers/{offer}/Skus/{sku}/Versions/1.0.0"
      }
    }
  }
}

Sample Response

{
  "name": "myDisk",
  "location": "West US",
  "properties": {
    "osType": "Windows",
    "hyperVGeneration": "V1",
    "purchasePlan": {
      "name": "{sku}",
      "publisher": "{publisher}",
      "product": "{offer}"
    },
    "supportedCapabilities": {
      "acceleratedNetwork": true,
      "architecture": "Arm64"
    },
    "creationData": {
      "createOption": "FromImage",
      "imageReference": {
        "id": "/Subscriptions/{subscriptionId}/Providers/Microsoft.Compute/Locations/westus/Publishers/{publisher}/ArtifactTypes/VMImage/Offers/{offer}/Skus/{sku}/Versions/1.0.0"
      }
    },
    "provisioningState": "Updating"
  }
}
{
  "name": "myDisk",
  "location": "West US",
  "properties": {
    "provisioningState": "Succeeded",
    "osType": "Windows",
    "hyperVGeneration": "V1",
    "purchasePlan": {
      "name": "{sku}",
      "publisher": "{publisher}",
      "product": "{offer}"
    },
    "supportedCapabilities": {
      "acceleratedNetwork": true
    },
    "creationData": {
      "createOption": "FromImage",
      "imageReference": {
        "id": "/Subscriptions/{subscriptionId}/Providers/Microsoft.Compute/Locations/westus/Publishers/{publisher}/ArtifactTypes/VMImage/Offers/{offer}/Skus/{sku}/Versions/1.0.0"
      }
    }
  }
}

Create a managed disk from an existing managed disk in the same or different subscription.

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk2?api-version=2021-12-01

{
  "location": "West US",
  "properties": {
    "creationData": {
      "createOption": "Copy",
      "sourceResourceId": "subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk1"
    }
  }
}

Sample Response

{
  "properties": {
    "creationData": {
      "createOption": "Copy",
      "sourceResourceId": "subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk1"
    },
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myDisk2"
}
{
  "properties": {
    "creationData": {
      "createOption": "Copy",
      "sourceResourceId": "subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk1"
    },
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myDisk2"
}

Create a managed disk from ImportSecure create option

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2021-12-01

{
  "location": "West US",
  "properties": {
    "osType": "Windows",
    "securityProfile": {
      "securityType": "ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey"
    },
    "creationData": {
      "createOption": "ImportSecure",
      "storageAccountId": "subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Storage/storageAccounts/myStorageAccount",
      "sourceUri": "https://mystorageaccount.blob.core.windows.net/osimages/osimage.vhd",
      "securityDataUri": "https://mystorageaccount.blob.core.windows.net/osimages/vmgs.vhd"
    }
  }
}

Sample Response

{
  "name": "myDisk",
  "location": "West US",
  "properties": {
    "provisioningState": "Updating",
    "osType": "Windows",
    "securityProfile": {
      "securityType": "ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey"
    },
    "creationData": {
      "createOption": "ImportSecure",
      "storageAccountId": "subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Storage/storageAccounts/myStorageAccount",
      "sourceUri": "https://mystorageaccount.blob.core.windows.net/osimages/osimage.vhd",
      "securityDataUri": "https://mystorageaccount.blob.core.windows.net/osimages/vmgs.vhd"
    }
  }
}
{
  "name": "myDisk",
  "location": "West US",
  "properties": {
    "provisioningState": "Succeeded",
    "osType": "Windows",
    "securityProfile": {
      "securityType": "ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey"
    },
    "creationData": {
      "createOption": "ImportSecure",
      "storageAccountId": "subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Storage/storageAccounts/myStorageAccount",
      "sourceUri": "https://mystorageaccount.blob.core.windows.net/osimages/osimage.vhd",
      "securityDataUri": "https://mystorageaccount.blob.core.windows.net/osimages/vmgs.vhd"
    }
  }
}

Create a managed disk from UploadPreparedSecure create option

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2021-12-01

{
  "location": "West US",
  "properties": {
    "osType": "Windows",
    "securityProfile": {
      "securityType": "TrustedLaunch"
    },
    "creationData": {
      "createOption": "UploadPreparedSecure",
      "uploadSizeBytes": 10737418752
    }
  }
}

Sample Response

{
  "properties": {
    "osType": "Windows",
    "securityProfile": {
      "securityType": "TrustedLaunch"
    },
    "creationData": {
      "createOption": "UploadPreparedSecure",
      "uploadSizeBytes": 10737418752
    },
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myDisk"
}
{
  "properties": {
    "osType": "Windows",
    "securityProfile": {
      "securityType": "TrustedLaunch"
    },
    "creationData": {
      "createOption": "UploadPreparedSecure",
      "uploadSizeBytes": 10737418752
    },
    "provisioningState": "Succeeded"
  },
  "location": "West US",
  "name": "myDisk"
}

Create a managed disk with dataAccessAuthMode

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2021-12-01

{
  "location": "West US",
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "dataAccessAuthMode": "AzureActiveDirectory"
  }
}

Sample Response

{
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myDisk"
}
{
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "provisioningState": "Succeeded",
    "dataAccessAuthMode": "AzureActiveDirectory"
  },
  "location": "West US",
  "name": "myDisk"
}

Create a managed disk with security profile

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2021-12-01

{
  "location": "North Central US",
  "properties": {
    "osType": "Windows",
    "securityProfile": {
      "securityType": "TrustedLaunch"
    },
    "creationData": {
      "createOption": "FromImage",
      "imageReference": {
        "id": "/Subscriptions/{subscriptionId}/Providers/Microsoft.Compute/Locations/uswest/Publishers/Microsoft/ArtifactTypes/VMImage/Offers/{offer}"
      }
    }
  }
}

Sample Response

{
  "name": "myDisk",
  "location": "North Central US",
  "properties": {
    "provisioningState": "Updating",
    "osType": "Windows",
    "securityProfile": {
      "securityType": "TrustedLaunch"
    },
    "creationData": {
      "createOption": "FromImage",
      "imageReference": {
        "id": "/Subscriptions/{subscriptionId}/Providers/Microsoft.Compute/Locations/uswest/Publishers/Microsoft/ArtifactTypes/VMImage/Offers/{offer}"
      }
    }
  }
}
{
  "name": "myDisk",
  "location": "North Central US",
  "properties": {
    "provisioningState": "Succeeded",
    "osType": "Windows",
    "securityProfile": {
      "securityType": "TrustedLaunch"
    },
    "creationData": {
      "createOption": "FromImage",
      "imageReference": {
        "id": "/Subscriptions/{subscriptionId}/Providers/Microsoft.Compute/Locations/uswest/Publishers/Microsoft/ArtifactTypes/VMImage/Offers/{offer}"
      }
    }
  }
}

Create a managed disk with ssd zrs account type.

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2021-12-01

{
  "location": "West US",
  "sku": {
    "name": "Premium_ZRS"
  },
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200
  }
}

Sample Response

{
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myDisk",
  "sku": {
    "name": "Premium_ZRS",
    "tier": "Premium"
  }
}
{
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myDisk",
  "sku": {
    "name": "Premium_ZRS",
    "tier": "Premium"
  }
}

Create a managed upload disk.

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2021-12-01

{
  "location": "West US",
  "properties": {
    "creationData": {
      "createOption": "Upload",
      "uploadSizeBytes": 10737418752
    }
  }
}

Sample Response

{
  "properties": {
    "creationData": {
      "createOption": "Upload",
      "uploadSizeBytes": 10737418752
    },
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myDisk"
}
{
  "properties": {
    "creationData": {
      "createOption": "Upload",
      "uploadSizeBytes": 10737418752
    },
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myDisk"
}

Create an empty managed disk in extended location.

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2021-12-01

{
  "location": "West US",
  "extendedLocation": {
    "type": "EdgeZone",
    "name": "{edge-zone-id}"
  },
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200
  }
}

Sample Response

{
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myDisk",
  "extendedLocation": {
    "type": "EdgeZone",
    "name": "{edge-zone-id}"
  }
}
{
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myDisk",
  "extendedLocation": {
    "type": "EdgeZone",
    "name": "{edge-zone-id}"
  }
}

Create an empty managed disk.

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2021-12-01

{
  "location": "West US",
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200
  }
}

Sample Response

{
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myDisk"
}
{
  "properties": {
    "creationData": {
      "createOption": "Empty"
    },
    "diskSizeGB": 200,
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myDisk"
}

Create an ultra managed disk with logicalSectorSize 512E

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk?api-version=2021-12-01

{
  "location": "West US",
  "sku": {
    "name": "UltraSSD_LRS"
  },
  "properties": {
    "creationData": {
      "createOption": "Empty",
      "logicalSectorSize": 512
    },
    "diskSizeGB": 200
  }
}

Sample Response

{
  "properties": {
    "creationData": {
      "createOption": "Empty",
      "logicalSectorSize": 512
    },
    "diskSizeGB": 200,
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myDisk",
  "sku": {
    "name": "UltraSSD_LRS",
    "tier": "Ultra"
  }
}
{
  "properties": {
    "creationData": {
      "createOption": "Empty",
      "logicalSectorSize": 512
    },
    "diskSizeGB": 200,
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myDisk",
  "sku": {
    "name": "UltraSSD_LRS",
    "tier": "Ultra"
  }
}

Definições

Architecture

Arquitetura de CPU compatível com um disco do sistema operacional.

CreationData

Dados usados ao criar um disco.

DataAccessAuthMode

Requisitos de autenticação adicionais ao exportar ou carregar em um disco ou instantâneo.

Disk

Recurso de disco.

DiskCreateOption

Isso enumera as possíveis fontes da criação de um disco.

DiskSecurityProfile

Contém as informações relacionadas à segurança do recurso.

DiskSecurityTypes

Especifica o SecurityType da VM. Aplicável somente para discos do sistema operacional.

DiskSku

O nome da SKU dos discos. Pode ser Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS, Premium_ZRS ou StandardSSD_ZRS.

DiskState

Isso enumera o estado possível do disco.

DiskStorageAccountTypes

O nome do sku.

Encryption

Criptografia em configurações de repouso para disco ou instantâneo

EncryptionSettingsCollection

Configurações de criptografia para disco ou instantâneo

EncryptionSettingsElement

Configurações de criptografia para um volume de disco.

EncryptionType

O tipo de chave usada para criptografar os dados do disco.

ExtendedLocation

O tipo complexo do local estendido.

ExtendedLocationTypes

O tipo do local estendido.

HyperVGeneration

A geração de hipervisor da Máquina Virtual. Aplicável somente a discos do sistema operacional.

ImageDiskReference

A imagem de origem usada para criar o disco.

KeyVaultAndKeyReference

Key Vault url de chave e id do cofre do KeK, KeK é opcional e, quando fornecido, é usado para desembrulhar a encryptionKey

KeyVaultAndSecretReference

Key Vault url secreta e id do cofre da chave de criptografia

NetworkAccessPolicy

Política para acessar o disco por meio da rede.

OperatingSystemTypes

O tipo de sistema operacional.

PropertyUpdatesInProgress

Propriedades do disco para o qual a atualização está pendente.

PublicNetworkAccess

Política para controlar a exportação no disco.

PurchasePlan

Usado para estabelecer o contexto de compra de qualquer artefato de terceiros por meio do MarketPlace.

ShareInfoElement
SourceVault

A ID do cofre é uma ID de recurso Resource Manager do Azure no formulário /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.KeyVault/vaults/{vaultName}

SupportedCapabilities

Lista de recursos com suporte persistentes no recurso de disco para uso de VM.

Architecture

Arquitetura de CPU compatível com um disco do sistema operacional.

Name Type Description
Arm64
  • string
x64
  • string

CreationData

Dados usados ao criar um disco.

Name Type Description
createOption

Isso enumera as possíveis fontes da criação de um disco.

galleryImageReference

Obrigatório se for criado com base em uma Imagem da Galeria. A ID do ImageDiskReference será a ID do ARM da versão de imagem de galeria compartilhada da qual criar um disco.

imageReference

Informações de origem do disco.

logicalSectorSize
  • integer

Tamanho do setor lógico em bytes para discos Ultra. Os valores compatíveis são 512 e 4096. O padrão é 4096.

securityDataUri
  • string

Se createOption for ImportSecure, esse será o URI de um blob a ser importado para o estado convidado da VM.

sourceResourceId
  • string

Se createOption for Copy, essa será a ID do ARM do instantâneo ou disco de origem.

sourceUniqueId
  • string

Se esse campo for definido, essa será a ID exclusiva que identifica a origem desse recurso.

sourceUri
  • string

Se createOption for Import, esse será o URI de um blob a ser importado para um disco gerenciado.

storageAccountId
  • string

Obrigatório se createOption for Import. O identificador do Azure Resource Manager da conta de armazenamento que contém o blob a ser importado como um disco.

uploadSizeBytes
  • integer

Se createOption for Upload, esse será o tamanho do conteúdo do upload, incluindo o rodapé VHD. Esse valor deve estar entre 20972032 (20 MiB + 512 bytes para o rodapé VHD) e 35183298347520 bytes (32 TiB + 512 bytes para o rodapé VHD).

DataAccessAuthMode

Requisitos de autenticação adicionais ao exportar ou carregar em um disco ou instantâneo.

Name Type Description
AzureActiveDirectory
  • string

Quando a URL de exportação/upload é usada, o sistema verifica se o usuário tem uma identidade no Azure Active Directory e tem as permissões necessárias para exportar/carregar os dados. Consulte aka.ms/DisksAzureADAuth.

None
  • string

Nenhuma autenticação adicional seria executada ao acessar a URL de exportação/upload.

Disk

Recurso de disco.

Name Type Description
extendedLocation

O local estendido onde o disco será criado. O local estendido não pode ser alterado.

id
  • string

ID do recurso

location
  • string

Localização do recurso

managedBy
  • string

Um URI relativo que contém a ID da VM que tem o disco anexado.

managedByExtended
  • string[]

Lista de URIs relativas que contêm as IDs das VMs que têm o disco anexado. maxShares deve ser definido como um valor maior que um para discos para permitir anexá-los a várias VMs.

name
  • string

Nome do recurso

properties.burstingEnabled
  • boolean

Defina como true para habilitar a intermitência além do destino de desempenho provisionado do disco. O bursting está desabilitado por padrão. Não se aplica a discos Ultra.

properties.completionPercent
  • number

Porcentagem concluída para a cópia em segundo plano quando um recurso é criado por meio da operação CopyStart.

properties.creationData

Informações de origem do disco. As informações de CreationData não podem ser alteradas após a criação do disco.

properties.dataAccessAuthMode

Requisitos de autenticação adicionais ao exportar ou carregar em um disco ou instantâneo.

properties.diskAccessId
  • string

ID do ARM do recurso DiskAccess para usar pontos de extremidade privados em discos.

properties.diskIOPSReadOnly
  • integer

O número total de IOPS que serão permitidos em todas as VMs que montam o disco compartilhado como ReadOnly. Uma operação pode transferir entre 4k e 256 mil bytes.

properties.diskIOPSReadWrite
  • integer

O número de IOPS permitido para este disco; somente settable para discos UltraSSD. Uma operação pode transferir entre 4k e 256 mil bytes.

properties.diskMBpsReadOnly
  • integer

A taxa de transferência total (MBps) que será permitida em todas as VMs que montam o disco compartilhado como ReadOnly. MBps significa milhões de bytes por segundo – o MB aqui usa a notação ISO, de potências de 10.

properties.diskMBpsReadWrite
  • integer

A largura de banda permitida para este disco; somente settable para discos UltraSSD. MBps significa milhões de bytes por segundo – o MB aqui usa a notação ISO, de potências de 10.

properties.diskSizeBytes
  • integer

O tamanho do disco em bytes. Este campo é somente leitura.

properties.diskSizeGB
  • integer

Se creationData.createOption estiver vazio, esse campo será obrigatório e indicará o tamanho do disco a ser criado. Se esse campo estiver presente para atualizações ou criação com outras opções, ele indicará um redimensionamento. Os redimensionamentos só serão permitidos se o disco não estiver anexado a uma VM em execução e só puderem aumentar o tamanho do disco.

properties.diskState

O estado do disco.

properties.encryption

A propriedade encryption pode ser usada para criptografar dados em repouso com chaves gerenciadas pelo cliente ou chaves gerenciadas pela plataforma.

properties.encryptionSettingsCollection

A coleção de configurações de criptografia usada para Azure Disk Encryption pode conter várias configurações de criptografia por disco ou instantâneo.

properties.hyperVGeneration

A geração do hipervisor da Máquina Virtual. Aplicável somente a discos do sistema operacional.

properties.maxShares
  • integer

O número máximo de VMs que podem ser anexadas ao disco ao mesmo tempo. Valor maior que um indica um disco que pode ser montado em várias VMs ao mesmo tempo.

properties.networkAccessPolicy

Política para acessar o disco por meio da rede.

properties.osType

O tipo de sistema operacional.

properties.propertyUpdatesInProgress

Propriedades do disco para o qual a atualização está pendente.

properties.provisioningState
  • string

O estado de provisionamento de disco.

properties.publicNetworkAccess

Política para controlar a exportação no disco.

properties.purchasePlan

Informações do plano de compra para a imagem da qual o disco do sistema operacional foi criado. Por exemplo: {name: 2019-Datacenter, publisher: MicrosoftWindowsServer, product: WindowsServer}

properties.securityProfile

Contém as informações relacionadas à segurança do recurso.

properties.shareInfo

Detalhes da lista de todas as VMs que têm o disco anexado. maxShares deve ser definido como um valor maior que um para discos para permitir anexá-los a várias VMs.

properties.supportedCapabilities

Lista de recursos com suporte para a imagem da qual o disco do sistema operacional foi criado.

properties.supportsHibernation
  • boolean

Indica que o sistema operacional em um disco dá suporte à hibernação.

properties.tier
  • string

Camada de desempenho do disco (por exemplo, P4, S10), conforme descrito aqui: https://azure.microsoft.com/en-us/pricing/details/managed-disks/. Não se aplica a discos Ultra.

properties.timeCreated
  • string

A hora em que o disco foi criado.

properties.uniqueId
  • string

Guid exclusivo identificando o recurso.

sku

O nome da SKU dos discos. Pode ser Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS, Premium_ZRS ou StandardSSD_ZRS.

tags
  • object

Marcações de recursos

type
  • string

Tipo de recurso

zones
  • string[]

A lista de zonas lógicas para Disco.

DiskCreateOption

Isso enumera as possíveis fontes da criação de um disco.

Name Type Description
Attach
  • string

O disco será anexado a uma VM.

Copy
  • string

Crie um novo disco ou instantâneo copiando de um disco ou instantâneo especificado pelo sourceResourceId especificado.

CopyStart
  • string

Crie um novo disco usando um processo de cópia profunda, em que a criação do recurso é considerada concluída somente depois que todos os dados tiverem sido copiados da origem.

Empty
  • string

Crie um disco de dados vazio de um tamanho dado pelo diskSizeGB.

FromImage
  • string

Crie um novo disco a partir de uma imagem de plataforma especificada pela imageReference ou galleryImageReference.

Import
  • string

Crie um disco importando de um blob especificado por um sourceUri em uma conta de armazenamento especificada por storageAccountId.

ImportSecure
  • string

Semelhante à opção Importar criar. Criar uma nova VM de Inicialização Confiável ou disco com suporte de VM confidencial importando blob adicional para o estado convidado da VM especificado por securityDataUri na conta de armazenamento especificada por storageAccountId

Restore
  • string

Crie um novo disco copiando de um ponto de recuperação de backup.

Upload
  • string

Crie um novo disco obtendo um token de gravação e usando-o para carregar diretamente o conteúdo do disco.

UploadPreparedSecure
  • string

Semelhante à opção Upload criar. Criar uma nova VM de Inicialização Confiável ou disco com suporte para VM confidencial e carregar usando o token de gravação no estado convidado do disco e da VM

DiskSecurityProfile

Contém as informações relacionadas à segurança do recurso.

Name Type Description
secureVMDiskEncryptionSetId
  • string

ResourceId do conjunto de criptografia de disco associado ao disco com suporte à VM confidencial criptografado com chave gerenciada pelo cliente

securityType

Especifica o SecurityType da VM. Aplicável somente para discos do sistema operacional.

DiskSecurityTypes

Especifica o SecurityType da VM. Aplicável somente para discos do sistema operacional.

Name Type Description
ConfidentialVM_DiskEncryptedWithCustomerKey
  • string

Indica disco de VM confidencial com disco do sistema operacional e estado convidado de VM criptografado com uma chave gerenciada pelo cliente

ConfidentialVM_DiskEncryptedWithPlatformKey
  • string

Indica o disco de VM confidencial com o disco do sistema operacional e o estado convidado da VM criptografados com uma chave gerenciada pela plataforma

ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey
  • string

Indica disco de VM confidencial com apenas o estado convidado da VM criptografado

TrustedLaunch
  • string

O Trusted Launch fornece recursos de segurança, como inicialização segura e vTPM (Virtual Trusted Platform Module)

DiskSku

O nome da SKU dos discos. Pode ser Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS, Premium_ZRS ou StandardSSD_ZRS.

Name Type Description
name

O nome do sku.

tier
  • string

A camada de sku.

DiskState

Isso enumera o estado possível do disco.

Name Type Description
ActiveSAS
  • string

Atualmente, o disco tem um Uri sas ativo associado a ele.

ActiveSASFrozen
  • string

O disco é anexado a uma VM em estado hibernado e tem um URI DE SAS ativo associado a ele.

ActiveUpload
  • string

Um disco é criado para upload e um token de gravação foi emitido para carregá-lo.

Attached
  • string

No momento, o disco está anexado a uma VM em execução.

Frozen
  • string

O disco é anexado a uma VM que está em estado hibernado.

ReadyToUpload
  • string

Um disco está pronto para ser criado por upload solicitando um token de gravação.

Reserved
  • string

O disco é anexado a uma VM desalocada interrompida.

Unattached
  • string

O disco não está sendo usado e pode ser anexado a uma VM.

DiskStorageAccountTypes

O nome do sku.

Name Type Description
Premium_LRS
  • string

Armazenamento com redundância local SSD Premium. Melhor para cargas de trabalho confidenciais de produção e desempenho.

Premium_ZRS
  • string

Premium armazenamento com redundância de zona SSD. Melhor para as cargas de trabalho de produção que precisam de resiliência de armazenamento em relação a falhas de zona.

StandardSSD_LRS
  • string

Armazenamento com redundância local SSD Standard. Melhor para servidores Web, aplicativos empresariais e desenvolvimento/teste pouco usados.

StandardSSD_ZRS
  • string

Armazenamento com redundância de zona SSD Padrão. Melhor para servidores Web, aplicativos empresariais levemente usados e desenvolvimento/teste que precisam de resiliência de armazenamento contra falhas de zona.

Standard_LRS
  • string

Armazenamento com redundância local HDD Standard. Melhor para acesso de backup, não crítico e não frequente.

UltraSSD_LRS
  • string

Armazenamento com redundância local do Ultra SSD. Melhor para cargas de trabalho com uso intensivo de E/S, como SAP HANA, bancos de dados de camada superior (por exemplo, SQL, Oracle) e outras cargas de trabalho pesadas para transações.

Encryption

Criptografia em configurações de repouso para disco ou instantâneo

Name Type Description
diskEncryptionSetId
  • string

ResourceId do conjunto de criptografia de disco a ser usado para habilitar a criptografia em repouso.

type

O tipo de chave usado para criptografar os dados do disco.

EncryptionSettingsCollection

Configurações de criptografia para disco ou instantâneo

Name Type Description
enabled
  • boolean

Defina esse sinalizador como true e forneça DiskEncryptionKey e KeyEncryptionKey opcional para habilitar a criptografia. Defina esse sinalizador como false e remova DiskEncryptionKey e KeyEncryptionKey para desabilitar a criptografia. Se EncryptionSettings for nulo no objeto de solicitação, as configurações existentes permanecerão inalteradas.

encryptionSettings

Uma coleção de configurações de criptografia, uma para cada volume de disco.

encryptionSettingsVersion
  • string

Descreve que tipo de criptografia é usado para os discos. Depois que esse campo for definido, ele não poderá ser substituído. '1.0' corresponde a Azure Disk Encryption com o aplicativo AAD.'1.1' corresponde a Azure Disk Encryption.

EncryptionSettingsElement

Configurações de criptografia para um volume de disco.

Name Type Description
diskEncryptionKey

Key Vault url secreta e id do cofre da chave de criptografia de disco

keyEncryptionKey

Key Vault url de chave e id do cofre da chave de criptografia de chave. KeyEncryptionKey é opcional e quando fornecido é usado para desembrulhar a chave de criptografia de disco.

EncryptionType

O tipo de chave usada para criptografar os dados do disco.

Name Type Description
EncryptionAtRestWithCustomerKey
  • string

O disco é criptografado em repouso com a chave gerenciada pelo cliente que pode ser alterada e revogada por um cliente.

EncryptionAtRestWithPlatformAndCustomerKeys
  • string

O disco é criptografado em repouso com duas camadas de criptografia. Uma das chaves é gerenciada pelo cliente e a outra chave é gerenciada pela Plataforma.

EncryptionAtRestWithPlatformKey
  • string

O disco é criptografado em repouso com a chave gerenciada da Plataforma. É o tipo de criptografia padrão. Esse não é um tipo de criptografia válido para conjuntos de criptografia de disco.

ExtendedLocation

O tipo complexo do local estendido.

Name Type Description
name
  • string

O nome do local estendido.

type

O tipo do local estendido.

ExtendedLocationTypes

O tipo do local estendido.

Name Type Description
EdgeZone
  • string

HyperVGeneration

A geração de hipervisor da Máquina Virtual. Aplicável somente a discos do sistema operacional.

Name Type Description
V1
  • string
V2
  • string

ImageDiskReference

A imagem de origem usada para criar o disco.

Name Type Description
id
  • string

Um uri relativo que contém um Repositório de Imagens de Plataforma ou uma referência de imagem de usuário.

lun
  • integer

Se o disco for criado a partir do disco de dados de uma imagem, esse será um índice que indica qual dos discos de dados na imagem a ser usado. Para discos do sistema operacional, esse campo é nulo.

KeyVaultAndKeyReference

Key Vault url de chave e id do cofre do KeK, KeK é opcional e, quando fornecido, é usado para desembrulhar a encryptionKey

Name Type Description
keyUrl
  • string

Url apontando para uma chave ou segredo no KeyVault

sourceVault

ID do recurso do KeyVault que contém a chave ou o segredo

KeyVaultAndSecretReference

Key Vault url secreta e id do cofre da chave de criptografia

Name Type Description
secretUrl
  • string

Url apontando para uma chave ou segredo no KeyVault

sourceVault

ID do recurso do KeyVault que contém a chave ou o segredo

NetworkAccessPolicy

Política para acessar o disco por meio da rede.

Name Type Description
AllowAll
  • string

O disco pode ser exportado ou carregado de qualquer rede.

AllowPrivate
  • string

O disco pode ser exportado ou carregado para usar os pontos de extremidade privados do recurso DiskAccess.

DenyAll
  • string

O disco não pode ser exportado.

OperatingSystemTypes

O tipo de sistema operacional.

Name Type Description
Linux
  • string
Windows
  • string

PropertyUpdatesInProgress

Propriedades do disco para o qual a atualização está pendente.

Name Type Description
targetTier
  • string

A camada de desempenho de destino do disco se uma operação de alteração de camada estiver em andamento.

PublicNetworkAccess

Política para controlar a exportação no disco.

Name Type Description
Disabled
  • string

Você não pode acessar os dados subjacentes do disco publicamente na Internet mesmo quando NetworkAccessPolicy está definido como AllowAll. Você pode acessar os dados por meio do URI sas somente de sua VNET confiável do Azure quando NetworkAccessPolicy estiver definido como AllowPrivate.

Enabled
  • string

Você pode gerar um URI SAS para acessar os dados subjacentes do disco publicamente na Internet quando NetworkAccessPolicy estiver definido como AllowAll. Você pode acessar os dados por meio do URI sas somente de sua VNET confiável do Azure quando NetworkAccessPolicy estiver definido como AllowPrivate.

PurchasePlan

Usado para estabelecer o contexto de compra de qualquer artefato de terceiros por meio do MarketPlace.

Name Type Description
name
  • string

A ID do plano.

product
  • string

Especifica o produto da imagem do marketplace. Esse é o mesmo valor que Offer no elemento imageReference.

promotionCode
  • string

O código de promoção da oferta.

publisher
  • string

A ID do editor.

ShareInfoElement

Name Type Description
vmUri
  • string

Um URI relativo que contém a ID da VM que tem o disco anexado.

SourceVault

A ID do cofre é uma ID de recurso Resource Manager do Azure no formulário /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.KeyVault/vaults/{vaultName}

Name Type Description
id
  • string

ID do recurso

SupportedCapabilities

Lista de recursos com suporte persistentes no recurso de disco para uso de VM.

Name Type Description
acceleratedNetwork
  • boolean

True se a imagem da qual o disco do sistema operacional é criado dá suporte à rede acelerada.

architecture

Arquitetura de CPU com suporte por um disco do sistema operacional.