Linker - Create Or Update

Criar ou atualizar recurso linker.

PUT https://management.azure.com/{resourceUri}/providers/Microsoft.ServiceLinker/linkers/{linkerName}?api-version=2021-11-01-preview

Parâmetros do URI

Name In Required Type Description
linkerName
path True
  • string

O nome Linker recurso.

resourceUri
path True
  • string

O identificador de recursos Azure De pleno habilitado do recurso a ser ligado.

api-version
query True
  • string

A versão API a ser utilizada para esta operação.

Corpo do Pedido

Name Type Description
properties.authInfo AuthInfoBase:

O tipo de autenticação.

properties.clientType

O tipo de cliente de aplicação

properties.secretStore

Uma opção para armazenar valor secreto em lugar seguro

properties.targetId
  • string

O id de recursos do serviço de alvo.

properties.vNetSolution

A solução VNet.

Respostas

Name Type Description
200 OK

Bem-sucedida.

201 Created

Operação de longa duração.

Other Status Codes

Resposta de erro descrevendo por que a operação falhou.

Segurança

azure_auth

Azure Ative Directory Flow OAuth2.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation personificar a sua conta de utilizador

Exemplos

PutLink
PutLinkWithServiceEndpoint

Sample Request

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=2021-11-01-preview

{
  "properties": {
    "targetId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.DocumentDb/databaseAccounts/test-acc/mongodbDatabases/test-db",
    "authInfo": {
      "authType": "secret",
      "name": "name",
      "secret": "secret"
    }
  }
}

Sample Response

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.Web/sites/test-app/providers/Microsoft.ServiceLinker/links/linkName",
  "type": "Microsoft.ServiceLinker/links",
  "name": "linkName",
  "properties": {
    "authInfo": {
      "authType": "secret",
      "name": "name"
    },
    "targetId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.DocumentDb/databaseAccounts/test-acc/mongodbDatabases/test-db"
  }
}
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.Web/sites/test-app/providers/Microsoft.ServiceLinker/links/linkName",
  "type": "Microsoft.ServiceLinker/links",
  "name": "linkName",
  "properties": {
    "authInfo": {
      "authType": "secret",
      "name": "name"
    },
    "targetId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.DocumentDb/databaseAccounts/test-acc/mongodbDatabases/test-db"
  }
}

PutLinkWithServiceEndpoint

Sample Request

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=2021-11-01-preview

{
  "properties": {
    "targetId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.DocumentDb/databaseAccounts/test-acc/mongodbDatabases/test-db",
    "authInfo": {
      "authType": "secret",
      "name": "name",
      "secret": "secret"
    },
    "vNetSolution": {
      "type": "serviceEndpoint"
    },
    "secretStore": {
      "keyVaultId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.KeyVault/vaults/test-kv"
    }
  }
}

Sample Response

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.Web/sites/test-app/providers/Microsoft.ServiceLinker/links/linkName",
  "type": "Microsoft.ServiceLinker/links",
  "name": "linkName",
  "properties": {
    "authInfo": {
      "authType": "secret",
      "name": "name"
    },
    "vNetSolution": {
      "type": "serviceEndpoint"
    },
    "secretStore": {
      "keyVaultId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.KeyVault/vaults/test-kv"
    },
    "targetId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.DocumentDb/databaseAccounts/test-acc/mongodbDatabases/test-db"
  }
}
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.Web/sites/test-app/providers/Microsoft.ServiceLinker/links/linkName",
  "type": "Microsoft.ServiceLinker/links",
  "name": "linkName",
  "properties": {
    "authInfo": {
      "authType": "secret",
      "name": "name"
    },
    "vNetSolution": {
      "type": "serviceEndpoint"
    },
    "secretStore": {
      "keyVaultId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.KeyVault/vaults/test-kv"
    },
    "targetId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.DocumentDb/databaseAccounts/test-acc/mongodbDatabases/test-db"
  }
}

Definições

AuthType

O tipo de autenticação.

clientType

O tipo de cliente de aplicação

createdByType

O tipo de identidade que criou o recurso.

ErrorAdditionalInfo

O erro de gestão de recursos informações adicionais.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

LinkerResource

Linker de fonte e recurso alvo

SecretAuthInfo

A informação de autenticação quando o authType é secreto

SecretStore

Uma opção para armazenar valor secreto em lugar seguro

ServicePrincipalCertificateAuthInfo

A informação de autenticação quando authType é certificado de serviçoPrincipal

ServicePrincipalSecretAuthInfo

A informação de autenticação quando o authType é serviçoPrincipal segredo

SystemAssignedIdentityAuthInfo

