WCF Relays - Get
Gibt die Beschreibung für das angegebene WCF-Relay zurück.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Relay/namespaces/{namespaceName}/wcfRelays/{relayName}?api-version=2021-11-01
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
namespace
|
path | True |
string |
Der Namespacename |
relay
|
path | True |
string |
Der Relayname. |
resource
|
path | True |
string |
Name der Ressourcengruppe innerhalb des Azure-Abonnements. |
subscription
|
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 |
Client-API-Version. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Die WCF-Relaybeschreibung wurde erfolgreich abgerufen. |
|
204 No Content |
WCF-Relay nicht gefunden |
|
Other Status Codes |
Relayfehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist. |
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
RelayGet
Sample Request
Sample Response
{
"id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/Default-ServiceBus-WestUS/providers/Microsoft.Relay/namespaces/example-RelayNamespace-9953/WcfRelays/example-Relay-Wcf-1194",
"name": "example-Relay-Wcf-1194",
"type": "Microsoft.Relay/WcfRelays",
"properties": {
"listenerCount": 0,
"createdAt": "2017-03-16T00:26:17.5014661Z",
"updatedAt": "2017-03-16T00:26:17.5014661Z",
"relayType": "NetTcp",
"requiresClientAuthorization": true,
"requiresTransportSecurity": true,
"isDynamic": false
}
}
Definitionen
Name | Beschreibung |
---|---|
created |
Der Identitätstyp, der die Ressource erstellt hat. |
Error |
Zusätzliche Informationen zum Ressourcenverwaltungsfehler. |
Error |
Die Fehlerdetails. |
Error |
Fehlerantwort |
Relaytype |
WCF-Relaytyp. |
system |
Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen. |
Wcf |
Beschreibung der WCF-Relayressource. |
createdByType
Der Identitätstyp, der die Ressource erstellt hat.
Name | Typ | Beschreibung |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
Zusätzliche Informationen zum Ressourcenverwaltungsfehler.
Name | Typ | Beschreibung |
---|---|---|
info |
object |
Zusätzliche Informationen. |
type |
string |
Typ der zusätzlichen Informationen. |
ErrorDetail
Die Fehlerdetails.
Name | Typ | Beschreibung |
---|---|---|
additionalInfo |
Die zusätzlichen Fehlerinformationen. |
|
code |
string |
Der Fehlercode. |
details |
Die Fehlerdetails. |
|
message |
string |
Die Fehlermeldung. |
target |
string |
Das Fehlerziel. |
ErrorResponse
Fehlerantwort
Name | Typ | Beschreibung |
---|---|---|
error |
Das Fehlerobjekt. |
Relaytype
WCF-Relaytyp.
Name | Typ | Beschreibung |
---|---|---|
Http |
string |
|
NetTcp |
string |
systemData
Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.
Name | Typ | Beschreibung |
---|---|---|
createdAt |
string |
Der Zeitstempel der Ressourcenerstellung (UTC). |
createdBy |
string |
Die Identität, die die Ressource erstellt hat. |
createdByType |
Der Identitätstyp, der die Ressource erstellt hat. |
|
lastModifiedAt |
string |
Der Zeitstempel der letzten Änderung der Ressource (UTC) |
lastModifiedBy |
string |
Die Identität, die die Ressource zuletzt geändert hat. |
lastModifiedByType |
Der Identitätstyp, der die Ressource zuletzt geändert hat. |
WcfRelay
Beschreibung der WCF-Relayressource.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
location |
string |
Der geografische Standort, an dem sich die Ressource befindet |
name |
string |
Der Name der Ressource |
properties.createdAt |
string |
Die Zeit, zu der das WCF-Relay erstellt wurde. |
properties.isDynamic |
boolean |
Gibt true zurück, wenn das Relay dynamisch ist. Andernfalls false. |
properties.listenerCount |
integer |
Die Anzahl der Listener für dieses Relay. Beachten Sie, dass min:1 und max:25 unterstützt werden. |
properties.relayType |
WCF-Relaytyp. |
|
properties.requiresClientAuthorization |
boolean |
Gibt true zurück, wenn für dieses Relay eine Clientautorisierung erforderlich ist. Andernfalls false. |
properties.requiresTransportSecurity |
boolean |
Gibt true zurück, wenn für dieses Relay Transportsicherheit erforderlich ist. Andernfalls false. |
properties.updatedAt |
string |
Der Zeitpunkt, zu dem der Namespace aktualisiert wurde. |
properties.userMetadata |
string |
Die usermetadata ist ein Platzhalter zum Speichern benutzerdefinierter Zeichenfolgendaten für den WCF Relay-Endpunkt. Es kann beispielsweise verwendet werden, um beschreibende Daten zu speichern, z. B. eine Liste der Teams und deren Kontaktinformationen. Außerdem können benutzerdefinierte Konfigurationseinstellungen gespeichert werden. |
systemData |
Die Systemmetadaten zu dieser Ressource. |
|
type |
string |
Der Typ der Ressource. Z.B. "Microsoft.EventHub/Namespaces" oder "Microsoft.EventHub/Namespaces/EventHubs" |