Workspaces - Create Or Update

Referensi

Layanan:: Log Analytics

Versi API:: 2025-02-01

Membuat atau memperbarui ruang kerja.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nama grup sumber daya. Nama ini tidak peka huruf besar/kecil.
subscriptionId	path	True	string minLength: 1	ID langganan target.
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 akan digunakan untuk operasi ini.

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
location	True	string	Lokasi geografis tempat sumber daya berada
etag		string	Etag ruang kerja.
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 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.

Respons

Nama	Jenis	Deskripsi
200 OK	Workspace	Definisi respons OK.
201 Created	Workspace	Definisi respons yang dibuat.
202 Accepted		Diterima
Other Status Codes	ErrorResponse	Respons kesalahan yang menjelaskan mengapa operasi gagal.

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

WorkspacesCreate

Permintaan sampel

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-00000000000/resourcegroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685?api-version=2025-02-01

{
  "properties": {
    "sku": {
      "name": "PerGB2018"
    },
    "retentionInDays": 30
  },
  "location": "australiasoutheast",
  "tags": {
    "tag1": "val1"
  }
}

Respon sampel

Kode status:: 200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000005/resourcegroups/oiautorest6685/providers/microsoft.operationalinsights/workspaces/aztest2170",
  "name": "AzTest2170",
  "type": "Microsoft.OperationalInsights/workspaces",
  "location": "australiasoutheast",
  "tags": {
    "tag1": "val1"
  },
  "properties": {
    "customerId": "bc089d7b-485c-4aff-a71e-c00f362d8d2f",
    "provisioningState": "Creating",
    "sku": {
      "name": "PerGB2018"
    },
    "retentionInDays": 30,
    "publicNetworkAccessForQuery": "Enabled",
    "publicNetworkAccessForIngestion": "Enabled"
  }
}

Kode status:: 201

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000005/resourcegroups/oiautorest6685/providers/microsoft.operationalinsights/workspaces/aztest2170",
  "name": "AzTest2170",
  "type": "Microsoft.OperationalInsights/workspaces",
  "location": "australiasoutheast",
  "tags": {
    "tag1": "val1"
  },
  "properties": {
    "customerId": "bc089d7b-485c-4aff-a71e-c00f362d8d2f",
    "provisioningState": "Creating",
    "sku": {
      "name": "PerGB2018"
    },
    "retentionInDays": 30,
    "publicNetworkAccessForQuery": "Enabled",
    "publicNetworkAccessForIngestion": "Enabled"
  }
}

Kode status:: 202

Definisi

Nama	Deskripsi
CapacityReservationLevel	Tingkat reservasi kapasitas di GB untuk ruang kerja ini, saat 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 provisi ruang kerja.
WorkspaceFailoverProperties	Status failover replikasi.
WorkspaceFailoverState	Status failover replikasi.
WorkspaceFeatures	Fitur ruang kerja.
WorkspaceReplicationProperties	Properti replikasi ruang kerja.
WorkspaceReplicationState	Status provisi replikasi.
WorkspaceSku	SKU (tingkat) ruang kerja.
WorkspaceSkuNameEnum	Nama SKU.

CapacityReservationLevel

Enumeration

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

Nilai	Deskripsi
100
1000
10000
200
2000
25000
300
400
500
5000
50000

createdByType

Enumeration

Jenis identitas yang membuat sumber daya.

Nilai	Deskripsi
Application
Key
ManagedIdentity
User

DataIngestionStatus

Enumeration

Status penyerapan data untuk ruang kerja ini.

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

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Objek

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

Objek

Respons kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

Identity

Objek

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

Enumeration

Jenis identitas layanan terkelola.

Nilai	Deskripsi
None
SystemAssigned
UserAssigned

PrivateLinkScopedResource

Objek

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

Enumeration

Jenis akses jaringan untuk beroperasi di Ruang Kerja Analitik Log. Secara default diaktifkan

Nilai	Deskripsi
Disabled	Menonaktifkan konektivitas publik ke Analitik Log melalui DNS publik.
Enabled	Memungkinkan konektivitas ke Analitik Log melalui DNS publik.

systemData

Objek

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)	Tanda waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Identitas yang terakhir mengubah sumber daya.
lastModifiedByType	createdByType	Jenis identitas yang terakhir memodifikasi sumber daya.

UserIdentityProperties

Objek

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

Objek

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 (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 yang ditautkan.
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 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

Objek

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 ketika kuota akan istirahat.

WorkspaceEntityStatus

Enumeration

Status provisi ruang kerja.

Nilai	Deskripsi
Canceled
Creating
Deleting
Failed
ProvisioningAccount
Succeeded
Updating

WorkspaceFailoverProperties

Objek

Status failover replikasi.

Nama	Jenis	Deskripsi
lastModifiedDate	string (date-time)	Terakhir kali ketika status failover diperbarui.
state	WorkspaceFailoverState	Status failover replikasi.

WorkspaceFailoverState

Enumeration

Status failover replikasi.

Nilai	Deskripsi
Activating
Active
Deactivating
Failed
Inactive

WorkspaceFeatures

Objek

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

WorkspaceReplicationProperties

Objek

Properti replikasi ruang kerja.

Nama	Jenis	Deskripsi
createdDate	string (date-time)	Terakhir kali ketika 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 ketika replikasi diperbarui.
location	string	Lokasi replikasi.
provisioningState	WorkspaceReplicationState	Status provisi replikasi.

WorkspaceReplicationState

Enumeration

Status provisi replikasi.

Nilai	Deskripsi
Canceled
DisableRequested
Disabling
EnableRequested
Enabling
Failed
RollbackRequested
RollingBack
Succeeded

WorkspaceSku

Objek

SKU (tingkat) ruang kerja.

Nama	Jenis	Deskripsi
capacityReservationLevel	CapacityReservationLevel (int32)	Tingkat reservasi kapasitas di GB untuk ruang kerja ini, saat sku CapacityReservation dipilih.
lastSkuUpdate	string (date-time)	Terakhir kali ketika sku diperbarui.
name	WorkspaceSkuNameEnum	Nama SKU.

WorkspaceSkuNameEnum

Enumeration

Nama SKU.

Nilai	Deskripsi
CapacityReservation
Free
LACluster
PerGB2018
PerNode
Premium
Standalone
Standard

Bagikan melalui

Workspaces - Create Or Update

Parameter URI

Isi Permintaan

Respons

Keamanan

azure_auth

Cakupan

Contoh

WorkspacesCreate

Permintaan sampel

Respon sampel

Definisi

CapacityReservationLevel

createdByType

DataIngestionStatus

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

Identity

IdentityType

PrivateLinkScopedResource

PublicNetworkAccessType

systemData

UserIdentityProperties

Workspace

WorkspaceCapping

WorkspaceEntityStatus

WorkspaceFailoverProperties

WorkspaceFailoverState

WorkspaceFeatures

WorkspaceReplicationProperties

WorkspaceReplicationState

WorkspaceSku

WorkspaceSkuNameEnum

Sumber Daya Tambahan: