Pricings - Get

  • Referensi
Service:
Defender for Cloud
API Version:
2024-01-01

Dapatkan konfigurasi harga paket Defender dari cakupan yang dipilih (cakupan yang valid adalah id sumber daya atau id langganan). Pada tingkat sumber daya, jenis sumber daya yang didukung adalah 'VirtualMachines, VMSS, dan ARC Machines'.

GET https://management.azure.com/{scopeId}/providers/Microsoft.Security/pricings/{pricingName}?api-version=2024-01-01

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
pricingName
 path True

string

nama konfigurasi harga
scopeId
 path True

string

Id cakupan harga. Cakupan yang valid adalah: langganan (format: 'subscriptions/{subscriptionId}'), atau sumber daya tertentu (format: 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}) - Sumber daya yang didukung adalah (VirtualMachines)
api-version
 query True

string

Versi API untuk operasi

Respons

Nama Jenis Deskripsi
200 OK

Pricing

OK
Other Status Codes

CloudError

Respons kesalahan yang menjelaskan mengapa operasi gagal.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory

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

Scopes

Nama Deskripsi
user_impersonation meniru akun pengguna Anda

Contoh

Get pricings on resource - VirtualMachines plan
Get pricings on subscription - CloudPosture plan
Get pricings on subscription - Containers plan
Get pricings on subscription - Dns plan
Get pricings on subscription - StorageAccounts plan
Get pricings on subscription - VirtualMachines plan

Get pricings on resource - VirtualMachines plan

Sample Request

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/DEMO/providers/Microsoft.Compute/virtualMachines/VM-1/providers/Microsoft.Security/pricings/VirtualMachines?api-version=2024-01-01

Sample Response

Status code:
200 
{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/DEMO/providers/Microsoft.Compute/virtualMachines/VM-1/providers/Microsoft.Security/pricings/VirtualMachines",
  "name": "VirtualMachines",
  "type": "Microsoft.Security/pricings",
  "properties": {
    "pricingTier": "Standard",
    "subPlan": "P2",
    "freeTrialRemainingTime": "PT0S",
    "enablementTime": "2023-03-01T12:42:42.1921106Z",
    "inherited": "True",
    "inheritedFrom": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23",
    "extensions": [
      {
        "name": "AgentlessVmScanning",
        "isEnabled": "True",
        "additionalExtensionProperties": {
          "ExclusionTags": "[{\"Key\":\"TestKey1\",\"Value\":\"TestValue1\"},{\"Key\":\"TestKey2\",\"Value\":\"TestValue2\"}]"
        }
      },
      {
        "name": "MdeDesignatedSubscription",
        "isEnabled": "True"
      }
    ]
  }
}

Get pricings on subscription - CloudPosture plan

Sample Request

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/CloudPosture?api-version=2024-01-01

Sample Response

Status code:
200 
{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/CloudPosture",
  "name": "CloudPosture",
  "type": "Microsoft.Security/pricings",
  "properties": {
    "pricingTier": "Standard",
    "freeTrialRemainingTime": "PT0S",
    "enablementTime": "2023-03-01T12:42:42.1921106Z",
    "enforce": "False",
    "resourcesCoverageStatus": "FullyCovered",
    "extensions": [
      {
        "name": "AgentlessVmScanning",
        "isEnabled": "True",
        "additionalExtensionProperties": {
          "ExclusionTags": "[]"
        }
      },
      {
        "name": "AgentlessDiscoveryForKubernetes",
        "isEnabled": "True"
      },
      {
        "name": "SensitiveDataDiscovery",
        "isEnabled": "True"
      },
      {
        "name": "ContainerRegistriesVulnerabilityAssessments",
        "isEnabled": "True"
      },
      {
        "name": "EntraPermissionsManagement",
        "isEnabled": "True"
      }
    ]
  }
}

Get pricings on subscription - Containers plan

Sample Request

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/Containers?api-version=2024-01-01

Sample Response

