Workspaces - Update

Referensi

Service:: Log Analytics

API Version:: 2023-09-01

Updates ruang kerja.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
resourceGroupName	path	True	string	Nama grup sumber daya. Nama tidak peka huruf besar/kecil.
subscriptionId	path	True	string	ID langganan target.
workspaceName	path	True	string	Nama ruang kerja. Regex pattern: `^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$`
api-version	query	True	string	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.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.retentionInDays	integer	Retensi data ruang kerja dalam beberapa hari. Nilai yang diizinkan adalah per paket 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. Pilihan.

Respons

Nama	Jenis	Deskripsi
200 OK	Workspace	Ruang kerja yang ada berhasil diperbarui. Periksa provisioningStatus untuk melihat status terperinci.
Other Status Codes	ErrorResponse	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

WorkspacesPatch

Sample Request

HTTP

PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-00000000000/resourcegroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685?api-version=2023-09-01

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

Sample Response

Status code:: 200

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

Definisi

Nama	Deskripsi
CapacityReservationLevel	Tingkat reservasi kapasitas dalam GB untuk ruang kerja ini, ketika sku CapacityReservation dipilih.
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	Respons kesalahan
Identity	Identitas untuk sumber daya.
IdentityType	Jenis identitas layanan terkelola.
PrivateLinkScopedResource	Referensi sumber daya cakupan tautan privat.
PublicNetworkAccessType	Jenis akses jaringan untuk beroperasi di Ruang Kerja Analitik Log. Secara default diaktifkan
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.
UserIdentityProperties	Properti identitas yang ditetapkan pengguna.
Workspace	Kontainer sumber daya Ruang Kerja tingkat atas.
WorkspaceCapping	Batas volume harian untuk penyerapan.
WorkspaceEntityStatus	Status penyediaan ruang kerja.
WorkspaceFeatures	Fitur ruang kerja.
WorkspacePatch	Kontainer sumber daya Ruang Kerja tingkat atas.
WorkspaceSku	SKU (tingkat) ruang kerja.
WorkspaceSkuNameEnum	Nama SKUnya.

CapacityReservationLevel

Tingkat reservasi kapasitas dalam GB untuk ruang kerja ini, ketika sku CapacityReservation dipilih.

Nama	Jenis	Deskripsi
100	Integer
1000	Integer
10000	Integer
200	Integer
2000	Integer
25000	Integer
300	Integer
400	Integer
500	Integer
5000	Integer
50000	Integer

createdByType

Jenis identitas yang membuat sumber daya.

Nama	Jenis	Deskripsi
Application	string
Key	string
ManagedIdentity	string
User	string

DataIngestionStatus

Status penyerapan data untuk ruang kerja ini.

Nama	Jenis	Deskripsi
ApproachingQuota	string	80% dari kuota batas harian tercapai.
ForceOff	string	Penyerapan berhenti setelah perubahan pengaturan layanan.
ForceOn	string	Penyerapan mulai mengikuti perubahan pengaturan layanan.
OverQuota	string	Mencapai kuota batas harian, penyerapan berhenti.
RespectQuota	string	Penyerapan diaktifkan setelah reset kuota batas harian, atau pengaktifan langganan.
SubscriptionSuspended	string	Penyerapan berhenti mengikuti langganan yang ditangguhkan.

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

Respons 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.

Nama	Jenis	Deskripsi
None	string
SystemAssigned	string
UserAssigned	string

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 beroperasi di Ruang Kerja Analitik Log. Secara default diaktifkan

Nama	Jenis	Deskripsi
Disabled	string	Menonaktifkan konektivitas publik ke Analitik Log melalui DNS publik.
Enabled	string	Memungkinkan konektivitas ke Analitik Log melalui DNS publik.

systemData

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama	Jenis	Deskripsi
createdAt	string	Tanda waktu pembuatan sumber daya (UTC).
createdBy	string	Identitas yang membuat sumber daya.
createdByType	createdByType	Jenis identitas yang membuat sumber daya.
lastModifiedAt	string	Tanda waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Identitas yang terakhir memodifikasi sumber daya.
lastModifiedByType	createdByType	Jenis identitas yang terakhir mengubah 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 Ruang Kerja tingkat atas.

Nama	Jenis	Nilai Default	Deskripsi
etag	string		Etag ruang kerja.
id	string		ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Ex - /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		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.features	WorkspaceFeatures		Fitur ruang kerja.
properties.forceCmkForQuery	boolean		Menunjukkan apakah penyimpanan yang dikelola pelanggan wajib untuk manajemen kueri.
properties.modifiedDate	string		Tanggal modifikasi ruang kerja.
properties.privateLinkScopedResources	PrivateLinkScopedResource[]		Daftar sumber daya cakupan tautan privat yang ditautkan.
properties.provisioningState	WorkspaceEntityStatus		Status penyediaan 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.retentionInDays	integer		Retensi data ruang kerja dalam beberapa hari. Nilai yang diizinkan adalah per paket harga. Lihat dokumentasi tingkat harga untuk detailnya.
properties.sku	WorkspaceSku		SKU ruang kerja.
properties.workspaceCapping	WorkspaceCapping		Batas volume harian untuk penyerapan.
systemData	systemData		Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.
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	Kuota harian ruang kerja untuk penyerapan.
dataIngestionStatus	DataIngestionStatus	Status penyerapan data untuk ruang kerja ini.
quotaNextResetTime	string	Waktu ketika kuota akan istirahat.

WorkspaceEntityStatus

Status penyediaan ruang kerja.

Nama	Jenis	Deskripsi
Canceled	string
Creating	string
Deleting	string
Failed	string
ProvisioningAccount	string
Succeeded	string
Updating	string

WorkspaceFeatures

Fitur ruang kerja.

Nama	Jenis	Deskripsi
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 terbatas hanya pada model penagihan terpadu sentinel.

WorkspacePatch