A informação de autenticação quando authType é sistemaAssignedIdentity

systemData

Metadados relativos à criação e última modificação do recurso.

UserAssignedIdentityAuthInfo

A informação de autenticação quando authType é userAssignedIdentity

VNetSolution

A solução VNet para linker

vNetSolutionType

Tipo de solução VNet.

AuthType

O tipo de autenticação.

Name Type Description
secret
  • string
servicePrincipalCertificate
  • string
servicePrincipalSecret
  • string
systemAssignedIdentity
  • string
userAssignedIdentity
  • string

clientType

O tipo de cliente de aplicação

Name Type Description
django
  • string
dotnet
  • string
go
  • string
java
  • string
nodejs
  • string
none
  • string
php
  • string
python
  • string
ruby
  • string
springBoot
  • string

createdByType

O tipo de identidade que criou o recurso.

Name Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

ErrorAdditionalInfo

O erro de gestão de recursos informações adicionais.

Name Type Description
info
  • object

A informação adicional.

type
  • string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Name Type Description
additionalInfo

A informação adicional do erro.

code
  • string

O código de erro.

details

Os detalhes do erro.

message
  • string

A mensagem de erro.

target
  • string

O alvo do erro.

ErrorResponse

Resposta de erro

Name Type Description
error

O objeto de erro.

LinkerResource

Linker de fonte e recurso alvo

Name Type Description
id
  • string

ID de recursos totalmente qualificado para o recurso. Ex - /subscrições/{subscriçãoD}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name
  • string

O nome do recurso

properties.authInfo AuthInfoBase:

O tipo de autenticação.

properties.clientType

O tipo de cliente de aplicação

properties.provisioningState
  • string

O estado de provisionamento.

properties.secretStore

Uma opção para armazenar valor secreto em lugar seguro

properties.targetId
  • string

O id de recursos do serviço de alvo.

properties.vNetSolution

A solução VNet.

systemData

Os dados do sistema.

type
  • string

O tipo de recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft." Armazenamento/armazenamentoCotalhos"

SecretAuthInfo

A informação de autenticação quando o authType é secreto

Name Type Description
authType string:
  • secret

O tipo de autenticação.

name
  • string

Nome de utilizador ou nome de conta para auth secreto.

secret
  • string

Senha ou chave de conta para auth secreto.

SecretStore

Uma opção para armazenar valor secreto em lugar seguro

Name Type Description
keyVaultId
  • string

O id do cofre chave para armazenar o segredo

ServicePrincipalCertificateAuthInfo

A informação de autenticação quando authType é certificado de serviçoPrincipal

Name Type Description
authType string:
  • servicePrincipalCertificate

O tipo de autenticação.

certificate
  • string

Certificado ServicePrincipal para serviçoPrincipal auth.

clientId
  • string

Cliente de aplicaçãoId para serviçoPrincipal auth.

principalId
  • string

Id principal para serviço Auth.

ServicePrincipalSecretAuthInfo

A informação de autenticação quando o authType é serviçoPrincipal segredo

Name Type Description
authType string:
  • servicePrincipalSecret

O tipo de autenticação.

clientId
  • string

Cliente de aplicação ServicePrincipal Para serviçoPrincipal auth.

principalId
  • string

Id principal para serviço Auth.

secret
  • string

Segredo para serviçosPrincipal auth.

SystemAssignedIdentityAuthInfo

A informação de autenticação quando authType é sistemaAssignedIdentity

Name Type Description
authType string:
  • systemAssignedIdentity

O tipo de autenticação.

systemData

Metadados relativos à criação e última modificação do recurso.

Name Type Description
createdAt
  • string

O calendário da criação de recursos (UTC).

createdBy
  • string

A identidade que criou o recurso.

createdByType

O tipo de identidade que criou o recurso.

lastModifiedAt
  • string

O tempotampesso da última modificação de recursos (UTC)

lastModifiedBy
  • string

A identidade que modificou o recurso pela última vez.

lastModifiedByType

O tipo de identidade que modificou o recurso pela última vez.

UserAssignedIdentityAuthInfo

A informação de autenticação quando authType é userAssignedIdentity

Name Type Description
authType string:
  • userAssignedIdentity

O tipo de autenticação.

clientId
  • string

Id do cliente para utilizadorAsignedIdentity.

subscriptionId
  • string

Id de subscrição para utilizadorAsignedIdentity.

VNetSolution

A solução VNet para linker

Name Type Description
type

Tipo de solução VNet.

vNetSolutionType

Tipo de solução VNet.

Name Type Description
privateLink
  • string
serviceEndpoint
  • string