az disk

Azure Managed Disks 관리합니다.

Azure Virtual Machines 디스크를 운영 체제, 애플리케이션 및 데이터를 저장하는 위치로 사용합니다. 모든 Azure 가상 머신에는 운영 체제 디스크와 임시 디스크라는 두 개 이상의 디스크가 있습니다. 운영 체제 디스크는 이미지에서 만들어지며, 운영 체제 디스크 및 이미지 모두는 실제로 Azure Storage 계정에 저장된 가상 하드 디스크(VHD)입니다. 가상 머신에도 데이터 디스크가 있을 수 있으며 이러한 디스크도 VHD로 저장됩니다. Azure 관리형 및 관리되지 않는 데이터 디스크의 최대 크기는 4095GB입니다(미리 보기의 더 큰 디스크 제외). 또한 Azure Unmanaged Disks의 최대 용량은 4095GB입니다. 자세한 내용은 다음을 참조하세요.

명령

az disk create

관리 디스크를 만듭니다.

az disk delete

관리 디스크를 삭제합니다.

az disk grant-access

관리 디스크에 대한 리소스 액세스 권한을 부여합니다.

az disk list

관리 디스크를 나열합니다.

az disk revoke-access

관리 디스크에 대한 리소스의 읽기 권한을 취소합니다.

az disk show

디스크에 대한 정보를 가져옵니다.

az disk update

관리 디스크를 업데이트합니다.

az disk wait

관리 디스크 조건이 충족될 때까지 CLI를 대기 상태로 유지합니다.

az disk create

관리 디스크를 만듭니다.

az disk create --name
               --resource-group
               [--disk-access]
               [--disk-encryption-set]
               [--disk-iops-read-only]
               [--disk-iops-read-write]
               [--disk-mbps-read-only]
               [--disk-mbps-read-write]
               [--edge-zone]
               [--enable-bursting {false, true}]
               [--encryption-type]
               [--for-upload {false, true}]
               [--gallery-image-reference]
               [--gallery-image-reference-lun]
               [--hyper-v-generation {V1, V2}]
               [--image-reference]
               [--image-reference-lun]
               [--location]
               [--logical-sector-size]
               [--max-shares]
               [--network-access-policy {AllowAll, AllowPrivate, DenyAll}]
               [--no-wait]
               [--os-type {Linux, Windows}]
               [--security-type {TrustedLaunch}]
               [--size-gb]
               [--sku {Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS}]
               [--source]
               [--source-storage-account-id]
               [--subscription]
               [--support-hibernation {false, true}]
               [--tags]
               [--tier]
               [--upload-size-bytes]
               [--zone {1, 2, 3}]

예제

Blob URI에서 가져와서 관리 디스크를 만듭니다.

az disk create -g MyResourceGroup -n MyDisk --source https://vhd1234.blob.core.windows.net/vhds/osdisk1234.vhd

빈 관리 디스크를 만듭니다.

az disk create -g MyResourceGroup -n MyDisk --size-gb 10

버스팅을 사용하도록 설정된 빈 관리 디스크를 만듭니다.

az disk create -g MyResourceGroup -n MyDisk --size-gb 1024 --location centraluseuap --enable-bursting

기존 디스크 또는 스냅샷을 복사하여 관리 디스크를 만듭니다.

az disk create -g MyResourceGroup -n MyDisk2 --source MyDisk

"미국 동부 2" 지역의 가용성 영역에 디스크 만들기

az disk create -g MyResourceGroup -n MyDisk --size-gb 10 --location eastus2 --zone 1

이미지에서 디스크를 만듭니다.

az disk create -g MyResourceGroup -n MyDisk --image-reference Canonical:UbuntuServer:18.04-LTS:18.04.202002180

갤러리 이미지에서 디스크를 만듭니다.

az disk create -g MyResourceGroup -n MyDisk --gallery-image-reference $id

