Workspaces - Update

Memperbarui ruang kerja.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}?api-version=2025-07-01

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil.

subscriptionId
path True

string (uuid)

ID langganan target. Nilainya harus sebuah UUID.

workspaceName
path True

string

minLength: 4
maxLength: 63
pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$

Nama ruang kerja.

api-version
query True

string

minLength: 1

Versi API yang digunakan untuk operasi ini.

Isi Permintaan

Nama Jenis Deskripsi
identity

Identity

Identitas sumber daya.

properties.defaultDataCollectionRuleResourceId

string

ID sumber daya dari Aturan Pengumpulan Data default yang akan digunakan untuk ruang kerja ini. Format yang diharapkan adalah - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}.

properties.failover

WorkspaceFailoverProperties

properti failover ruang kerja.

properties.features

WorkspaceFeatures

Fitur ruang kerja.

properties.forceCmkForQuery

boolean

Menunjukkan apakah penyimpanan yang dikelola pelanggan wajib untuk manajemen kueri.

properties.publicNetworkAccessForIngestion

PublicNetworkAccessType

Jenis akses jaringan untuk mengakses penyerapan Analitik Log.

properties.publicNetworkAccessForQuery

PublicNetworkAccessType

Jenis akses jaringan untuk mengakses kueri Analitik Log.

properties.replication

WorkspaceReplicationProperties

properti replikasi ruang kerja.

properties.retentionInDays

integer (int32)

Retensi data ruang kerja dalam hitungan hari. Nilai yang diizinkan ditentukan oleh rencana harga. Lihat dokumentasi tingkat harga untuk detailnya.

properties.sku

WorkspaceSku

SKU ruang kerja.

properties.workspaceCapping

WorkspaceCapping

Batas volume harian untuk penyerapan.

tags

object

Tag sumber daya. Optional.

Respons

Nama Jenis Deskripsi
200 OK

Workspace

Operasi Azure berhasil diselesaikan.

Other Status Codes

ErrorResponse

Respons kesalahan tak terduga.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama Deskripsi
user_impersonation meniru akun pengguna Anda

Contoh

WorkspacesPatch

Permintaan sampel

PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685?api-version=2025-07-01

{
  "properties": {
    "retentionInDays": 30,
    "sku": {
      "name": "PerGB2018"
    },
    "workspaceCapping": {
      "dailyQuotaGb": -1
    }
  }
}

Respon sampel

{
  "location": "australiasoutheast",
  "properties": {
    "publicNetworkAccessForIngestion": "Enabled",
    "publicNetworkAccessForQuery": "Enabled",
    "retentionInDays": 30,
    "sku": {
      "name": "PerGB2018"
    },
    "workspaceCapping": {
      "dailyQuotaGb": -1,
      "dataIngestionStatus": "RespectQuota",
      "quotaNextResetTime": "Mon, 16 Nov 2020 15:00:00 GMT"
    }
  },
  "tags": {
    "tag1": "val1"
  }
}

Definisi

Nama Deskripsi
createdByType

Jenis identitas yang membuat sumber daya.

DataIngestionStatus

Status penyerapan data untuk ruang kerja ini.

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

ErrorDetail

Detail kesalahan.

ErrorResponse

Tanggapan kesalahan

Identity

Identitas untuk sumber daya.

IdentityType

Jenis identitas layanan terkelola.

PrivateLinkScopedResource

Referensi sumber daya cakupan tautan privat.

PublicNetworkAccessType

Jenis akses jaringan untuk mengakses penyerapan Analitik Log.

systemData

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

UserIdentityProperties

Properti identitas yang ditetapkan pengguna.

Workspace

Kontainer sumber daya Workspace tingkat atas.

WorkspaceCapping

Batas volume harian untuk penyerapan.

WorkspaceEntityStatus

Status provisi ruang kerja.

WorkspaceFailoverProperties

Status failover replikasi.

WorkspaceFailoverState

Status failover replikasi.

WorkspaceFeatures

Fitur ruang kerja.

WorkspacePatch

Kontainer sumber daya Workspace tingkat atas.

WorkspaceReplicationProperties

