Items - Update Environment

Hizmet:
Environment
API Sürümü:
v1

Belirtilen ortamın özelliklerini güncelleştirir.

İzinler

Çağıranın ortam için okuma ve yazma izinlerine sahip olması gerekir.

Gerekli Temsilci Kapsamları

Environment.ReadWrite.All veya Item.ReadWrite.All

Desteklenen kimlikleri Microsoft Entra

Bu API, bu bölümde listelenen Microsoft identities destekler.

Kimlik Destek
Kullanıcı Evet
Hizmet sorumlusu ve yönetilen kimlikler Evet

Arayüz

PATCH https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/environments/{environmentId}

URI Parametreleri

Veri Akışı Adı İçinde Gerekli Tür Description
environmentId
 path True

string (uuid)

Ortam kimliği.
workspaceId
 path True

string (uuid)

Çalışma alanı kimliği.

İstek Gövdesi

Veri Akışı Adı Tür Description
description

string

Ortam açıklaması. Uzunluk üst sınırı 256 karakterdir.
displayName

string

Ortam görünen adı.

Yanıtlar

Veri Akışı Adı Tür Description
200 OK

Environment

İstek başarıyla tamamlandı.
429 Too Many Requests

ErrorResponse

Hizmet fiyatı sınırı aşıldı. Sunucu, istemcinin ek istek göndermeden önce ne kadar beklemesi gerektiğini saniye cinsinden belirten bir Retry-After üst bilgi döndürür.

Üst Bilgiler

Retry-After: integer
Other Status Codes

ErrorResponse

Yaygın hata kodları:

  • ItemNotFound - İstenen öğe bulunamadı.

  • InvalidRequest - Geçersiz güncelleştirme isteği

Örnekler

Update a environment example

Örnek isteği

PATCH https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/environments/5b218778-e7a5-4d73-8187-f10824047715

{
  "displayName": "Environment_New_Name",
  "description": "A new description for environment."
}

Örnek yanıt

Durum kodu:
200 
{
  "displayName": "Environment_New_Name",
  "description": "A new description for environment.",
  "type": "Environment",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}

Tanımlar

Veri Akışı Adı Description
ComponentPublishInfo

Ortamdaki her bileşen için bilgi yayımlayın.
EntireTenantPrincipal

Kiracı sorumlusunu temsil eder
Environment

Ortam öğesi.
EnvironmentProperties

Ortam özellikleri.
EnvironmentPublishState

Yayımlama durumu. Zaman içinde ek durum türleri eklenebilir.
ErrorParameter

Bir hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametre.
ErrorRelatedResource

Hatayla ilgili kaynak ayrıntıları nesnesi.
ErrorResponse

Hata yanıtı.
ErrorResponseDetails

Hata yanıtı ayrıntıları.
GroupDetails

Belirli ayrıntıları gruplandırma. Sorumlu türü Groupolduğunda geçerlidir.
GroupPrincipal

Bir güvenlik grubunu temsil eder.
GroupType

Grubun türü. Zaman içinde ek grup türleri eklenebilir.
ItemTag

Bir öğeye uygulanan etiketi temsil eder.
ItemType

Öğenin türü. Zaman içinde ek öğe türleri eklenebilir.
PrincipalType

Sorumlunun türü. Zaman içinde ek sorumlu türleri eklenebilir.
PublishDetails

Yayımlama işleminin ayrıntıları.
SensitivityLabel

Bir öğeye uygulanan duyarlılık etiketini temsil eder.
ServicePrincipalDetails

Hizmet sorumlusuna özgü ayrıntılar. Sorumlu türü ServicePrincipalolduğunda geçerlidir.
ServicePrincipalPrincipal

Microsoft Entra hizmet sorumlusunu temsil eder.
ServicePrincipalProfileDetails

Hizmet sorumlusu profili ayrıntıları. Sorumlu türü ServicePrincipalProfileolduğunda geçerlidir.
ServicePrincipalProfilePrincipal

Hizmet sorumlusu profilini temsil eder.
SparkLibraries

Spark kitaplıkları.
SparkSettings

Spark ayarları.
UpdateEnvironmentRequest

Ortam isteğini güncelleştirin.
UserDetails