총 IOPS 수 및 총 처리량(MBps) 제한으로 디스크를 만듭니다.

az disk create -g MyResourceGroup -n MyDisk --size-gb 10 --sku UltraSSD_LRS --disk-iops-read-only 200 --disk-mbps-read-only 30

디스크를 만들고 디스크에 동시에 연결할 수 있는 최대 VM 수를 지정합니다.

az disk create -g MyResourceGroup -n MyDisk --size-gb 256 --max-shares 2 -l centraluseuap

디스크를 만들고 디스크 액세스 리소스와 연결합니다.

az disk create -g MyResourceGroup -n MyDisk --size-gb 10 --network-access-policy AllowPrivate --disk-access MyDiskAccessID

필수 매개 변수

--name -n

관리 디스크의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--disk-access

디스크에서 프라이빗 엔드포인트를 사용하기 위한 디스크 액세스 리소스의 이름 또는 ID입니다.

--disk-encryption-set

디스크를 암호화하는 데 사용되는 디스크 암호화 집합의 이름 또는 ID입니다.

--disk-iops-read-only

공유 디스크를 ReadOnly로 탑재하는 모든 VM에서 허용되는 총 IOPS 수입니다. 하나의 작업은 4k에서 256k 바이트 사이를 전송할 수 있습니다.

--disk-iops-read-write

이 디스크에 허용되는 IOPS 수입니다. UltraSSD 디스크에 대해서만 설정할 수 있습니다. 하나의 작업은 4k에서 256k 바이트 사이를 전송할 수 있습니다.

--disk-mbps-read-only

공유 디스크를 ReadOnly로 탑재하는 모든 VM에서 허용되는 총 처리량(MBps)입니다. MBps는 초당 수백만 바이트를 의미합니다. 여기서 MB는 10의 강력한 ISO 표기판을 사용합니다.

--disk-mbps-read-write

이 디스크에 허용되는 대역폭입니다. UltraSSD 디스크에 대해서만 설정할 수 있습니다. MBps는 초당 수백만 바이트를 의미하며 ISO 표기 연산은 10입니다.

--edge-zone

에지 영역의 이름입니다.

--enable-bursting

디스크의 프로비전된 성능 목표를 초과하여 버스트를 사용하도록 설정합니다. 버스팅은 기본적으로 사용하지 않도록 설정되며 Ultra Disk에 적용되지 않습니다.

허용되는 값: false, true
--encryption-type

암호화 유형입니다. EncryptionAtRestWithPlatformKey: 디스크는 미사속 XStore 관리형 키로 암호화됩니다. 기본 암호화 유형입니다. EncryptionAtRestWithCustomerKey: 디스크는 고객 관리형 미사속 키로 암호화됩니다.

--for-upload

나중에 스토리지 명령을 통해 Blob을 업로드하기 위한 디스크를 만듭니다. "az disk grant-access --access-level Write"를 실행하여 디스크의 SAS 토큰을 검색합니다.

허용되는 값: false, true
--gallery-image-reference

디스크를 만들 공유 갈리 이미지 버전의 ID입니다.

--gallery-image-reference-lun

이미지의 데이터 디스크에서 디스크를 만든 경우 사용할 이미지의 데이터 디스크를 나타내는 인덱스입니다. OS 디스크의 경우 이 필드는 null입니다.

--hyper-v-generation

Virtual Machine의 하이퍼바이저 생성입니다. OS 디스크에만 적용됩니다.

허용되는 값: V1, V2
기본값: V1
--image-reference

디스크를 만들 이미지의 ID 또는 URN(publisher:offer:sku:version)입니다.

--image-reference-lun

이미지의 데이터 디스크에서 디스크를 만든 경우 사용할 이미지의 데이터 디스크를 나타내는 인덱스입니다. OS 디스크의 경우 이 필드는 null입니다.

--location -l

