Partilhar via


Private Endpoints - PrivateEndpointConnections CreateOrUpdate

Atualize o estado de uma ligação de ponto final privado com o nome especificado.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances/{resourceName}/privateEndpointConnections/{privateEndpointConnectionName}?api-version=2023-01-31

Parâmetros do URI

Name Em Necessário Tipo Description
privateEndpointConnectionName
path True

string

O nome da ligação de ponto final privado.

resourceGroupName
path True

string

O nome do grupo de recursos que contém o DigitalTwinsInstance.

resourceName
path True

string

O nome da DigitalTwinsInstance.

Regex pattern: ^(?!-)[A-Za-z0-9-]{3,63}(?<!-)$

subscriptionId
path True

string

O identificador da subscrição.

api-version
query True

string

Versão da API de Gestão DigitalTwinsInstance.

Corpo do Pedido

Name Necessário Tipo Description
properties True

ConnectionProperties

As propriedades da ligação.

Respostas

Name Tipo Description
200 OK

PrivateEndpointConnection

Isto é devolvido como uma resposta quando o recurso já existe e foi atualizado com êxito.

202 Accepted

PrivateEndpointConnection

Esta é uma operação de execução prolongada. A operação devolve um 202 se a validação estiver concluída. A resposta inclui um cabeçalho de Azure-AsyncOperation que contém um URL de estado. Espera-se que os clientes consultem o URL de estado do estado da operação. Se for bem-sucedida, a operação devolve o código de estado HTTP de 200 (OK).

Other Status Codes

ErrorResponse

Resposta de erro que descreve o motivo pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

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

Scopes

Name Description
user_impersonation Representar a sua conta de utilizador

Exemplos

Update the status of a private endpoint connection with the given name

Sample Request

PUT https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourceGroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService/privateEndpointConnections/myPrivateConnection?api-version=2023-01-31

{
  "properties": {
    "privateLinkServiceConnectionState": {
      "status": "Approved",
      "description": "Approved by johndoe@company.com."
    }
  }
}

Sample Response

{
  "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService/privateEndpointConnections/myPrivateConnection",
  "name": "myPrivateConnection",
  "type": "Microsoft.DigitalTwins/digitalTwinsInstances/privateEndpointConnections",
  "properties": {
    "provisioningState": "Succeeded",
    "privateEndpoint": {
      "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourceGroups/resRg/providers/Microsoft.Network/privateEndpoints/myPrivateEndpoint"
    },
    "groupIds": [
      "digitalTwinsInstance"
    ],
    "privateLinkServiceConnectionState": {
      "status": "Approved",
      "description": "Approved by johndoe@company.com."
    }
  }
}
azure-asyncoperation: https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationStatuses/12345678-1234-1234-123456789012
location: https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/providers/Microsoft.DigitalTwins/locations/westus2/operationResults/12345678-1234-1234-123456789012
retry-after: 10
{
  "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService/privateEndpointConnections/myPrivateConnection",
  "name": "myPrivateConnection",
  "type": "Microsoft.DigitalTwins/digitalTwinsInstances/privateEndpointConnections",
  "properties": {
    "provisioningState": "Succeeded",
    "privateEndpoint": {
      "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourceGroups/resRg/providers/Microsoft.Network/privateEndpoints/myPrivateEndpoint"
    },
    "groupIds": [
      "digitalTwinsInstance"
    ],
    "privateLinkServiceConnectionState": {
      "status": "Pending",
      "description": "Awaiting approval."
    }
  }
}

Definições

Name Description
ConnectionProperties

As propriedades de uma ligação de ponto final privado.

ConnectionPropertiesProvisioningState

O estado de aprovisionamento.

createdByType

O tipo de identidade que criou o recurso.

ErrorDefinition

Definição de erro.

ErrorResponse

Resposta de erro.

PrivateEndpoint

A propriedade de ponto final privado de uma ligação de ponto final privado.

PrivateEndpointConnection

A ligação de ponto final privado de um Duplo Digital.

PrivateLinkServiceConnectionState

O estado da ligação.

PrivateLinkServiceConnectionStatus

O estado de uma ligação de ponto final privado.

SystemData

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

ConnectionProperties

As propriedades de uma ligação de ponto final privado.

Name Tipo Description
groupIds

string[]

A lista de IDs de grupo para a ligação de ponto final privado.

privateEndpoint

PrivateEndpoint

O ponto final privado.

privateLinkServiceConnectionState

PrivateLinkServiceConnectionState

O estado da ligação.

provisioningState

ConnectionPropertiesProvisioningState

O estado de aprovisionamento.

ConnectionPropertiesProvisioningState

O estado de aprovisionamento.

Name Tipo Description
Approved

string

Disconnected

string

Pending

string

Rejected

string

createdByType

O tipo de identidade que criou o recurso.

Name Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorDefinition

Definição de erro.

Name Tipo Description
code

string

Código de erro específico do serviço que serve como subestado para o código de erro HTTP.

details

ErrorDefinition[]

Detalhes internos do erro.

message

string

Descrição do erro.

ErrorResponse

Resposta de erro.

Name Tipo Description
error

ErrorDefinition

Descrição do erro

PrivateEndpoint

A propriedade de ponto final privado de uma ligação de ponto final privado.

Name Tipo Description
id

string

O identificador do recurso.

PrivateEndpointConnection

A ligação de ponto final privado de um Duplo Digital.

Name Tipo Description
id

string

O identificador do recurso.

name

string

O nome do recurso.

properties

ConnectionProperties

As propriedades da ligação.

systemData

SystemData

Metadados relativos à criação e última modificação da ligação de ponto final privado.

type

string

O tipo de recurso.

PrivateLinkServiceConnectionState

O estado da ligação.

Name Tipo Description
actionsRequired

string

Ações necessárias para uma ligação de ponto final privado.

description

string

A descrição do estado atual de uma ligação de ponto final privado.

status

PrivateLinkServiceConnectionStatus

O estado de uma ligação de ponto final privado.

PrivateLinkServiceConnectionStatus

O estado de uma ligação de ponto final privado.

Name Tipo Description
Approved

string

Disconnected

string

Pending

string

Rejected

string

SystemData

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

Name Tipo Description
createdAt

string

O carimbo de data/hora da criação de recursos (UTC).

createdBy

string

A identidade que criou o recurso.

createdByType

createdByType

O tipo de identidade que criou o recurso.

lastModifiedAt

string

O carimbo de data/hora da última modificação do recurso (UTC)

lastModifiedBy

string

A identidade que modificou o recurso pela última vez.

lastModifiedByType

createdByType

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