Status code:
200 
{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/Containers",
  "name": "Containers",
  "type": "Microsoft.Security/pricings",
  "properties": {
    "pricingTier": "Standard",
    "freeTrialRemainingTime": "PT0S",
    "enablementTime": "2023-03-01T12:42:42.1921106Z",
    "enforce": "False",
    "resourcesCoverageStatus": "FullyCovered",
    "extensions": [
      {
        "name": "ContainerRegistriesVulnerabilityAssessments",
        "isEnabled": "True"
      }
    ]
  }
}

Get pricings on subscription - Dns plan

Sample Request

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/Dns?api-version=2024-01-01

Sample Response

Status code:
200 
{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/Dns",
  "name": "Dns",
  "type": "Microsoft.Security/pricings",
  "properties": {
    "pricingTier": "Standard",
    "freeTrialRemainingTime": "PT0S",
    "enablementTime": "2023-03-01T12:42:42.1921106Z",
    "deprecated": true,
    "replacedBy": [
      "VirtualMachines"
    ],
    "enforce": "False",
    "resourcesCoverageStatus": "FullyCovered"
  }
}

Get pricings on subscription - StorageAccounts plan

Sample Request

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/StorageAccounts?api-version=2024-01-01

Sample Response

Status code:
200 
{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/StorageAccounts",
  "name": "StorageAccounts",
  "type": "Microsoft.Security/pricings",
  "properties": {
    "pricingTier": "Standard",
    "subPlan": "PerStorageAccount",
    "freeTrialRemainingTime": "PT0S",
    "enablementTime": "2023-03-01T12:42:42.1921106Z",
    "enforce": "False",
    "resourcesCoverageStatus": "FullyCovered",
    "extensions": [
      {
        "name": "OnUploadMalwareScanning",
        "isEnabled": "True",
        "additionalExtensionProperties": {
          "capGBPerMonthPerStorageAccount": 10
        }
      },
      {
        "name": "SensitiveDataDiscovery",
        "isEnabled": "True"
      }
    ]
  }
}

Get pricings on subscription - VirtualMachines plan

Sample Request

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/VirtualMachines?api-version=2024-01-01

Sample Response

Status code:
200 
{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/pricings/VirtualMachines",
  "name": "VirtualMachines",
  "type": "Microsoft.Security/pricings",
  "properties": {
    "pricingTier": "Standard",
    "subPlan": "P2",
    "freeTrialRemainingTime": "PT0S",
    "enablementTime": "2023-03-01T12:42:42.1921106Z",
    "enforce": "False",
    "resourcesCoverageStatus": "PartiallyCovered",
    "extensions": [
      {
        "name": "AgentlessVmScanning",
        "isEnabled": "True",
        "additionalExtensionProperties": {
          "ExclusionTags": "[{\"Key\":\"TestKey1\",\"Value\":\"TestValue1\"},{\"Key\":\"TestKey2\",\"Value\":\"TestValue2\"}]"
        }
      },
      {
        "name": "MdeDesignatedSubscription",
        "isEnabled": "True"
      }
    ]
  }
}

Definisi

Nama Deskripsi
CloudError

Respons kesalahan umum untuk semua API Azure Resource Manager untuk mengembalikan detail kesalahan untuk operasi yang gagal. (Ini juga mengikuti format respons kesalahan OData.).
CloudErrorBody

Detail kesalahan.
code

Kode status operasi.
enforce

Jika diatur ke "False", itu memungkinkan turunan dari cakupan ini untuk mengambil alih konfigurasi harga yang ditetapkan pada cakupan ini (memungkinkan pengaturan diwariskan="False"). Jika diatur ke "True", ini mencegah penimpaan dan memaksa konfigurasi harga ini pada semua turunan cakupan ini. Bidang ini hanya tersedia untuk harga tingkat langganan.
ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.
Extension

Properti ekstensi paket
inherited

