Condividi tramite


Private Endpoint Connections - Create Or Update

Crea o aggiorna PrivateEndpointConnections dello spazio dei nomi del servizio.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventHub/namespaces/{namespaceName}/privateEndpointConnections/{privateEndpointConnectionName}?api-version=2024-01-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
namespaceName
path True

string

Nome dello spazio dei nomi

Criterio di espressione regolare: ^[a-zA-Z][a-zA-Z0-9-]{6,50}[a-zA-Z0-9]$

privateEndpointConnectionName
path True

string

Nome PrivateEndpointConnection

resourceGroupName
path True

string

Nome del gruppo di risorse all'interno della sottoscrizione di Azure.

subscriptionId
path True

string

Credenziali di sottoscrizione che identificano in modo univoco una sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata di servizio.

api-version
query True

string

Versione dell'API client.

Corpo della richiesta

Nome Tipo Descrizione
properties.privateEndpoint

PrivateEndpoint

Risorsa endpoint privato per questa connessione.

properties.privateLinkServiceConnectionState

ConnectionState

Dettagli sullo stato della connessione.

properties.provisioningState

EndPointProvisioningState

Stato di provisioning della connessione endpoint privato.

Risposte

Nome Tipo Descrizione
200 OK

PrivateEndpointConnection

Stato della connessione PrivateEndPoint creata correttamente.

201 Created

PrivateEndpointConnection

Richiesta di aggiornamento dello stato della connessione PrivateEndPoint accettata.

202 Accepted

PrivateEndpointConnection

Richiesta di aggiornamento dello stato della connessione PrivateEndPoint accettata.

Other Status Codes

ErrorResponse

Risposta di errore eventhub che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

NameSpacePrivateEndPointConnectionCreate

Esempio di richiesta

PUT https://management.azure.com/subscriptions/subID/resourceGroups/ArunMonocle/providers/Microsoft.EventHub/namespaces/sdk-Namespace-2924/privateEndpointConnections/privateEndpointConnectionName?api-version=2024-01-01

{
  "properties": {
    "privateEndpoint": {
      "id": "/subscriptions/dbedb4e0-40e6-4145-81f3-f1314c150774/resourceGroups/SDK-EventHub-8396/providers/Microsoft.Network/privateEndpoints/sdk-Namespace-2847"
    },
    "privateLinkServiceConnectionState": {
      "status": "Rejected",
      "description": "testing"
    },
    "provisioningState": "Succeeded"
  }
}

Risposta di esempio

{
  "id": "/subscriptions/dbedb4e0-40e6-4145-81f3-f1314c150774/resourceGroups/SDK-EventHub-4794/providers/Microsoft.EventHub/namespaces/sdk-Namespace-5828/privateEndpointConnections/928c44d5-b7c6-423b-b6fa-811e0c27b3e0",
  "name": "928c44d5-b7c6-423b-b6fa-811e0c27b3e0",
  "type": "Microsoft.EventHub/Namespaces/PrivateEndpointConnections",
  "properties": {
    "provisioningState": "Succeeded",
    "privateEndpoint": {
      "id": "/subscriptions/dbedb4e0-40e6-4145-81f3-f1314c150774/resourceGroups/SDK-EventHub-4794/providers/Microsoft.Network/privateEndpoints/sdk-Namespace-5828"
    },
    "privateLinkServiceConnectionState": {
      "status": "Approved",
      "description": "Auto-Approved"
    }
  }
}
{
  "id": "/subscriptions/dbedb4e0-40e6-4145-81f3-f1314c150774/resourceGroups/SDK-EventHub-4794/providers/Microsoft.EventHub/namespaces/sdk-Namespace-5828/privateEndpointConnections/928c44d5-b7c6-423b-b6fa-811e0c27b3e0",
  "name": "928c44d5-b7c6-423b-b6fa-811e0c27b3e0",
  "type": "Microsoft.EventHub/Namespaces/PrivateEndpointConnections",
  "properties": {
    "provisioningState": "Succeeded",
    "privateEndpoint": {
      "id": "/subscriptions/dbedb4e0-40e6-4145-81f3-f1314c150774/resourceGroups/SDK-EventHub-4794/providers/Microsoft.Network/privateEndpoints/sdk-Namespace-5828"
    },
    "privateLinkServiceConnectionState": {
      "status": "Approved",
      "description": "Auto-Approved"
    }
  }
}
{
  "id": "/subscriptions/dbedb4e0-40e6-4145-81f3-f1314c150774/resourceGroups/SDK-EventHub-4794/providers/Microsoft.EventHub/namespaces/sdk-Namespace-5828/privateEndpointConnections/928c44d5-b7c6-423b-b6fa-811e0c27b3e0",
  "name": "928c44d5-b7c6-423b-b6fa-811e0c27b3e0",
  "type": "Microsoft.EventHub/Namespaces/PrivateEndpointConnections",
  "properties": {
    "provisioningState": "Succeeded",
    "privateEndpoint": {
      "id": "/subscriptions/dbedb4e0-40e6-4145-81f3-f1314c150774/resourceGroups/SDK-EventHub-4794/providers/Microsoft.Network/privateEndpoints/sdk-Namespace-5828"
    },
    "privateLinkServiceConnectionState": {
      "status": "Approved",
      "description": "Auto-Approved"
    }
  }
}

