Backend - Reconnect

Benachrichtigt den APIM-Proxy, um nach dem angegebenen Timeout eine neue Verbindung mit dem Back-End zu erstellen. Wenn kein Timeout angegeben wurde, wird ein Timeout von 2 Minuten verwendet.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/backends/{backendId}/reconnect?api-version=2021-08-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
backendId
path True

string

Bezeichner der Back-End-Entität. Muss im aktuellen API Management-Dienst instance eindeutig sein.

resourceGroupName
path True

string

Der Name der Ressourcengruppe.

serviceName
path True

string

Der Name des API Management-Diensts.

RegEx-Muster: ^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$

subscriptionId
path True

string

Abonnementanmeldeinformationen, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.

api-version
query True

string

Version der API, die mit der Clientanforderung verwendet werden soll.

Anforderungstext

Name Typ Beschreibung
properties.after

string

Dauer in ISO8601 Format, nach dem die erneute Verbindung initiiert wird. Die Mindestdauer der erneuten Verbindung ist PT2M.

Antworten

Name Typ Beschreibung
202 Accepted

Die Anforderung für eine erneute Verbindung wurde akzeptiert.

Other Status Codes

ErrorResponse

Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Flow.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

ApiManagementBackendReconnect

Beispielanforderung

POST https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/backends/proxybackend/reconnect?api-version=2021-08-01

{
  "properties": {
    "after": "PT3S"
  }
}

Beispiel für eine Antwort

Definitionen

Name Beschreibung
BackendReconnectContract

Erneutes Verbinden von Anforderungsparametern.

ErrorFieldContract

Fehler Feldvertrag.

ErrorResponse

Fehlerantwort.

BackendReconnectContract

Erneutes Verbinden von Anforderungsparametern.

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.after

string

Dauer in ISO8601 Format, nach dem die erneute Verbindung initiiert wird. Die Mindestdauer der erneuten Verbindung ist PT2M.

type

string

Der Typ der Ressource. Z.B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

ErrorFieldContract

Fehler Feldvertrag.

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

ErrorFieldContract[]

Die Liste der ungültigen Felder, die in der Anforderung gesendet werden, im Falle eines Validierungsfehlers.

error.message

string

Lesbare Darstellung des Fehlers.