Properti replikasi ruang kerja.

WorkspaceReplicationState

Status provisi replikasi.

WorkspaceSku

SKU (tingkat) ruang kerja.

WorkspaceSkuNameEnum

Nama SKU.

createdByType

Jenis identitas yang membuat sumber daya.

Nilai Deskripsi
User
Application
ManagedIdentity
Key

DataIngestionStatus

Status penyerapan data untuk ruang kerja ini.

Nilai Deskripsi
RespectQuota

Penyerapan diaktifkan setelah pengaturan ulang kuota batas harian, atau pengaktifan langganan.

ForceOn

Penyerapan dimulai setelah perubahan setelan layanan.

ForceOff

Penyerapan berhenti setelah perubahan pengaturan layanan.

OverQuota

Mencapai kuota batas harian, konsumsi berhenti.

SubscriptionSuspended

Penyerapan berhenti setelah langganan ditangguhkan.

ApproachingQuota

80% kuota cap harian tercapai.

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

Nama Jenis Deskripsi
info

object

Info tambahan.

type

string

Jenis info tambahan.

ErrorDetail

Detail kesalahan.

Nama Jenis Deskripsi
additionalInfo

ErrorAdditionalInfo[]

Info tambahan kesalahan.

code

string

Kode kesalahan.

details

ErrorDetail[]

Detail kesalahan.

message

string

Pesan kesalahan.

target

string

Target kesalahan.

ErrorResponse

Tanggapan kesalahan

Nama Jenis Deskripsi
error

ErrorDetail

Objek kesalahan.

Identity

Identitas untuk sumber daya.

Nama Jenis Deskripsi
principalId

string

ID utama identitas sumber daya.

tenantId

string

ID penyewa sumber daya.

type

IdentityType

Jenis identitas layanan terkelola.

userAssignedIdentities

<string,  UserIdentityProperties>

Daftar identitas pengguna yang terkait dengan sumber daya. Referensi kunci kamus identitas pengguna akan menjadi id sumber daya ARM dalam formulir: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

IdentityType

Jenis identitas layanan terkelola.

Nilai Deskripsi
SystemAssigned

DitugaskanSistem

UserAssigned

UserAssigned

None

Tidak ada

PrivateLinkScopedResource

Referensi sumber daya cakupan tautan privat.

Nama Jenis Deskripsi
resourceId

string

Id sumber daya lengkap dari sumber daya cakupan tautan privat.

scopeId

string

Pengidentifikasi unik cakupan tautan privat.

PublicNetworkAccessType

Jenis akses jaringan untuk mengakses penyerapan Analitik Log.

Nilai Deskripsi
Enabled

Memungkinkan konektivitas ke Analitik Log melalui DNS publik.

Disabled

Menonaktifkan konektivitas publik ke Analitik Log melalui DNS publik.

SecuredByPerimeter

Sumber daya hanya dapat diakses dari jaringan pribadi dan akses yang disetujui oleh perimeter keamanan jaringan yang terkait dengan sumber daya ini.

systemData

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama Jenis Deskripsi
createdAt

string (date-time)

Tanda waktu pembuatan sumber daya (UTC).

createdBy

string

Identitas yang membuat sumber daya.

createdByType

createdByType

Jenis identitas yang membuat sumber daya.

lastModifiedAt

string (date-time)

Stempel waktu modifikasi terakhir sumber daya (UTC)

lastModifiedBy

string

Identitas yang terakhir mengubah sumber daya.

lastModifiedByType

createdByType

Jenis identitas yang terakhir memodifikasi sumber daya.

UserIdentityProperties

Properti identitas yang ditetapkan pengguna.

Nama Jenis Deskripsi
clientId

string

Id klien identitas yang ditetapkan pengguna.

principalId

string

Id utama identitas yang ditetapkan pengguna.

Workspace

Kontainer sumber daya Workspace tingkat atas.

Nama Jenis Nilai default Deskripsi
etag

string

Etag ruang kerja.

id

string (arm-id)

ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

identity

Identity

Identitas sumber daya.

location

string

Lokasi geografis tempat sumber daya berada

name

string

Nama sumber daya

properties.createdDate

