Linker - Create Or Update
Bağlayıcı kaynağını oluşturun veya güncelleştirin.
PUT https://management.azure.com/{resourceUri}/providers/Microsoft.ServiceLinker/linkers/{linkerName}?api-version=2022-11-01-preview
URI Parametreleri
| Name | İçinde | Gerekli | Tür | Description |
|---|---|---|---|---|
|
linker
|
path | True |
string |
Bağlayıcı kaynağı adı. |
|
resource
|
path | True |
string |
Bağlanılacak kaynağın tam Azure Resource manager tanımlayıcısı. |
|
api-version
|
query | True |
string minLength: 1 |
Bu işlem için kullanılacak API sürümü. |
İstek Gövdesi
| Name | Tür | Description |
|---|---|---|
| properties.authInfo | AuthInfoBase: |
Kimlik doğrulama türü. |
| properties.clientType |
Uygulama istemci türü |
|
| properties.configurationInfo |
Gizli diziler, bağlantı dizeleri dahil olmak üzere uygulamalar tarafından kullanılan bağlantı bilgileri. |
|
| properties.publicNetworkSolution |
Ağ çözümü. |
|
| properties.scope |
string |
kaynak hizmetindeki bağlantı kapsamı. |
| properties.secretStore |
Gizli dizi değerini güvenli bir yerde depolama seçeneği |
|
| properties.targetService | TargetServiceBase: |
Hedef hizmet özellikleri |
| properties.vNetSolution |
Sanal ağ çözümü. |
Yanıtlar
| Name | Tür | Description |
|---|---|---|
| 200 OK |
Başarılı. |
|
| 201 Created |
Uzun süre çalışan işlem. |
|
| Other Status Codes |
İşlemin neden başarısız olduğunu açıklayan hata yanıtı. |
Güvenlik
azure_auth
Azure Active Directory OAuth2 Akışı.
Tür:
oauth2
Akış:
implicit
Yetkilendirme URL’si:
https://login.microsoftonline.com/common/oauth2/authorize
Kapsamlar
| Name | Description |
|---|---|
| user_impersonation | kullanıcı hesabınızın kimliğine bürünme |
Örnekler
PutLinker
Örnek isteği
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.Web/sites/test-app/providers/Microsoft.ServiceLinker/linkers/linkName?api-version=2022-11-01-preview
{
"properties": {
"targetService": {
"type": "AzureResource",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.DBforPostgreSQL/servers/test-pg/databases/test-db"
},
"vNetSolution": {
"type": "serviceEndpoint"
},
"authInfo": {
"authType": "secret",
"name": "name",
"secretInfo": {
"secretType": "rawValue",
"value": "secret"
}
}
}
}
Örnek yanıt
{
"type": "Microsoft.ServiceLinker/links",
"name": "linkName",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.Web/sites/test-app/providers/Microsoft.ServiceLinker/links/linkName",
"properties": {
"authInfo": {
"authType": "secret",
"name": "name"
},
"vNetSolution": {
"type": "serviceEndpoint"
},
"targetService": {
"type": "AzureResource",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.DBforPostgreSQL/servers/test-pg/databases/test-db"
}
}
}
{
"type": "Microsoft.ServiceLinker/links",
"name": "linkName",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.Web/sites/test-app/providers/Microsoft.ServiceLinker/links/linkName",
"properties": {
"authInfo": {
"authType": "secret",
"name": "name"
},
"vNetSolution": {
"type": "serviceEndpoint"
},
"targetService": {
"type": "AzureResource",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.DBforPostgreSQL/servers/test-pg/databases/test-db"
}
}
}
Tanımlar
| Name | Description |
|---|---|
|
Access |
Erişim anahtarı doğrudan hedef kaynak özelliklerindendir ve hedef hizmet Microsoft.Storage gibi Azure Kaynağı'dır |
|
access |
accessKey'in izinleri.
|
|
action |
Opsiyonel. Genel ağ çözümünü gösterir. Etkinleştirilirse, en iyi denemeyle hedef hizmetin genel ağ erişimini etkinleştirin. Varsayılan, etkindir. OptOut ise genel ağ erişim yapılandırmasını devre dışı bırak. |
|
allow |
Azure hizmetlerinin doğruysa hedef hizmete erişmesine izin verin. |
|
Auth |
Kimlik doğrulama türü. |
|
Azure |
Tür Azure Key Vault olduğunda kaynak özellikleri |
|
Azure |
Hedef hizmet türü AzureResource olduğunda azure kaynak bilgileri |
|
client |
Uygulama istemci türü |
|
Configuration |
Yapılandırma oluşturmak veya uygulamalara kaydetmek için kullanılan yapılandırma bilgileri |
|
Confluent |
Hedef hizmet türü ConfluentBootstrapServer olduğunda hizmet özellikleri |
|
Confluent |
Hedef hizmet türü ConfluentSchemaRegistry olduğunda hizmet özellikleri |
|
created |
Kaynağı oluşturan kimliğin türü. |
|
Dapr |
dapr bileşeni meta verileri. |
|
Dapr |
Dapr istemci türü için bazı ek özellikleri gösterir |
|
Delete |
Kaynak silindiğinde veya güncelleştirildiğinde temizleme işleminin yapılıp yapılmadığını belirten temizleme davranışı |
|
Error |
Kaynak yönetimi hatası ek bilgileri. |
|
Error |
Hata ayrıntısı. |
|
Error |
Hata yanıtı |
|
Firewall |
Hizmetin güvenlik duvarı kurallarını hedefle. kaynak hizmetten bağlantılara izin vermek için. |
|
Key |
Tür keyVaultSecretReference olduğunda gizli bilgi. Kullanıcının keyvault dizininde depolanan bir gizli dizi sağladığı ve kaynağın Azure Kubernetes olduğu senaryoya yöneliktir. Key Vault'un kaynak kimliği secretStore.keyVaultId ile bağlantılıdır. |
|
Key |
Tür keyVaultSecretUri olduğunda gizli dizi bilgileri. Bu, kullanıcının keyvault'unda depolanan bir gizli dizi sağladığı ve kaynağın Web Uygulaması, Spring Cloud veya Container App olduğu senaryoya yöneliktir. |
|
Linker |
Kaynak ve hedef kaynağın bağlayıcısı |
|
Public |
Genel ağ çözümünü gösterir, güvenlik duvarı kurallarını dahil et |
|
Secret |
authType gizli olduğunda kimlik doğrulama bilgileri |
|
Secret |
Gizli dizi değerini güvenli bir yerde depolama seçeneği |
|
Secret |
Gizli dizi türü. |
|
Self |
Hedef hizmet türü SelfHostedServer olduğunda hizmet özellikleri |
|
Service |
authType servicePrincipal sertifikası olduğunda kimlik doğrulama bilgileri |
|
Service |
authType servicePrincipal gizli anahtarı olduğunda kimlik doğrulama bilgileri |
|
System |
authType systemAssignedIdentity olduğunda kimlik doğrulama bilgileri |
|
system |
Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler. |
|
User |
authType kullanıcı hesabı olduğunda kimlik doğrulama bilgileri |
|
User |
authType userAssignedIdentity olduğunda kimlik doğrulama bilgileri |
|
Value |
Tür rawValue olduğunda gizli dizi bilgileri. Kullanıcının gizli diziyi giriş yaptığı senaryolar içindir. |
|
VNet |
Bağlayıcı için sanal ağ çözümü |
|
v |
Sanal ağ çözümünün türü. |
AccessKeyInfoBase
Erişim anahtarı doğrudan hedef kaynak özelliklerindendir ve hedef hizmet Microsoft.Storage gibi Azure Kaynağı'dır
| Name | Tür | Description |
|---|---|---|
| authType |
string:
access |
Kimlik doğrulama türü. |
| permissions |
accessKey'in izinleri.
|
accessKeyPermissions
accessKey'in izinleri.
Read ve Write Azure Cosmos DB ve Azure Uygulama Yapılandırması için, Listen, Send ve Manage, Azure Event Hub ve Azure Service Bus içindir.
| Değer | Description |
|---|---|
| Read | |
| Write | |
| Listen | |
| Send | |
| Manage |
actionType
Opsiyonel. Genel ağ çözümünü gösterir. Etkinleştirilirse, en iyi denemeyle hedef hizmetin genel ağ erişimini etkinleştirin. Varsayılan, etkindir. OptOut ise genel ağ erişim yapılandırmasını devre dışı bırak.
| Değer | Description |
|---|---|
| enable | |
| optOut |
allowType
Azure hizmetlerinin doğruysa hedef hizmete erişmesine izin verin.
| Değer | Description |
|---|---|
| true | |
| false |
AuthType
Kimlik doğrulama türü.
| Değer | Description |
|---|---|
| systemAssignedIdentity | |
| userAssignedIdentity | |
| servicePrincipalSecret | |
| servicePrincipalCertificate | |
| secret | |
| accessKey | |
| userAccount |
AzureKeyVaultProperties
Tür Azure Key Vault olduğunda kaynak özellikleri
| Name | Tür | Description |
|---|---|---|
| connectAsKubernetesCsiDriver |
boolean |
Kubernetes CSI Sürücüsü üzerinden bağlanıyorsanız true. |
| type |
string:
Key |
Azure kaynak türü. |
AzureResource
Hedef hizmet türü AzureResource olduğunda azure kaynak bilgileri
| Name | Tür | Description |
|---|---|---|
| id |
string |
Azure kaynağının kimliği. |
| resourceProperties | AzureResourcePropertiesBase: |
Azure kaynak bağlantısıyla ilgili özellikler. |
| type | string: |
Hedef hizmet türü. |
clientType
Uygulama istemci türü
| Değer | Description |
|---|---|
| none | |
| dotnet | |
| java | |
| python | |
| go | |
| php | |
| ruby | |
| django | |
| nodejs | |
| springBoot | |
| kafka-springBoot | |
| dapr |
ConfigurationInfo
Yapılandırma oluşturmak veya uygulamalara kaydetmek için kullanılan yapılandırma bilgileri
| Name | Tür | Description |
|---|---|---|
| action |
İsteğe bağlı olarak, kaynak uygulamaya yapılandırma uygulanıp uygulanmayacağını belirtin. Etkinleştirilirse, yapılandırmalar oluşturun ve kaynak uygulamaya uygulanır. Varsayılan, etkindir. OptOut ise, kaynakta yapılandırma değişikliği yapılmaz. |
|
| additionalConfigurations |
object |
Eklenecek ek yapılandırmaların sözlüğü. Hizmet bir dizi temel yapılandırmayı otomatik olarak oluşturur ve bu özellik daha özelleştirilmiş yapılandırmaları tam olarak doldurmaktır |
| customizedKeys |
object |
Opsiyonel. Varsayılan anahtar adı ve özelleştirilmiş anahtar adı eşlemesi sözlüğü. Belirtilmezse, yapılandırma oluşturmak için varsayılan anahtar adı kullanılır |
| daprProperties |
Dapr istemci türü için bazı ek özellikleri gösterir |
|
| deleteOrUpdateBehavior |
Bağlayıcı güncelleştirirken veya silerken önceki işlemin temizlenip temizlenmeyeceğini gösterir |
ConfluentBootstrapServer
Hedef hizmet türü ConfluentBootstrapServer olduğunda hizmet özellikleri
| Name | Tür | Description |
|---|---|---|
| endpoint |
string |
Hizmet uç noktası. |
| type | string: |
Hedef hizmet türü. |
ConfluentSchemaRegistry
Hedef hizmet türü ConfluentSchemaRegistry olduğunda hizmet özellikleri
| Name | Tür | Description |
|---|---|---|
| endpoint |
string |
Hizmet uç noktası. |
| type | string: |
Hedef hizmet türü. |
createdByType
Kaynağı oluşturan kimliğin türü.
| Değer | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DaprMetadata
dapr bileşeni meta verileri.
| Name | Tür | Description |
|---|---|---|
| name |
string |
Meta veri özellik adı. |
| secretRef |
string |
Dapr'ın değer alabildiği gizli dizi adı |
| value |
string |
Meta veri özellik değeri. |
DaprProperties
Dapr istemci türü için bazı ek özellikleri gösterir
| Name | Tür | Description |
|---|---|---|
| componentType |
string |
Dapr bileşen türü |
| metadata |
Ek dapr meta verileri |
|
| scopes |
string[] |
dapr bileşen kapsamları |
| secretStoreComponent |
string |
Gizli dizi alınacak gizli dizi deposunun adı |
| version |
string |
Dapr bileşeni sürümü |
DeleteOrUpdateBehavior
Kaynak silindiğinde veya güncelleştirildiğinde temizleme işleminin yapılıp yapılmadığını belirten temizleme davranışı
| Değer | Description |
|---|---|
| Default | |
| ForcedCleanup |
ErrorAdditionalInfo
Kaynak yönetimi hatası ek bilgileri.
| Name | Tür | Description |
|---|---|---|
| info |
object |
Ek bilgiler. |
| type |
string |
Ek bilgi türü. |
ErrorDetail
Hata ayrıntısı.
| Name | Tür | Description |
|---|---|---|
| additionalInfo |
Hata ek bilgileri. |
|
| code |
string |
Hata kodu. |
| details |
Hata ayrıntıları. |
|
| message |
string |
Hata iletisi. |
| target |
string |
Hata hedefi. |
ErrorResponse
Hata yanıtı
| Name | Tür | Description |
|---|---|---|
| error |
Hata nesnesi. |
FirewallRules
Hizmetin güvenlik duvarı kurallarını hedefle. kaynak hizmetten bağlantılara izin vermek için.
| Name | Tür | Description |
|---|---|---|
| azureServices |
Azure hizmetlerinin doğruysa hedef hizmete erişmesine izin verin. |
|
| callerClientIP |
Arayan istemci IP'sinin doğruysa hedef hizmete erişmesine izin verin. özelliği, yerel uygulamayı hedef hizmete bağlarken kullanılır. |
|
| ipRanges |
string[] |
Bu değer, belirli bir veritabanı hesabı için izin verilen istemci IP'leri listesi olarak dahil edilecek CIDR formundaki IP adresleri veya IP adresi aralıkları kümesini belirtir. |
KeyVaultSecretReferenceSecretInfo
Tür keyVaultSecretReference olduğunda gizli bilgi. Kullanıcının keyvault dizininde depolanan bir gizli dizi sağladığı ve kaynağın Azure Kubernetes olduğu senaryoya yöneliktir. Key Vault'un kaynak kimliği secretStore.keyVaultId ile bağlantılıdır.
| Name | Tür | Description |
|---|---|---|
| name |
string |
Key Vault gizli dizisinin adı. |
| secretType |
string:
key |
Gizli dizi türü. |
| version |
string |
Key Vault gizli dizisinin sürümü. |
KeyVaultSecretUriSecretInfo
Tür keyVaultSecretUri olduğunda gizli dizi bilgileri. Bu, kullanıcının keyvault'unda depolanan bir gizli dizi sağladığı ve kaynağın Web Uygulaması, Spring Cloud veya Container App olduğu senaryoya yöneliktir.
| Name | Tür | Description |
|---|---|---|
| secretType |
string:
key |
Gizli dizi türü. |
| value |
string |
Keyvault gizli dizisine URI |
LinkerResource
Kaynak ve hedef kaynağın bağlayıcısı
| Name | Tür | Description |
|---|---|---|
| id |
string |
Kaynağın tam kaynak kimliği. Örn - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
| name |
string |
Kaynağın adı |
| properties.authInfo | AuthInfoBase: |
Kimlik doğrulama türü. |
| properties.clientType |
Uygulama istemci türü |
|
| properties.configurationInfo |
Gizli diziler, bağlantı dizeleri dahil olmak üzere uygulamalar tarafından kullanılan bağlantı bilgileri. |
|
| properties.provisioningState |
string |
Sağlama durumu. |
| properties.publicNetworkSolution |
Ağ çözümü. |
|
| properties.scope |
string |
kaynak hizmetindeki bağlantı kapsamı. |
| properties.secretStore |
Gizli dizi değerini güvenli bir yerde depolama seçeneği |
|
| properties.targetService | TargetServiceBase: |
Hedef hizmet özellikleri |
| properties.vNetSolution |
Sanal ağ çözümü. |
|
| systemData |
Sistem verileri. |
|
| type |
string |
Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts" |
PublicNetworkSolution
Genel ağ çözümünü gösterir, güvenlik duvarı kurallarını dahil et
| Name | Tür | Description |
|---|---|---|
| action |
Opsiyonel. Genel ağ çözümünü gösterir. Etkinleştirilirse, en iyi denemeyle hedef hizmetin genel ağ erişimini etkinleştirin. Varsayılan, etkindir. OptOut ise genel ağ erişim yapılandırmasını devre dışı bırak. |
|
| deleteOrUpdateBehavior |
Bağlayıcı güncelleştirirken veya silerken önceki işlemin (güvenlik duvarı kuralları gibi) temizlenip temizlenmeyeceğini gösterir |
|
| firewallRules |
Kaynak uygulamanın hedefe bağlanabileceğinden emin olmak için hedef hizmetin güvenlik duvarı kurallarını açıklayın. |
SecretAuthInfo
authType gizli olduğunda kimlik doğrulama bilgileri
| Name | Tür | Description |
|---|---|---|
| authType |
string:
secret |
Kimlik doğrulama türü. |
| name |
string |
Gizli dizi kimlik doğrulaması için kullanıcı adı veya hesap adı. |
| secretInfo | SecretInfoBase: |
Gizli dizi kimlik doğrulaması için parola veya anahtar kasası gizli dizisi. |
SecretStore
Gizli dizi değerini güvenli bir yerde depolama seçeneği
| Name | Tür | Description |
|---|---|---|
| keyVaultId |
string |
Gizli dizi depolamak için anahtar kasası kimliği |
| keyVaultSecretName |
string |
Gizli dizi depolamak için anahtar kasası gizli dizisi adı, yalnızca bir gizli dizi depolanırken geçerlidir |
SecretType
Gizli dizi türü.
| Değer | Description |
|---|---|
| rawValue | |
| keyVaultSecretUri | |
| keyVaultSecretReference |
SelfHostedServer
Hedef hizmet türü SelfHostedServer olduğunda hizmet özellikleri
| Name | Tür | Description |
|---|---|---|
| endpoint |
string |
Hizmet uç noktası. |
| type | string: |
Hedef hizmet türü. |
ServicePrincipalCertificateAuthInfo
authType servicePrincipal sertifikası olduğunda kimlik doğrulama bilgileri
| Name | Tür | Description |
|---|---|---|
| authType |
string:
service |
Kimlik doğrulama türü. |
| certificate |
string |
servicePrincipal kimlik doğrulaması için ServicePrincipal sertifikası. |
| clientId |
string |
servicePrincipal kimlik doğrulaması için uygulama istemci kimliği. |
| deleteOrUpdateBehavior |
Bağlayıcı güncelleştirirken veya silerken önceki işlemin temizlenip temizlenmeyeceğini gösterir |
|
| principalId |
string |
servicePrincipal kimlik doğrulaması için Asıl Kimlik. |
| roles |
string[] |
İsteğe bağlı olarak, bu değer atanacak Azure rollerini belirtir. Otomatik olarak |
ServicePrincipalSecretAuthInfo
authType servicePrincipal gizli anahtarı olduğunda kimlik doğrulama bilgileri
| Name | Tür | Description |
|---|---|---|
| authType |
string:
service |
Kimlik doğrulama türü. |
| clientId |
string |
servicePrincipal kimlik doğrulaması için ServicePrincipal uygulama istemci kimliği. |
| deleteOrUpdateBehavior |
Bağlayıcı güncelleştirirken veya silerken önceki işlemin temizlenip temizlenmeyeceğini gösterir |
|
| principalId |
string |
servicePrincipal kimlik doğrulaması için Asıl Kimlik. |
| roles |
string[] |
İsteğe bağlı olarak, bu değer atanacak Azure rollerini belirtir. Otomatik olarak |
| secret |
string |
ServicePrincipal kimlik doğrulaması için gizli dizi. |
| userName |
string |
AAD'deki bir kullanıcıyla eşlenen veritabanında oluşturulan kullanıcı adı. |
SystemAssignedIdentityAuthInfo
authType systemAssignedIdentity olduğunda kimlik doğrulama bilgileri
| Name | Tür | Description |
|---|---|---|
| authType |
string:
system |
Kimlik doğrulama türü. |
| deleteOrUpdateBehavior |
Bağlayıcı güncelleştirirken veya silerken önceki işlemin temizlenip temizlenmeyeceğini gösterir |
|
| roles |
string[] |
İsteğe bağlı olarak, bu değer atanacak Azure rolünü belirtir |
| userName |
string |
AAD'deki bir kullanıcıyla eşlenen veritabanında oluşturulan kullanıcı adı. |
systemData
Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
| Name | Tür | Description |
|---|---|---|
| createdAt |
string (date-time) |
Kaynak oluşturma (UTC) zaman damgası. |
| createdBy |
string |
Kaynağı oluşturan kimlik. |
| createdByType |
Kaynağı oluşturan kimliğin türü. |
|
| lastModifiedAt |
string (date-time) |
Kaynağın son değişikliğinin zaman damgası (UTC) |
| lastModifiedBy |
string |
Kaynağı en son değiştiren kimlik. |
| lastModifiedByType |
Kaynağı en son değiştiren kimlik türü. |
UserAccountAuthInfo
authType kullanıcı hesabı olduğunda kimlik doğrulama bilgileri
| Name | Tür | Description |
|---|---|---|
| authType |
string:
user |
Kimlik doğrulama türü. |
| deleteOrUpdateBehavior |
Bağlayıcı güncelleştirirken veya silerken önceki işlemin temizlenip temizlenmeyeceğini gösterir |
|
| principalId |
string |
Kullanıcı hesabının Asıl Kimliği. |
| roles |
string[] |
İsteğe bağlı olarak, bu değer atanacak Azure rollerini belirtir. Otomatik olarak |
| userName |
string |
AAD'deki bir kullanıcıyla eşlenen veritabanında oluşturulan kullanıcı adı. |
UserAssignedIdentityAuthInfo
authType userAssignedIdentity olduğunda kimlik doğrulama bilgileri
| Name | Tür | Description |
|---|---|---|
| authType |
string:
user |
Kimlik doğrulama türü. |
| clientId |
string |
userAssignedIdentity için İstemci Kimliği. |
| deleteOrUpdateBehavior |
Bağlayıcı güncelleştirirken veya silerken önceki işlemin temizlenip temizlenmeyeceğini gösterir |
|
| roles |
string[] |
İsteğe bağlı olarak, bu değer atanacak Azure rolünü belirtir |
| subscriptionId |
string |
userAssignedIdentity için abonelik kimliği. |
| userName |
string |
AAD'deki bir kullanıcıyla eşlenen veritabanında oluşturulan kullanıcı adı. |
ValueSecretInfo
Tür rawValue olduğunda gizli dizi bilgileri. Kullanıcının gizli diziyi giriş yaptığı senaryolar içindir.
| Name | Tür | Description |
|---|---|---|
| secretType |
string:
raw |
Gizli dizi türü. |
| value |
string |
Gizli dizinin gerçek değeri. |
VNetSolution
Bağlayıcı için sanal ağ çözümü
| Name | Tür | Description |
|---|---|---|
| deleteOrUpdateBehavior |
Bağlayıcı güncelleştirirken veya silerken önceki işlemin temizlenip temizlenmeyeceğini gösterir |
|
| type |
Sanal ağ çözümünün türü. |
vNetSolutionType
Sanal ağ çözümünün türü.
| Değer | Description |
|---|---|
| serviceEndpoint | |
| privateLink |