Private Endpoint Connection - Create Or Update
Erstellt eine neue Private Endpoint-Verbindung oder aktualisiert eine vorhandene Verbindung.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/privateEndpointConnections/{privateEndpointConnectionName}?api-version=2022-08-01
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
private
|
path | True |
string |
Name der Verbindung mit dem privaten Endpunkt. |
resource
|
path | True |
string |
Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet. |
service
|
path | True |
string |
Der Name des API Management-Diensts. Regex pattern: |
subscription
|
path | True |
string |
Hierbei handelt es sich um die ID des Zielabonnements. |
api-version
|
query | True |
string |
Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version. |
Anforderungstext
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Verbindungsressourcen-ID des privaten Endpunkts. |
properties |
Der Verbindungsstatus der Verbindung mit dem privaten Endpunkt. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Die Verbindungsanforderung für den privaten Endpunkt wurde abgeschlossen. |
|
202 Accepted |
Anforderung zum Genehmigen oder Ablehnen einer Verbindung mit einem privaten Endpunkt. Der Speicherortheader enthält die URL, in der die status des vorgangs mit langer Ausführung überprüft werden kann. |
|
Other Status Codes |
Fehlerantwort mit Beschreibung des Grunds für den Fehler. |
Sicherheit
azure_auth
Azure Active Directory OAuth2 Flow.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Beschreibung |
---|---|
user_impersonation | Identitätswechsel Ihres Benutzerkontos |
Beispiele
ApiManagementApproveOrRejectPrivateEndpointConnection
Sample Request
PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/privateEndpointConnections/privateEndpointConnectionName?api-version=2022-08-01
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/privateEndpointConnections/connectionName",
"properties": {
"privateLinkServiceConnectionState": {
"status": "Approved",
"description": "The Private Endpoint Connection is approved."
}
}
}
Sample Response
location: https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/tempgroup?api-version=2022-08-01&asyncId=5c730e343244df1b9cb56e85&asyncCode=201
{
"name": "privateEndpointConnectionName",
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/privateEndpointConnections/privateEndpointConnectionName",
"type": "Microsoft.ApiManagement/service/privateEndpointConnections",
"properties": {
"provisioningState": "Succeeded",
"privateEndpoint": {
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/privateEndpoints/privateEndpointName"
},
"privateLinkServiceConnectionState": {
"status": "Succeeded",
"description": "The request has been approved."
}
}
}
Definitionen
Name | Beschreibung |
---|---|
Error |
Fehlerfeldvertrag. |
Error |
Fehlerantwort. |
Private |
Die Ressource "Privater Endpunkt". |
Private |
Die Ressource "Private Endpoint Connection". |
Private |
Der aktuelle Bereitstellungsstatus. |
Private |
Eine Anforderung zum Genehmigen oder Ablehnen einer Verbindung mit einem privaten Endpunkt |
Private |
Die private Endpunktverbindung status. |
Private |
Eine Sammlung von Informationen über den Status der Verbindung zwischen dem Dienst consumer und dem Anbieter. |
Properties |
Der Verbindungsstatus der Verbindung mit dem privaten Endpunkt. |
ErrorFieldContract
Fehlerfeldvertrag.
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Fehlercode auf Eigenschaftsebene. |
message |
string |
Für Menschen lesbare Darstellung eines Fehlers auf Eigenschaftsebene. |
target |
string |
Der Eigenschaftsname. |
ErrorResponse
Fehlerantwort.
Name | Typ | Beschreibung |
---|---|---|
error.code |
string |
Der vom Dienst definierte Fehlercode. Dieser Code dient als Unterstatus für den in der Antwort angegebenen HTTP-Fehlercode. |
error.details |
Die Liste der ungültigen Felder, die im Falle eines Überprüfungsfehlers gesendet werden. |
|
error.message |
string |
Lesbare Darstellung des Fehlers. |
PrivateEndpoint
Die Ressource "Privater Endpunkt".
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Der ARM-Bezeichner für private Endpunkte |
PrivateEndpointConnection
Die Ressource "Private Endpoint Connection".
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Der Name der Ressource |
properties.privateEndpoint |
Die Ressource des privaten Endpunkts. |
|
properties.privateLinkServiceConnectionState |
Eine Sammlung von Informationen über den Status der Verbindung zwischen dem Dienst consumer und dem Anbieter. |
|
properties.provisioningState |
Der Bereitstellungsstatus der Verbindungsressource des privaten Endpunkts. |
|
type |
string |
Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts" |
PrivateEndpointConnectionProvisioningState
Der aktuelle Bereitstellungsstatus.
Name | Typ | Beschreibung |
---|---|---|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
PrivateEndpointConnectionRequest
Eine Anforderung zum Genehmigen oder Ablehnen einer Verbindung mit einem privaten Endpunkt
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Verbindungsressourcen-ID des privaten Endpunkts. |
properties |
Der Verbindungsstatus der Verbindung mit dem privaten Endpunkt. |
PrivateEndpointServiceConnectionStatus
Die private Endpunktverbindung status.
Name | Typ | Beschreibung |
---|---|---|
Approved |
string |
|
Pending |
string |
|
Rejected |
string |
PrivateLinkServiceConnectionState
Eine Sammlung von Informationen über den Status der Verbindung zwischen dem Dienst consumer und dem Anbieter.
Name | Typ | Beschreibung |
---|---|---|
actionsRequired |
string |
Eine Meldung, die angibt, ob Änderungen am Dienstanbieter Updates für den Consumer erfordern. |
description |
string |
Der Grund für die Genehmigung/Ablehnung der Verbindung. |
status |
Gibt an, ob die Verbindung vom Besitzer des Diensts genehmigt/abgelehnt/entfernt wurde. |
Properties
Der Verbindungsstatus der Verbindung mit dem privaten Endpunkt.
Name | Typ | Beschreibung |
---|---|---|
privateLinkServiceConnectionState |
Eine Sammlung von Informationen über den Status der Verbindung zwischen dem Dienst consumer und dem Anbieter. |