Kullanıcı sorumlusuna özgü ayrıntılar. Sorumlu türü Userolduğunda geçerlidir.
UserPrincipal

Microsoft Entra kullanıcı sorumlusunu temsil eder.

ComponentPublishInfo

Nesne

Ortamdaki her bileşen için bilgi yayımlayın.

Veri Akışı Adı Tür Description
sparkLibraries

SparkLibraries

Spark kitaplıkları bilgileri yayımlar.
sparkSettings

SparkSettings

Spark ayarları bilgileri yayımlar.

EntireTenantPrincipal

Nesne

Kiracı sorumlusunu temsil eder

Veri Akışı Adı Tür Description
displayName

string

Sorumlunun görünen adı.
id

string (uuid)

Sorumlunun kimliği.
type string:

EntireTenant

Sorumlunun türü. Zaman içinde ek sorumlu türleri eklenebilir.

Environment

Nesne

Ortam öğesi.

Veri Akışı Adı Tür Description
defaultIdentity Principal:

Öğenin varsayılan kimliği.
description

string

Öğe açıklaması.
displayName

string

Öğenin görünen adı.
folderId

string (uuid)

Klasör kimliği.
id

string (uuid)

Öğe kimliği.
logicalId

string (uuid)

Öğenin mantıksal tanımlayıcısı. Karşılık gelen öğe örnekleri aynı mantıksal kimliği paylaşır. Hiçbir mantıksal kimlik atanmadığında değer null olur.
properties

EnvironmentProperties

Ortam özellikleri.
sensitivityLabel

SensitivityLabel

Öğe duyarlılığı etiketi.
tags

ItemTag[]

Uygulanan etiketlerin listesi.
type

ItemType

Öğe türü.
workspaceId

string (uuid)

Çalışma alanı kimliği.

EnvironmentProperties

Nesne

Ortam özellikleri.

Veri Akışı Adı Tür Description
publishDetails

PublishDetails

Ortam yayımlama işlemi ayrıntıları.

EnvironmentPublishState

Numaralandırma

Yayımlama durumu. Zaman içinde ek durum türleri eklenebilir.

Değer Description
Success

Ortam yayımlama başarılı durumda.
Cancelled

Ortam yayımlama iptal edildi durumunda.
Failed

Ortam yayımlama başarısız durumda.
Cancelling

Ortam yayımlama iptal etme durumunda.
Running

Ortam yayımlama çalışıyor durumda.
Waiting

Ortam yayımlama bekleme durumunda.

ErrorParameter

Nesne

Bir hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametre.

Veri Akışı Adı Tür Description
message

string

Parametrenin anlamının insan tarafından okunabilen açıklaması.
name

string

Parametre tanımlayıcısı.
value

string

Parametre değeridir.

ErrorRelatedResource

Nesne

Hatayla ilgili kaynak ayrıntıları nesnesi.

Veri Akışı Adı Tür Description
resourceId

string

Hataya dahil olan kaynak kimliği.
resourceType

string

Hataya dahil olan kaynağın türü.

ErrorResponse

Nesne

Hata yanıtı.

Veri Akışı Adı Tür Description
errorCode

string

Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
isRetriable

boolean

True olduğunda istek yeniden denenebilir. Varsa gecikmeyi Retry-After belirlemek için yanıt üst bilgisini kullanın.
message

string

Hatanın okunabilir bir gösterimi.
moreDetails

ErrorResponseDetails[]

Ek hata ayrıntılarının listesi.
parameters

ErrorParameter[]

Hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametreler.
relatedResource

ErrorRelatedResource

Hatayla ilgili kaynak ayrıntıları.
requestId

string (uuid)

Hatayla ilişkili isteğin kimliği.

ErrorResponseDetails

Nesne

Hata yanıtı ayrıntıları.

Veri Akışı Adı Tür Description
errorCode

string

Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
message

string

Hatanın okunabilir bir gösterimi.
parameters

ErrorParameter[]

Hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametreler.
relatedResource

ErrorRelatedResource

Hatayla ilgili kaynak ayrıntıları.

GroupDetails

Nesne

Belirli ayrıntıları gruplandırma. Sorumlu türü Groupolduğunda geçerlidir.

Veri Akışı Adı Tür Description
groupType

GroupType

Grubun türü. Zaman içinde ek grup türleri eklenebilir.