위치입니다. 값 출처: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다. 위치가 지정되지 않고 기본 위치가 지정되지 않은 경우 위치는 리소스 그룹과 동일하게 자동으로 설정됩니다.

--logical-sector-size

Ultra Disks의 논리적 섹터 크기(바이트)입니다. 지원되는 값은 512 ad 4096입니다. 기본값은 4096입니다.

--max-shares

디스크에 동시에 연결할 수 있는 최대 VM 수입니다. 값이 1보다 크면 여러 VM에 동시에 탑재할 수 있는 디스크를 나타냅니다.

--network-access-policy

네트워크를 통해 디스크에 액세스하기 위한 정책입니다.

허용되는 값: AllowAll, AllowPrivate, DenyAll
--no-wait

장기 실행 작업이 완료될 때까지 기다리지 마세요.

--os-type

디스크의 운영 체제 유형입니다.

허용되는 값: Linux, Windows
--security-type

VM의 보안 유형입니다. OS 디스크에만 적용됩니다.

허용되는 값: TrustedLaunch
--size-gb -z

크기(GB)입니다. 최대 크기: 4095GB(특정 미리 보기 디스크는 더 클 수 있습니다.)

--sku

기본 스토리지 SKU.

허용되는 값: Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS
기본값: Premium_LRS
--source

관리되지 않는 Blob URI, 관리 디스크 ID 또는 이름, 스냅샷 ID 또는 이름을 포함하여 디스크/스냅샷을 만들 원본입니다.

--source-storage-account-id

원본 Blob이 다른 구독에 있을 때 사용됩니다.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 기본 구독을 구성할 수 az account set -s NAME_OR_ID 있습니다.

--support-hibernation

디스크의 OS가 최대 절전 모드를 지원함을 나타냅니다.

허용되는 값: false, true
--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

--tier

여기에 설명된 대로 디스크의 성능 계층(예: P4, S10) https://azure.microsoft.com/en-us/pricing/details/managed-disks/ Ultra Disk에는 적용되지 않습니다.

--upload-size-bytes

VHD 바닥글이 포함된 업로드 내용의 크기(바이트)입니다. 최소 값: 20972032. 최대값: 35183298347520.

--zone

리소스를 프로비전할 가용성 영역입니다.

허용되는 값: 1, 2, 3

az disk delete

관리 디스크를 삭제합니다.

az disk delete [--ids]
               [--name]
               [--no-wait]
               [--resource-group]
               [--subscription]
               [--yes]

예제

관리 디스크를 삭제합니다. (자동 생성)

az disk delete --name MyManagedDisk --resource-group MyResourceGroup

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분). '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--name -n

관리 디스크의 이름입니다.

--no-wait

장기 실행 작업이 완료될 때까지 기다리지 마세요.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 기본 구독을 구성할 수 az account set -s NAME_OR_ID 있습니다.

--yes -y

확인을 묻는 메시지를 표시하지 마세요.

az disk grant-access

관리 디스크에 대한 리소스 액세스 권한을 부여합니다.

az disk grant-access --duration-in-seconds
                     [--access-level {Read, Write}]
                     [--ids]
                     [--name]
                     [--resource-group]
                     [--subscription]

예제

관리 디스크에 대한 리소스 읽기 액세스 권한을 부여합니다. (자동 생성)

az disk grant-access --access-level Read --duration-in-seconds 3600 --name MyManagedDisk --resource-group MyResourceGroup

필수 매개 변수

--duration-in-seconds

SAS 액세스가 만료될 때까지의 시간(초)입니다.

선택적 매개 변수

--access-level

액세스 수준.

허용되는 값: Read, Write
기본값: Read
--ids

하나 이상의 리소스 ID(공백으로 구분). '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--name -n

관리 디스크의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 기본 구독을 구성할 수 az account set -s NAME_OR_ID 있습니다.

az disk list

관리 디스크를 나열합니다.

az disk list [--query-examples]
             [--resource-group]
             [--subscription]

선택적 매개 변수

