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 |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil. |
|
subscription
|
path | True |
string (uuid) |
ID langganan target. Nilainya harus sebuah UUID. |
|
workspace
|
path | True |
string minLength: 4maxLength: 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 |
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 |
properti failover ruang kerja. |
|
| properties.features |
Fitur ruang kerja. |
|
| properties.forceCmkForQuery |
boolean |
Menunjukkan apakah penyimpanan yang dikelola pelanggan wajib untuk manajemen kueri. |
| properties.publicNetworkAccessForIngestion |
Jenis akses jaringan untuk mengakses penyerapan Analitik Log. |
|
| properties.publicNetworkAccessForQuery |
Jenis akses jaringan untuk mengakses kueri Analitik Log. |
|
| properties.replication |
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 |
SKU ruang kerja. |
|
| properties.workspaceCapping |
Batas volume harian untuk penyerapan. |
|
| tags |
object |
Tag sumber daya. Optional. |
Respons
| Nama | Jenis | Deskripsi |
|---|---|---|
| 200 OK |
Operasi Azure berhasil diselesaikan. |
|
| Other Status Codes |
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 |
|---|---|
|
created |
Jenis identitas yang membuat sumber daya. |
|
Data |
Status penyerapan data untuk ruang kerja ini. |
|
Error |
Info tambahan kesalahan manajemen sumber daya. |
|
Error |
Detail kesalahan. |
|
Error |
Tanggapan kesalahan |
| Identity |
Identitas untuk sumber daya. |
|
Identity |
Jenis identitas layanan terkelola. |
|
Private |
Referensi sumber daya cakupan tautan privat. |
|
Public |
Jenis akses jaringan untuk mengakses penyerapan Analitik Log. |
|
system |
Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya. |
|
User |
Properti identitas yang ditetapkan pengguna. |
| Workspace |
Kontainer sumber daya Workspace tingkat atas. |
|
Workspace |
Batas volume harian untuk penyerapan. |
|
Workspace |
Status provisi ruang kerja. |
|
Workspace |
Status failover replikasi. |
|
Workspace |
Status failover replikasi. |
|
Workspace |
Fitur ruang kerja. |
|
Workspace |
Kontainer sumber daya Workspace tingkat atas. |
|
Workspace |
Properti replikasi ruang kerja. |
|
Workspace |
Status provisi replikasi. |
|
Workspace |
SKU (tingkat) ruang kerja. |
|
Workspace |
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 |
Info tambahan kesalahan. |
|
| code |
string |
Kode kesalahan. |
| details |
Detail kesalahan. |
|
| message |
string |
Pesan kesalahan. |
| target |
string |
Target kesalahan. |
ErrorResponse
Tanggapan kesalahan
| Nama | Jenis | Deskripsi |
|---|---|---|
| error |
Objek kesalahan. |
Identity
Identitas untuk sumber daya.
| Nama | Jenis | Deskripsi |
|---|---|---|
| principalId |
string |
ID utama identitas sumber daya. |
| tenantId |
string |
ID penyewa sumber daya. |
| type |
Jenis identitas layanan terkelola. |
|
| userAssignedIdentities |
<string,
User |
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 |
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 |
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 |
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 |
properti failover ruang kerja. |
||
| properties.features |
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 |
Daftar sumber daya cakupan tautan privat tertaut. |
||
| properties.provisioningState |
Status provisi ruang kerja. |
||
| properties.publicNetworkAccessForIngestion | Enabled |
Jenis akses jaringan untuk mengakses penyerapan Analitik Log. |
|
| properties.publicNetworkAccessForQuery | Enabled |
Jenis akses jaringan untuk mengakses kueri Analitik Log. |
|
| properties.replication |
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 |
SKU ruang kerja. |
||
| properties.workspaceCapping |
Batas volume harian untuk penyerapan. |
||
| 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 |
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 |
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 |
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 |
properti failover ruang kerja. |
||
| properties.features |
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 |
Daftar sumber daya cakupan tautan privat tertaut. |
||
| properties.provisioningState |
Status provisi ruang kerja. |
||
| properties.publicNetworkAccessForIngestion | Enabled |
Jenis akses jaringan untuk mengakses penyerapan Analitik Log. |
|
| properties.publicNetworkAccessForQuery | Enabled |
Jenis akses jaringan untuk mengakses kueri Analitik Log. |
|
| properties.replication |
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 |
SKU ruang kerja. |
||
| properties.workspaceCapping |
Batas volume harian untuk penyerapan. |
||
| 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 |
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 |
Nama SKU. |
WorkspaceSkuNameEnum
Nama SKU.
| Nilai | Deskripsi |
|---|---|
| Free |
Free |
| Standard |
Standard |
| Premium |
Premium |
| PerNode |
PerNode |
| PerGB2018 |
PerGB2018 |
| Standalone |
Mandiri |
| CapacityReservation |
Kapasitas Reservasi |
| LACluster |
LACluster |