Bagikan melalui

Workspaces - Create Or Update

  • Referensi
Layanan:
Log Analytics
Versi API:
2023-09-01

Membuat atau memperbarui ruang kerja.

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

Pola regex: ^[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 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.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.

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

PUT 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
  },
  "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 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.
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 mengikuti 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 mengubah 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.

WorkspaceSku

SKU (tingkat) ruang kerja.

Nama Jenis Deskripsi
capacityReservationLevel

CapacityReservationLevel

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

string

Terakhir kali ketika sku diperbarui.
name

WorkspaceSkuNameEnum

Nama SKUnya.

WorkspaceSkuNameEnum

Nama SKUnya.

Nama Jenis Deskripsi
CapacityReservation

string

Free

string

LACluster

string

PerGB2018

string

PerNode

string

Premium

string

Standalone

string

Standard

string