--query-examples

JMESPath 문자열을 권장합니다. 쿼리 중 하나를 복사하여 큰따옴표 안에 --query 매개 변수를 붙여넣어 결과를 확인할 수 있습니다. 이러한 키워드를 기반으로 제안을 제공할 수 있도록 하나 이상의 위치 키워드를 추가할 수 있습니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 기본 구독을 구성할 수 az account set -s NAME_OR_ID 있습니다.

az disk revoke-access

관리 디스크에 대한 리소스의 읽기 권한을 취소합니다.

az disk revoke-access [--ids]
                      [--name]
                      [--resource-group]
                      [--subscription]

예제

관리 디스크에 대한 리소스의 읽기 권한을 취소합니다. (자동 생성)

az disk revoke-access --ids $id

관리 디스크에 대한 리소스의 읽기 권한을 취소합니다. (자동 생성)

az disk revoke-access --name MyManagedDisk --resource-group MyResourceGroup

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분). '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--name -n

관리 디스크의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 기본 구독을 구성할 수 az account set -s NAME_OR_ID 있습니다.

az disk show

디스크에 대한 정보를 가져옵니다.

az disk show [--ids]
             [--name]
             [--query-examples]
             [--resource-group]
             [--subscription]

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분). '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--name -n

관리 디스크의 이름입니다.

--query-examples

JMESPath 문자열을 권장합니다. 쿼리 중 하나를 복사하여 큰따옴표 안에 --query 매개 변수를 붙여넣어 결과를 확인할 수 있습니다. 이러한 키워드를 기반으로 제안을 제공할 수 있도록 하나 이상의 위치 키워드를 추가할 수 있습니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 기본 구독을 구성할 수 az account set -s NAME_OR_ID 있습니다.

az disk update

관리 디스크를 업데이트합니다.

az disk update [--add]
               [--disk-access]
               [--disk-encryption-set]
               [--disk-iops-read-only]
               [--disk-iops-read-write]
               [--disk-mbps-read-only]
               [--disk-mbps-read-write]
               [--enable-bursting {false, true}]
               [--encryption-type]
               [--force-string]
               [--ids]
               [--max-shares]
               [--name]
               [--network-access-policy {AllowAll, AllowPrivate, DenyAll}]
               [--no-wait]
               [--remove]
               [--resource-group]
               [--set]
               [--size-gb]
               [--sku {Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS}]
               [--subscription]

예제

관리 디스크를 업데이트하고 디스크 액세스 리소스와 연결합니다.

az disk update --name MyManagedDisk --resource-group MyResourceGroup --network-access-policy AllowPrivate --disk-access MyDiskAccessID

관리 디스크를 업데이트합니다. (자동 생성)

az disk update --name MyManagedDisk --resource-group MyResourceGroup --size-gb 20

선택적 매개 변수

--add

경로 및 키 값 쌍을 지정하여 개체를 개체 목록에 추가합니다. 예: --add property.listProperty <key=value, string 또는 JSON string>.

--disk-access

디스크에서 프라이빗 엔드포인트를 사용하기 위한 디스크 액세스 리소스의 이름 또는 ID입니다.

--disk-encryption-set

디스크를 암호화하는 데 사용되는 디스크 암호화 집합의 이름 또는 ID입니다.

--disk-iops-read-only

공유 디스크를 ReadOnly로 탑재하는 모든 VM에서 허용되는 총 IOPS 수입니다. 하나의 작업은 4k에서 256k 바이트 사이를 전송할 수 있습니다.

--disk-iops-read-write

이 디스크에 허용되는 IOPS 수입니다. UltraSSD 디스크에 대해서만 설정할 수 있습니다. 하나의 작업은 4k에서 256k 바이트 사이를 전송할 수 있습니다.

--disk-mbps-read-only

