Delen via


Private Endpoints - PrivateEndpointConnections CreateOrUpdate

Werk de status van een privé-eindpuntverbinding bij met de opgegeven naam.

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

URI-parameters

Name In Vereist Type Description
privateEndpointConnectionName
path True

string

De naam van de privé-eindpuntverbinding.

resourceGroupName
path True

string

De naam van de resourcegroep die de DigitalTwinsInstance bevat.

resourceName
path True

string

De naam van de DigitalTwinsInstance.

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

subscriptionId
path True

string

De abonnements-id.

api-version
query True

string

Versie van de DigitalTwinsInstance Management-API.

Aanvraagbody

Name Vereist Type Description
properties True

ConnectionProperties

De verbindingseigenschappen.

Antwoorden

Name Type Description
200 OK

PrivateEndpointConnection

Dit wordt geretourneerd als een antwoord wanneer de resource al bestaat en is bijgewerkt.

202 Accepted

PrivateEndpointConnection

Dit is een langdurige bewerking. De bewerking retourneert een 202 als de validatie is voltooid. Het antwoord bevat een Azure-AsyncOperation-header die een status-URL bevat. Van clients wordt verwacht dat ze de status-URL voor de status van de bewerking controleren. Als dit lukt, retourneert de bewerking de HTTP-statuscode 200 (OK).

Other Status Codes

ErrorResponse

Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

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

Scopes

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

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."
    }
  }
}

Definities

Name Description
ConnectionProperties

De eigenschappen van een privé-eindpuntverbinding.

ConnectionPropertiesProvisioningState

De inrichtingsstatus.

createdByType

Het type identiteit waarmee de resource is gemaakt.

ErrorDefinition

Foutdefinitie.

ErrorResponse

Foutreactie.

PrivateEndpoint

De privé-eindpunteigenschap van een privé-eindpuntverbinding.

PrivateEndpointConnection

De privé-eindpuntverbinding van een digitale dubbel.

PrivateLinkServiceConnectionState

De verbindingsstatus.

PrivateLinkServiceConnectionStatus

De status van een privé-eindpuntverbinding.

SystemData

Metagegevens met betrekking tot het maken en laatste wijzigen van de resource.

ConnectionProperties

De eigenschappen van een privé-eindpuntverbinding.

Name Type Description
groupIds

string[]

De lijst met groeps-id's voor de privé-eindpuntverbinding.

privateEndpoint

PrivateEndpoint

Het privé-eindpunt.

privateLinkServiceConnectionState

PrivateLinkServiceConnectionState

De verbindingsstatus.

provisioningState

ConnectionPropertiesProvisioningState

De inrichtingsstatus.

ConnectionPropertiesProvisioningState

De inrichtingsstatus.

Name Type Description
Approved

string

Disconnected

string

Pending

string

Rejected

string

createdByType

Het type identiteit waarmee de resource is gemaakt.

Name Type Description
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorDefinition

Foutdefinitie.

Name Type Description
code

string

Servicespecifieke foutcode die fungeert als de substatus voor de HTTP-foutcode.

details

ErrorDefinition[]

Interne foutdetails.

message

string

Beschrijving van de fout.

ErrorResponse

Foutreactie.

Name Type Description
error

ErrorDefinition

Foutbeschrijving

PrivateEndpoint

De privé-eindpunteigenschap van een privé-eindpuntverbinding.

Name Type Description
id

string

De resource-id.

PrivateEndpointConnection

De privé-eindpuntverbinding van een digitale dubbel.

Name Type Description
id

string

De resource-id.

name

string

De resourcenaam.

properties

ConnectionProperties

De verbindingseigenschappen.

systemData

SystemData

Metagegevens met betrekking tot het maken en de laatste wijziging van de privé-eindpuntverbinding.

type

string

Het resourcetype.

PrivateLinkServiceConnectionState

De verbindingsstatus.

Name Type Description
actionsRequired

string

Acties die zijn vereist voor een privé-eindpuntverbinding.

description

string

De beschrijving voor de huidige status van een privé-eindpuntverbinding.

status

PrivateLinkServiceConnectionStatus

De status van een privé-eindpuntverbinding.

PrivateLinkServiceConnectionStatus

De status van een privé-eindpuntverbinding.

Name Type Description
Approved

string

Disconnected

string

Pending

string

Rejected

string

SystemData

Metagegevens met betrekking tot het maken en laatste wijzigen van de resource.

Name Type Description
createdAt

string

De tijdstempel van het maken van resources (UTC).

createdBy

string

De identiteit die de resource heeft gemaakt.

createdByType

createdByType

Het type identiteit waarmee de resource is gemaakt.

lastModifiedAt

string

Het tijdstempel van de laatste wijziging van de resource (UTC)

lastModifiedBy

string

De identiteit die de resource het laatst heeft gewijzigd.

lastModifiedByType

createdByType

Het type identiteit dat de resource het laatst heeft gewijzigd.