Definizioni

Nome Descrizione
ConnectionState

Informazioni di ConnectionState.

createdByType

Tipo di identità che ha creato la risorsa.

EndPointProvisioningState

Stato di provisioning della connessione endpoint privato.

ErrorAdditionalInfo

Informazioni aggiuntive sulla gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore indica che il servizio Hub eventi non è in grado di elaborare la richiesta in ingresso. Il motivo viene fornito nel messaggio di errore.

PrivateEndpoint

Informazioni privateEndpoint.

PrivateEndpointConnection

Proprietà dell'oggetto PrivateEndpointConnection.

PrivateLinkConnectionStatus

Stato della connessione.

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

ConnectionState

Informazioni di ConnectionState.

Nome Tipo Descrizione
description

string

Descrizione dello stato della connessione.

status

PrivateLinkConnectionStatus

Stato della connessione.

createdByType

Tipo di identità che ha creato la risorsa.

Nome Tipo Descrizione
Application

string

Key

string

ManagedIdentity

string

User

string

EndPointProvisioningState

Stato di provisioning della connessione endpoint privato.

Nome Tipo Descrizione
Canceled

string

Creating

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

ErrorAdditionalInfo

Informazioni aggiuntive sulla gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorDetail[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ErrorResponse

Risposta di errore indica che il servizio Hub eventi non è in grado di elaborare la richiesta in ingresso. Il motivo viene fornito nel messaggio di errore.

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.

PrivateEndpoint

Informazioni privateEndpoint.

Nome Tipo Descrizione
id

string

Identificatore arm per endpoint privato.

PrivateEndpointConnection

Proprietà dell'oggetto PrivateEndpointConnection.

Nome Tipo Descrizione
id

string

ID di risorsa completo per la risorsa. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Posizione geografica in cui vive la risorsa

name

string

nome della risorsa.

properties.privateEndpoint

PrivateEndpoint

Risorsa endpoint privato per questa connessione.

properties.privateLinkServiceConnectionState

ConnectionState

Dettagli sullo stato della connessione.

properties.provisioningState

EndPointProvisioningState

Stato di provisioning della connessione endpoint privato.

systemData

systemData

Metadati di sistema relativi a questa risorsa.

type

string

Tipo di risorsa. Ad esempio, "Microsoft.EventHub/Namespaces" o "Microsoft.EventHub/Namespaces/EventHubs"

PrivateLinkConnectionStatus

Stato della connessione.

Nome Tipo Descrizione
Approved

string

Disconnected

string

Pending

string

Rejected

string

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome Tipo Descrizione
createdAt

string

Timestamp della creazione di risorse (UTC).

createdBy

string

Identità che ha creato la risorsa.

createdByType

createdByType

Tipo di identità che ha creato la risorsa.

lastModifiedAt

string

Tipo di identità che ha modificato l'ultima risorsa.

lastModifiedBy

string

Identità che ha modificato l'ultima risorsa.

lastModifiedByType

createdByType

Tipo di identità che ha modificato l'ultima risorsa.