"diwariskan" = "True" menunjukkan bahwa cakupan saat ini mewarisi konfigurasi harganya dari induknya. ID cakupan induk yang menyediakan konfigurasi yang diwariskan ditampilkan di bidang "inheritedFrom". Di sisi lain, "diwariskan" = "False" menunjukkan bahwa cakupan saat ini memiliki konfigurasi harganya sendiri yang ditetapkan secara eksplisit, dan tidak mewarisi dari induknya. Bidang ini hanya dapat dibaca dan hanya tersedia untuk harga tingkat sumber daya.
isEnabled

Menunjukkan apakah ekstensi diaktifkan.
OperationStatus

Status yang menjelaskan keberhasilan/kegagalan operasi pengaktifan/penonaktifan ekstensi.
Pricing

Microsoft Defender untuk Cloud disediakan dalam dua tingkat harga: gratis dan standar. Tingkat standar menawarkan kemampuan keamanan tingkat lanjut, sementara tingkat gratis menawarkan fitur keamanan dasar.
pricingTier

Menunjukkan apakah paket Defender diaktifkan pada cakupan yang dipilih. Microsoft Defender untuk Cloud disediakan dalam dua tingkat harga: gratis dan standar. Tingkat standar menawarkan kemampuan keamanan tingkat lanjut, sementara tingkat gratis menawarkan fitur keamanan dasar.
resourcesCoverageStatus

Bidang ini hanya tersedia untuk tingkat langganan, dan mencerminkan status cakupan sumber daya di bawah langganan. Harap dicatat: Bidang "pricingTier" mencerminkan status paket langganan. Namun, karena status paket juga dapat ditentukan di tingkat sumber daya, mungkin ada ketidakselarasan antara status paket langganan dan status sumber daya. Bidang ini membantu menunjukkan status cakupan sumber daya.

CloudError

Respons kesalahan umum untuk semua API Azure Resource Manager untuk mengembalikan detail kesalahan untuk operasi yang gagal. (Ini juga mengikuti format respons kesalahan OData.).

Nama Jenis Deskripsi
error.additionalInfo

ErrorAdditionalInfo[]

Info tambahan kesalahan.
error.code

string

Kode kesalahan.
error.details

CloudErrorBody[]

Detail kesalahan.
error.message

string

Pesan kesalahan.
error.target

string

Target kesalahan.

CloudErrorBody

Detail kesalahan.

Nama Jenis Deskripsi
additionalInfo

ErrorAdditionalInfo[]

Info tambahan kesalahan.
code

string

Kode kesalahan.
details

CloudErrorBody[]

Detail kesalahan.
message

string

Pesan kesalahan.
target

string

Target kesalahan.

code

Kode status operasi.

Nama Jenis Deskripsi
Failed

string

Ekstensi tidak berhasil dibuat/diperbarui. Lihat pesan status operasi untuk detail selengkapnya.
Succeeded

string

Ekstensi berhasil dibuat/diperbarui.

enforce

Jika diatur ke "False", itu memungkinkan turunan dari cakupan ini untuk mengambil alih konfigurasi harga yang ditetapkan pada cakupan ini (memungkinkan pengaturan diwariskan="False"). Jika diatur ke "True", ini mencegah penimpaan dan memaksa konfigurasi harga ini pada semua turunan cakupan ini. Bidang ini hanya tersedia untuk harga tingkat langganan.

Nama Jenis Deskripsi
False

string

Memungkinkan turunan dari cakupan ini untuk mengambil alih konfigurasi harga yang ditetapkan pada cakupan ini (memungkinkan pengaturan diwariskan="False")
True

string

Mencegah penimpaan dan memaksa konfigurasi harga cakupan saat ini ke semua turunan

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

Nama Jenis Deskripsi
info

object

Info tambahan.
type

string

Jenis info tambahan.

Extension

Properti ekstensi paket

Nama Jenis Deskripsi
additionalExtensionProperties

Nilai properti yang terkait dengan ekstensi.
isEnabled

isEnabled

Menunjukkan apakah ekstensi diaktifkan.
name

string

Nama ekstensi. Nilai yang didukung adalah:

