Hybrid Connections - Create Or Update
Tworzy lub aktualizuje połączenie hybrydowe usługi. Ta operacja jest idempotentna.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Relay/namespaces/{namespaceName}/hybridConnections/{hybridConnectionName}?api-version=2021-11-01
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
hybrid
|
path | True |
string |
Nazwa połączenia hybrydowego. |
namespace
|
path | True |
string |
Nazwa przestrzeni nazw |
resource
|
path | True |
string |
Nazwa grupy zasobów w ramach subskrypcji platformy Azure. |
subscription
|
path | True |
string |
Poświadczenia subskrypcji, które jednoznacznie identyfikują subskrypcję platformy Microsoft Azure. Identyfikator subskrypcji stanowi część identyfikatora URI dla każdego wywołania usługi. |
api-version
|
query | True |
string |
Wersja interfejsu API klienta. |
Treść żądania
Nazwa | Typ | Opis |
---|---|---|
properties.requiresClientAuthorization |
boolean |
Zwraca wartość true, jeśli autoryzacja klienta jest wymagana dla tego połączenia hybrydowego; w przeciwnym razie wartość false. |
properties.userMetadata |
string |
Usermetadata jest symbolem zastępczym do przechowywania danych parametrów zdefiniowanych przez użytkownika dla punktu końcowego połączenia hybrydowego. Na przykład może służyć do przechowywania danych opisowych, takich jak lista zespołów i informacje kontaktowe. Ponadto można przechowywać ustawienia konfiguracji zdefiniowane przez użytkownika. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
Żądanie utworzenia połączeń hybrydowych powiodło się. |
|
Other Status Codes |
Odpowiedź o błędzie przekaźnika opisująca, dlaczego operacja nie powiodła się. |
Zabezpieczenia
azure_auth
Przepływ OAuth2 usługi Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nazwa | Opis |
---|---|
user_impersonation | personifikacja konta użytkownika |
Przykłady
RelayHybridConnectionCreate
Sample Request
PUT https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/resourcegroup/providers/Microsoft.Relay/namespaces/example-RelayNamespace-01/hybridConnections/example-Relay-Hybrid-01?api-version=2021-11-01
{
"properties": {
"requiresClientAuthorization": true
}
}
Sample Response
{
"id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/resourcegroup/providers/Microsoft.Relay/namespaces/example-RelayNamespace-01/HybridConnections/example-Relay-Hybrid-01",
"name": "example-Relay-Hybrid-01",
"type": "Microsoft.Relay/Namespaces/HybridConnections",
"properties": {
"createdAt": "2017-01-23T20:34:49.4131724Z",
"updatedAt": "2017-01-23T20:34:49.4131724Z",
"requiresClientAuthorization": true
}
}
Definicje
Nazwa | Opis |
---|---|
created |
Typ tożsamości, która utworzyła zasób. |
Error |
Dodatkowe informacje o błędzie zarządzania zasobami. |
Error |
Szczegóły błędu. |
Error |
Odpowiedź na błąd |
Hybrid |
Opis zasobu połączenia hybrydowego. |
system |
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu. |
createdByType
Typ tożsamości, która utworzyła zasób.
Nazwa | Typ | Opis |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
Dodatkowe informacje o błędzie zarządzania zasobami.
Nazwa | Typ | Opis |
---|---|---|
info |
object |
Dodatkowe informacje. |
type |
string |
Dodatkowy typ informacji. |
ErrorDetail
Szczegóły błędu.
Nazwa | Typ | Opis |
---|---|---|
additionalInfo |
Dodatkowe informacje o błędzie. |
|
code |
string |
Kod błędu. |
details |
Szczegóły błędu. |
|
message |
string |
Komunikat o błędzie. |
target |
string |
Element docelowy błędu. |
ErrorResponse
Odpowiedź na błąd
Nazwa | Typ | Opis |
---|---|---|
error |
Obiekt error. |
HybridConnection
Opis zasobu połączenia hybrydowego.
Nazwa | Typ | Opis |
---|---|---|
id |
string |
W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
location |
string |
Lokalizacja geograficzna, w której znajduje się zasób |
name |
string |
Nazwa zasobu |
properties.createdAt |
string |
Czas utworzenia połączenia hybrydowego. |
properties.listenerCount |
integer |
Liczba odbiorników dla tego połączenia hybrydowego. Należy pamiętać, że obsługiwane są minuty: 1 i max:25. |
properties.requiresClientAuthorization |
boolean |
Zwraca wartość true, jeśli autoryzacja klienta jest wymagana dla tego połączenia hybrydowego; w przeciwnym razie wartość false. |
properties.updatedAt |
string |
Czas aktualizacji przestrzeni nazw. |
properties.userMetadata |
string |
Usermetadata jest symbolem zastępczym do przechowywania danych parametrów zdefiniowanych przez użytkownika dla punktu końcowego połączenia hybrydowego. Na przykład może służyć do przechowywania danych opisowych, takich jak lista zespołów i informacje kontaktowe. Ponadto można przechowywać ustawienia konfiguracji zdefiniowane przez użytkownika. |
systemData |
Metadane systemowe odnoszące się do tego zasobu. |
|
type |
string |
Typ zasobu. Np. "Microsoft.EventHub/Namespaces" lub "Microsoft.EventHub/Namespaces/EventHubs" |
systemData
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
Nazwa | Typ | Opis |
---|---|---|
createdAt |
string |
Sygnatura czasowa tworzenia zasobów (UTC). |
createdBy |
string |
Tożsamość, która utworzyła zasób. |
createdByType |
Typ tożsamości, która utworzyła zasób. |
|
lastModifiedAt |
string |
Sygnatura czasowa ostatniej modyfikacji zasobu (UTC) |
lastModifiedBy |
string |
Tożsamość, która ostatnio zmodyfikowała zasób. |
lastModifiedByType |
Typ tożsamości, która ostatnio zmodyfikowała zasób. |