GroupPrincipal

Nesne

Bir güvenlik grubunu temsil eder.

Veri Akışı Adı Tür Description
displayName

string

Sorumlunun görünen adı.
groupDetails

GroupDetails

Belirli ayrıntıları gruplandırma. Sorumlu türü Groupolduğunda geçerlidir.
id

string (uuid)

Sorumlunun kimliği.
type string:

Group

Sorumlunun türü. Zaman içinde ek sorumlu türleri eklenebilir.

GroupType

Numaralandırma

Grubun türü. Zaman içinde ek grup türleri eklenebilir.

Değer Description
Unknown

Asıl grup türü bilinmiyor.
SecurityGroup

Sorumlu bir güvenlik grubudur.
DistributionList

Sorumlu bir dağıtım listesidir.

ItemTag

Nesne

Bir öğeye uygulanan etiketi temsil eder.

Veri Akışı Adı Tür Description
displayName

string

Etiketin adı.
id

string (uuid)

Etiket kimliği.

ItemType

Numaralandırma

Öğenin türü. Zaman içinde ek öğe türleri eklenebilir.

Değer Description
Dashboard

PowerBI panosu.
Report

PowerBI raporu.
SemanticModel

PowerBI anlam modeli.
PaginatedReport

PowerBI sayfalandırılmış raporu.
Datamart

PowerBI datamart.
Lakehouse

Göl evi.
Eventhouse

Bir olay evi.
Environment

Bir ortam.
KQLDatabase

KQL veritabanı.
KQLQueryset

KQL sorgu kümesi.
KQLDashboard

KQL panosu.
DataPipeline

Veri işlem hattı.
Notebook

Bir not defteri.
SparkJobDefinition

Spark iş tanımı.
MLExperiment

Makine öğrenmesi denemesi.
MLModel

Makine öğrenmesi modeli.
Warehouse

Bir depo.
Eventstream

Bir olay akışı.
SQLEndpoint

Bir SQL uç noktası.
MirroredWarehouse

Aynalı bir depo.
MirroredDatabase

Yansıtılmış veritabanı.
Reflex

Bir refleks.
GraphQLApi

GraphQL öğesi için bir API.
MountedDataFactory

Bir MountedDataFactory.
SQLDatabase

A SQLDatabase.
CopyJob

Kopyalama işi.
VariableLibrary

Bir VariableLibrary.
Dataflow

Veri akışı.
ApacheAirflowJob

An ApacheAirflowJob.
WarehouseSnapshot

Ambar anlık görüntüsü.
DigitalTwinBuilder

A DigitalTwinBuilder.
DigitalTwinBuilderFlow

Dijital İkiz Oluşturucu Akışı.
MirroredAzureDatabricksCatalog

Yansıtılmış azure databricks kataloğu.
Map

Bir harita.
AnomalyDetector

Anomali Algılayıcısı.
UserDataFunction

Kullanıcı Verileri İşlevi.
GraphModel

A GraphModel.
GraphQuerySet

A Graph QuerySet.
SnowflakeDatabase

Snowflake hesabından oluşturulan Iceberg tablolarını depolamak için bir Snowflake Veritabanı.
OperationsAgent

A OperationsAgent.
CosmosDBDatabase

Cosmos DB Veritabanı.
Ontology

Bir Ontoloji.
EventSchemaSet

Bir EventSchemaSet.
DataAgent

A DataAgent.
MirroredCatalog

A MirroredCatalog.
AppBackend

An AppBackend.
OrgApp

Kuruluş uygulaması.
OrgAppAudience

Kuruluş Uygulaması Hedef Kitlesi.
DataBuildToolJob

A DataBuildToolJob.
AzureDatabricksStorage

Azure Databricks için OneLake destekli bir depolama öğesi.
Plan

Bir plan.

PrincipalType

Numaralandırma

Sorumlunun türü. Zaman içinde ek sorumlu türleri eklenebilir.

Değer Description
User

Sorumlu, Microsoft Entra kullanıcı sorumlusudur.
ServicePrincipal

Sorumlu bir Microsoft Entra hizmet sorumlusudur.
Group

Sorumlu bir güvenlik grubudur.
ServicePrincipalProfile

Sorumlu bir hizmet sorumlusu profilidir.
EntireTenant