string (date-time)

Tanggal pembuatan ruang kerja.

properties.customerId

string

Ini adalah properti baca-saja. Mewakili ID yang terkait dengan ruang kerja.

properties.defaultDataCollectionRuleResourceId

string

ID sumber daya dari Aturan Pengumpulan Data default yang akan digunakan untuk ruang kerja ini. Format yang diharapkan adalah - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}.

properties.failover

WorkspaceFailoverProperties

properti failover ruang kerja.

properties.features

WorkspaceFeatures

Fitur ruang kerja.

properties.forceCmkForQuery

boolean

Menunjukkan apakah penyimpanan yang dikelola pelanggan wajib untuk manajemen kueri.

properties.modifiedDate

string (date-time)

Tanggal modifikasi ruang kerja.

properties.privateLinkScopedResources

PrivateLinkScopedResource[]

Daftar sumber daya cakupan tautan privat tertaut.

properties.provisioningState

WorkspaceEntityStatus

Status provisi ruang kerja.

properties.publicNetworkAccessForIngestion

PublicNetworkAccessType

Enabled

Jenis akses jaringan untuk mengakses penyerapan Analitik Log.

properties.publicNetworkAccessForQuery

PublicNetworkAccessType

Enabled

Jenis akses jaringan untuk mengakses kueri Analitik Log.

properties.replication

WorkspaceReplicationProperties

properti replikasi ruang kerja.

properties.retentionInDays

integer (int32)

Retensi data ruang kerja dalam hitungan hari. Nilai yang diizinkan ditentukan oleh rencana harga. Lihat dokumentasi tingkat harga untuk detailnya.

properties.sku

WorkspaceSku

SKU ruang kerja.

properties.workspaceCapping

WorkspaceCapping

Batas volume harian untuk penyerapan.

systemData

systemData

Metadata Azure Resource Manager yang berisi informasi createBy dan modifiedBy.

tags

object

Tag sumber daya.

type

string

Jenis sumber daya. Misalnya "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

WorkspaceCapping

Batas volume harian untuk penyerapan.

Nama Jenis Deskripsi
dailyQuotaGb

number (double)

Kuota harian ruang kerja untuk penyerapan.

dataIngestionStatus

DataIngestionStatus

Status penyerapan data untuk ruang kerja ini.

quotaNextResetTime

string

Waktu kuota akan istirahat.

WorkspaceEntityStatus

Status provisi ruang kerja.

Nilai Deskripsi
Creating

Membuat

Succeeded

Berhasil

Failed

Kegagalan

Canceled

Canceled

Deleting

Menghapus

ProvisioningAccount

ProvisiAkun

Updating

Memperbarui

WorkspaceFailoverProperties

Status failover replikasi.

Nama Jenis Deskripsi
lastModifiedDate

string (date-time)

Terakhir kali status failover diperbarui.

state

WorkspaceFailoverState

Status failover replikasi.

WorkspaceFailoverState

Status failover replikasi.

Nilai Deskripsi
Inactive

Tidak Aktif

Activating

Mengaktifkan

Active

Aktif

Deactivating

Menonaktifkan

Failed

Kegagalan

WorkspaceFeatures

Fitur ruang kerja.

Nama Jenis Deskripsi
associations

string[]

Daftar asosiasi untuk ruang kerja. Menunjukkan apakah ruang kerja dikaitkan dengan salah satu pengalaman berikut: MDC, Sentinel, SentinelGraph, dll.

clusterResourceId

string

ResourceId kluster LA khusus yang ditautkan ke ruang kerja.

disableLocalAuth

boolean

Nonaktifkan Autentikasi berbasis Non-AAD.

enableDataExport

boolean

Bendera yang menunjukkan apakah data harus diekspor.

enableLogAccessUsingOnlyResourcePermissions

boolean

Bendera yang menunjukkan izin mana yang akan digunakan - sumber daya atau ruang kerja atau keduanya.

immediatePurgeDataOn30Days

boolean

Bendera yang menjelaskan apakah kita ingin menghapus data setelah 30 hari.

unifiedSentinelBillingOnly

boolean