공유 디스크를 ReadOnly로 탑재하는 모든 VM에서 허용되는 총 처리량(MBps)입니다. MBps는 초당 수백만 바이트를 의미합니다. 여기서 MB는 10의 강력한 ISO 표기판을 사용합니다.

--disk-mbps-read-write

이 디스크에 허용되는 대역폭입니다. UltraSSD 디스크에 대해서만 설정할 수 있습니다. MBps는 초당 수백만 바이트를 의미하며 ISO 표기 연산은 10입니다.

--enable-bursting

디스크의 프로비전된 성능 목표를 초과하여 버스트를 사용하도록 설정합니다. 버스팅은 기본적으로 사용하지 않도록 설정되며 Ultra Disk에 적용되지 않습니다.

허용되는 값: false, true
--encryption-type

암호화 유형입니다. EncryptionAtRestWithPlatformKey: 디스크는 미사속 XStore 관리형 키로 암호화됩니다. 기본 암호화 유형입니다. EncryptionAtRestWithCustomerKey: 디스크는 고객 관리형 미사속 키로 암호화됩니다.

--force-string

'set' 또는 'add'를 사용하는 경우 JSON으로 변환하는 대신 문자열 리터럴을 유지합니다.

--ids

하나 이상의 리소스 ID(공백으로 구분). '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--max-shares

디스크에 동시에 연결할 수 있는 최대 VM 수입니다. 값이 1보다 크면 여러 VM에 동시에 탑재할 수 있는 디스크를 나타냅니다.

--name -n

관리 디스크의 이름입니다.

--network-access-policy

네트워크를 통해 디스크에 액세스하기 위한 정책입니다.

허용되는 값: AllowAll, AllowPrivate, DenyAll
--no-wait

장기 실행 작업이 완료될 때까지 기다리지 마세요.

--remove

목록에서 속성 또는 요소를 제거합니다. 예: --remove property.list OR --remove propertyToRemove.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--set

설정할 속성 경로와 값을 지정하여 개체를 업데이트합니다. 예: --set property1.property2=.

--size-gb -z

크기(GB)입니다. 최대 크기: 4095GB(특정 미리 보기 디스크는 더 클 수 있습니다).

--sku

기본 스토리지 SKU.

허용되는 값: Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS
--subscription

구독의 이름 또는 ID입니다. 를 사용하여 기본 구독을 구성할 수 az account set -s NAME_OR_ID 있습니다.

az disk wait

관리 디스크 조건이 충족될 때까지 CLI를 대기 상태로 유지합니다.

az disk wait [--created]
             [--custom]
             [--deleted]
             [--exists]
             [--ids]
             [--interval]
             [--name]
             [--resource-group]
             [--subscription]
             [--timeout]
             [--updated]

예제

관리 디스크 조건이 충족될 때까지 CLI를 대기 상태로 유지합니다. (자동 생성)

az disk wait --created --name MyManagedDisk --resource-group MyResourceGroup

관리 디스크 조건이 충족될 때까지 CLI를 대기 상태로 유지합니다. (자동 생성)

az disk wait --deleted --name MyManagedDisk --resource-group MyResourceGroup --subscription mysubscription

선택적 매개 변수

--created

'Succeeded'에서 'provisioningState'를 통해 생성될 때까지 기다립니다.

--custom

조건이 사용자 지정 JMESPath 쿼리를 충족할 때까지 기다립니다. 예를 들어 provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

삭제될 때까지 기다립니다.

--exists

리소스가 존재할 때까지 기다립니다.

--ids

하나 이상의 리소스 ID(공백으로 구분). '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--interval

폴링 간격 (초)입니다.

기본값: 30
--name -n

관리 디스크의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--subscription

구독의 이름 또는 ID입니다. 을 사용 하 여 기본 구독을 구성할 수 있습니다 az account set -s NAME_OR_ID .

--timeout

최대 대기 시간 (초)입니다.

기본값: 3600
--updated

' 성공 '으로 provisioningState으로 업데이트할 때까지 기다립니다.