Sorumlu, tüm kiracı kullanıcılarını temsil eder.

PublishDetails

Nesne

Yayımlama işleminin ayrıntıları.

Veri Akışı Adı Tür Description
componentPublishInfo

ComponentPublishInfo

Ortam bileşeni yayımlama bilgileri.
endTime

string (date-time)

YYYY-MM-DDTHH:mm:ss.ssZ biçimini kullanarak UTC'de yayımlama işleminin bitiş saati.
startTime

string (date-time)

YYYY-MM-DDTHH:mm:ss.ssZ biçimini kullanarak utc'de yayımlama işleminin başlangıç saati.
state

EnvironmentPublishState

Yayımlama durumu. Zaman içinde ek durum türleri eklenebilir.
targetVersion

string (uuid)

Yayımlanacak verion'ı hedefle.

SensitivityLabel

Nesne

Bir öğeye uygulanan duyarlılık etiketini temsil eder.

Veri Akışı Adı Tür Description
id

string (uuid)

Duyarlılık etiketi kimliği.

ServicePrincipalDetails

Nesne

Hizmet sorumlusuna özgü ayrıntılar. Sorumlu türü ServicePrincipalolduğunda geçerlidir.

Veri Akışı Adı Tür Description
aadAppId

string (uuid)

Hizmet sorumlusunun Microsoft Entra AppId değeri.

ServicePrincipalPrincipal

Nesne

Microsoft Entra hizmet sorumlusunu temsil eder.

Veri Akışı Adı Tür Description
displayName

string

Sorumlunun görünen adı.
id

string (uuid)

Sorumlunun kimliği.
servicePrincipalDetails

ServicePrincipalDetails

Hizmet sorumlusuna özgü ayrıntılar. Sorumlu türü ServicePrincipalolduğunda geçerlidir.
type string:

ServicePrincipal

Sorumlunun türü. Zaman içinde ek sorumlu türleri eklenebilir.

ServicePrincipalProfileDetails

Nesne

Hizmet sorumlusu profili ayrıntıları. Sorumlu türü ServicePrincipalProfileolduğunda geçerlidir.

Veri Akışı Adı Tür Description
parentPrincipal Principal:

Hizmet sorumlusu profilinin üst sorumlusu.

ServicePrincipalProfilePrincipal

Nesne

Hizmet sorumlusu profilini temsil eder.

Veri Akışı Adı Tür Description
displayName

string

Sorumlunun görünen adı.
id

string (uuid)

Sorumlunun kimliği.
servicePrincipalProfileDetails

ServicePrincipalProfileDetails

Hizmet sorumlusu profili ayrıntıları. Sorumlu türü ServicePrincipalProfileolduğunda geçerlidir.
type string:

ServicePrincipalProfile

Sorumlunun türü. Zaman içinde ek sorumlu türleri eklenebilir.

SparkLibraries

Nesne

Spark kitaplıkları.

Veri Akışı Adı Tür Description
state

EnvironmentPublishState

Yayımlama durumu. Zaman içinde ek durum türleri eklenebilir.

SparkSettings

Nesne

Spark ayarları.

Veri Akışı Adı Tür Description
state

EnvironmentPublishState

Yayımlama durumu. Zaman içinde ek durum türleri eklenebilir.

UpdateEnvironmentRequest

Nesne

Ortam isteğini güncelleştirin.

Veri Akışı Adı Tür Description
description

string

Ortam açıklaması. Uzunluk üst sınırı 256 karakterdir.
displayName

string

Ortam görünen adı.

UserDetails

Nesne

Kullanıcı sorumlusuna özgü ayrıntılar. Sorumlu türü Userolduğunda geçerlidir.

Veri Akışı Adı Tür Description
userPrincipalName

string

Kullanıcı asıl adı.

UserPrincipal

Nesne

Microsoft Entra kullanıcı sorumlusunu temsil eder.

Veri Akışı Adı Tür Description
displayName

string

Sorumlunun görünen adı.
id

string (uuid)

Sorumlunun kimliği.
type string:

User

Sorumlunun türü. Zaman içinde ek sorumlu türleri eklenebilir.
userDetails

UserDetails

Kullanıcı sorumlusuna özgü ayrıntılar. Sorumlu türü Userolduğunda geçerlidir.