Indikasi jika ruang kerja yang ditentukan hanya terbatas pada model penagihan terpadu sentinel.

WorkspacePatch

Kontainer sumber daya Workspace tingkat atas.

Nama Jenis Nilai default Deskripsi
etag

string

Sumber daya Etag.

id

string (arm-id)

ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

identity

Identity

Identitas sumber daya.

name

string

Nama sumber daya

properties.createdDate

string (date-time)

Tanggal pembuatan ruang kerja.

properties.customerId

string

Ini adalah properti baca-saja. Mewakili ID yang terkait dengan ruang kerja.

properties.defaultDataCollectionRuleResourceId

string

ID sumber daya dari Aturan Pengumpulan Data default yang akan digunakan untuk ruang kerja ini. Format yang diharapkan adalah - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}.

properties.failover

WorkspaceFailoverProperties

properti failover ruang kerja.

properties.features

WorkspaceFeatures

Fitur ruang kerja.

properties.forceCmkForQuery

boolean

Menunjukkan apakah penyimpanan yang dikelola pelanggan wajib untuk manajemen kueri.

properties.modifiedDate

string (date-time)

Tanggal modifikasi ruang kerja.

properties.privateLinkScopedResources

PrivateLinkScopedResource[]

Daftar sumber daya cakupan tautan privat tertaut.

properties.provisioningState

WorkspaceEntityStatus

Status provisi ruang kerja.

properties.publicNetworkAccessForIngestion

PublicNetworkAccessType

Enabled

Jenis akses jaringan untuk mengakses penyerapan Analitik Log.

properties.publicNetworkAccessForQuery

PublicNetworkAccessType

Enabled

Jenis akses jaringan untuk mengakses kueri Analitik Log.

properties.replication

WorkspaceReplicationProperties

properti replikasi ruang kerja.

properties.retentionInDays

integer (int32)

Retensi data ruang kerja dalam hitungan hari. Nilai yang diizinkan ditentukan oleh rencana harga. Lihat dokumentasi tingkat harga untuk detailnya.

properties.sku

WorkspaceSku

SKU ruang kerja.

properties.workspaceCapping

WorkspaceCapping

Batas volume harian untuk penyerapan.

systemData

systemData

Metadata Azure Resource Manager yang berisi informasi createBy dan modifiedBy.

tags

object

Tag sumber daya. Optional.

type

string

Jenis sumber daya. Misalnya "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

WorkspaceReplicationProperties

Properti replikasi ruang kerja.

Nama Jenis Deskripsi
createdDate

string (date-time)

Terakhir kali replikasi diaktifkan.

enabled

boolean

Menentukan apakah replikasi diaktifkan atau tidak. Jika true, konfigurasi dan data ruang kerja direplikasi ke lokasi yang ditentukan. Jika replikasi diaktifkan, lokasi harus disediakan.

lastModifiedDate

string (date-time)

Terakhir kali replikasi diperbarui.

location

string

Lokasi replikasi.

provisioningState

WorkspaceReplicationState

Status provisi replikasi.

WorkspaceReplicationState

Status provisi replikasi.

Nilai Deskripsi
Succeeded

Berhasil

EnableRequested

Aktifkan Diminta

Enabling

Mengaktifkan

DisableRequested

NonaktifkanDiminta

Disabling

Menonaktifkan

RollbackRequested

RollbackDiminta

RollingBack

Bergulir Kembali

Failed

Kegagalan

Canceled

Canceled

WorkspaceSku

SKU (tingkat) ruang kerja.

Nama Jenis Deskripsi
capacityReservationLevel

integer (int32)

Tingkat reservasi kapasitas di GB untuk ruang kerja ini, saat sku CapacityReservation dipilih.

lastSkuUpdate

string (date-time)

Terakhir kali sku diperbarui.

name

WorkspaceSkuNameEnum

Nama SKU.

WorkspaceSkuNameEnum

Nama SKU.

Nilai Deskripsi
Free

Free

Standard

Standard

Premium

Premium

PerNode

PerNode

PerGB2018

PerGB2018

Standalone

Mandiri

CapacityReservation

Kapasitas Reservasi

LACluster

LACluster