AgentlessDiscoveryForKubernetes - Penemuan informasi berbasis API tentang arsitektur kluster Kube, objek beban kerja, dan penyiapan. Diperlukan untuk inventori Kubernetes, deteksi paparan identitas dan jaringan, analisis jalur serangan, dan perburuan risiko sebagai bagian dari penjelajah keamanan cloud. Tersedia untuk paket CloudPosture.

OnUploadMalwareScanning - Membatasi GB yang akan dipindai per bulan untuk setiap akun penyimpanan dalam langganan. Setelah batas ini tercapai pada akun penyimpanan tertentu, Blob tidak akan dipindai selama bulan kalender saat ini. Tersedia untuk paket StorageAccounts.

SensitiveDataDiscovery - Penemuan data sensitif mengidentifikasi kontainer penyimpanan Blob dengan data sensitif seperti kredensial, kartu kredit, dan banyak lagi, untuk membantu memprioritaskan dan menyelidiki peristiwa keamanan. Tersedia untuk paket StorageAccounts dan CloudPosture.

ContainerRegistriesVulnerabilityAssessments - Menyediakan manajemen kerentanan untuk gambar yang disimpan di registri kontainer Anda. Tersedia untuk paket CloudPosture dan Kontainer.
operationStatus

OperationStatus

Opsional. Status yang menjelaskan keberhasilan/kegagalan operasi pengaktifan/penonaktifan ekstensi.

inherited

"diwariskan" = "True" menunjukkan bahwa cakupan saat ini mewarisi konfigurasi harganya dari induknya. ID cakupan induk yang menyediakan konfigurasi yang diwariskan ditampilkan di bidang "inheritedFrom". Di sisi lain, "diwariskan" = "False" menunjukkan bahwa cakupan saat ini memiliki konfigurasi harganya sendiri yang ditetapkan secara eksplisit, dan tidak mewarisi dari induknya. Bidang ini hanya dapat dibaca dan hanya tersedia untuk harga tingkat sumber daya.

Nama Jenis Deskripsi
False

string

Menunjukkan bahwa cakupan saat ini menetapkan konfigurasi harganya sendiri dan tidak mewarisinya dari induknya
True

string

Menunjukkan bahwa cakupan saat ini mewarisi konfigurasi harganya dari induknya

isEnabled

Menunjukkan apakah ekstensi diaktifkan.

Nama Jenis Deskripsi
False

string

Menunjukkan ekstensi dinonaktifkan
True

string

Menunjukkan ekstensi diaktifkan

OperationStatus

Status yang menjelaskan keberhasilan/kegagalan operasi pengaktifan/penonaktifan ekstensi.

Nama Jenis Deskripsi
code

code

Kode status operasi.
message

string

Informasi tambahan mengenai keberhasilan/kegagalan operasi.

Pricing

Microsoft Defender untuk Cloud disediakan dalam dua tingkat harga: gratis dan standar. Tingkat standar menawarkan kemampuan keamanan tingkat lanjut, sementara tingkat gratis menawarkan fitur keamanan dasar.

Nama Jenis Deskripsi
id

string

ID sumber daya
name

string

Nama sumber daya
properties.deprecated

boolean

Pilihan. True jika paket tidak digunakan lagi. Jika ada mengganti paket, paket akan muncul di replacedBy properti
properties.enablementTime

string

Pilihan. Jika pricingTier properti ini Standard menyimpan tanggal terakhir kali pricingTier diatur ke Standard, jika tersedia (misalnya 2023-03-01T12:42:42.1921106Z).
properties.enforce

enforce

Jika diatur ke "False", itu memungkinkan turunan dari cakupan ini untuk mengambil alih konfigurasi harga yang ditetapkan pada cakupan ini (memungkinkan pengaturan diwariskan="False"). Jika diatur ke "True", ini mencegah penimpaan dan memaksa konfigurasi harga ini pada semua turunan cakupan ini. Bidang ini hanya tersedia untuk harga tingkat langganan.
properties.extensions

Extension[]

Pilihan. Daftar ekstensi yang ditawarkan berdasarkan paket.
properties.freeTrialRemainingTime

string

Durasi tersisa untuk periode uji coba gratis langganan - dalam format ISO 8601 (misalnya P3Y6M4DT12H30M5S).
properties.inherited

inherited

"diwariskan" = "True" menunjukkan bahwa cakupan saat ini mewarisi konfigurasi harganya dari induknya. ID cakupan induk yang menyediakan konfigurasi yang diwariskan ditampilkan di bidang "inheritedFrom". Di sisi lain, "diwariskan" = "False" menunjukkan bahwa cakupan saat ini memiliki konfigurasi harganya sendiri yang ditetapkan secara eksplisit, dan tidak mewarisi dari induknya. Bidang ini hanya dapat dibaca dan hanya tersedia untuk harga tingkat sumber daya.
properties.inheritedFrom

string

Id cakupan yang diwariskan. "Null" jika tidak diwariskan. Bidang ini hanya tersedia untuk harga tingkat sumber daya.
properties.pricingTier

pricingTier

Menunjukkan apakah paket Defender diaktifkan pada cakupan yang dipilih. Microsoft Defender untuk Cloud disediakan dalam dua tingkat harga: gratis dan standar. Tingkat standar menawarkan kemampuan keamanan tingkat lanjut, sementara tingkat gratis menawarkan fitur keamanan dasar.
properties.replacedBy

string[]

Pilihan. Daftar paket yang menggantikan paket ini. Properti ini hanya ada jika paket ini tidak digunakan lagi.
properties.resourcesCoverageStatus

resourcesCoverageStatus

Bidang ini hanya tersedia untuk tingkat langganan, dan mencerminkan status cakupan sumber daya di bawah langganan. Harap dicatat: Bidang "pricingTier" mencerminkan status paket langganan. Namun, karena status paket juga dapat ditentukan di tingkat sumber daya, mungkin ada ketidakselarasan antara status paket langganan dan status sumber daya. Bidang ini membantu menunjukkan status cakupan sumber daya.
properties.subPlan

string

Sub-paket yang dipilih untuk konfigurasi harga Standar, ketika lebih dari satu sub-paket tersedia. Setiap sub-paket memungkinkan serangkaian fitur keamanan. Ketika tidak ditentukan, paket lengkap diterapkan. Untuk paket VirtualMachines, sub paket yang tersedia adalah 'P1' & 'P2', di mana untuk tingkat sumber daya hanya sub paket 'P1' yang didukung.
type

string

Jenis Sumber Daya

pricingTier

Menunjukkan apakah paket Defender diaktifkan pada cakupan yang dipilih. Microsoft Defender untuk Cloud disediakan dalam dua tingkat harga: gratis dan standar. Tingkat standar menawarkan kemampuan keamanan tingkat lanjut, sementara tingkat gratis menawarkan fitur keamanan dasar.

Nama Jenis Deskripsi
Free

string

Dapatkan Microsoft Defender gratis untuk pengalaman Cloud dengan fitur keamanan dasar
Standard

string

Dapatkan Microsoft Defender standar untuk pengalaman Cloud dengan fitur keamanan tingkat lanjut

resourcesCoverageStatus

Bidang ini hanya tersedia untuk tingkat langganan, dan mencerminkan status cakupan sumber daya di bawah langganan. Harap dicatat: Bidang "pricingTier" mencerminkan status paket langganan. Namun, karena status paket juga dapat ditentukan di tingkat sumber daya, mungkin ada ketidakselarasan antara status paket langganan dan status sumber daya. Bidang ini membantu menunjukkan status cakupan sumber daya.

Nama Jenis Deskripsi
FullyCovered

string

Nilai ini menunjukkan bahwa semua sumber daya yang terkait dengan langganan mengaktifkan paket Defender.
NotCovered

string

Nilai ini menunjukkan bahwa paket Defender dinonaktifkan untuk semua sumber daya di bawah langganan. Tidak ada sumber daya yang dilindungi oleh paket Defender.
PartiallyCovered

string

Nilai ini menunjukkan bahwa beberapa sumber daya di bawah langganan mengaktifkan paket Defender, sementara yang lain menonaktifkannya. Ada status cakupan campuran di antara sumber daya.