Namespaces - Get

Dienst:

Relay

API-Version:

2024-01-01

Gibt die Beschreibung für den angegebenen Namespace zurück.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
namespaceName	path	True	string minLength: 6 maxLength: 50	Der Namespacename
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Name der Ressourcengruppe innerhalb des Azure-Abonnements.
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	Client-API-Version.

Antworten

Name	Typ	Beschreibung
200 OK	RelayNamespace	Die Namespacebeschreibung wurde erfolgreich zurückgegeben.
Other Status Codes	ErrorResponse	Relayfehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss

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

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

RelayNameSpaceGet

Beispielanforderung

HTTP

GET https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/RG-eg/providers/Microsoft.Relay/namespaces/example-RelayRelayNamespace-01?api-version=2024-01-01

Beispiel für eine Antwort

Statuscode:

200

{
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/RG-eg/providers/Microsoft.Relay/namespaces/example-RelayRelayNamespace-01",
  "name": "example-RelayRelayNamespace-01",
  "type": "Microsoft.Relay/Namespaces",
  "location": "West US",
  "sku": {
    "name": "Standard",
    "tier": "Standard"
  },
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "properties": {
    "provisioningState": "Succeeded",
    "metricId": "ffffffff-ffff-ffff-ffff-ffffffffffff:example-RelayRelayNamespace-01",
    "createdAt": "2017-01-23T20:38:12.46Z",
    "serviceBusEndpoint": "https://example-RelayRelayNamespace-01.servicebus.windows.net:443/",
    "updatedAt": "2017-01-23T20:38:34.533Z"
  }
}

Definitionen

Name	Beschreibung
ConnectionState	Details zum Status der Verbindung.
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
EndPointProvisioningState	Bereitstellungsstatus der privaten Endpunktverbindung.
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
PrivateEndpoint	Die Private Endpoint-Ressource für diese Verbindung.
PrivateEndpointConnection	Liste der privaten Endpunktverbindungen.
PrivateLinkConnectionStatus	Status der Verbindung.
PublicNetworkAccess	Dadurch wird ermittelt, ob Datenverkehr über das öffentliche Netzwerk zulässig ist. Standardmäßig ist sie aktiviert.
RelayNamespace	Beschreibung einer Namespaceressource.
Sku	SKU des Namespace.
SkuName	Name dieser SKU.
SkuTier	Die Ebene dieser SKU.
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.

ConnectionState

Objekt

Details zum Status der Verbindung.

Name	Typ	Beschreibung
description	string	Beschreibung des Verbindungszustands.
status	PrivateLinkConnectionStatus	Status der Verbindung.

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
Application
Key
ManagedIdentity
User

EndPointProvisioningState

Enumeration

Bereitstellungsstatus der privaten Endpunktverbindung.

Wert	Beschreibung
Canceled
Creating
Deleting
Failed
Succeeded
Updating

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

PrivateEndpoint

Objekt

Die Private Endpoint-Ressource für diese Verbindung.

Name	Typ	Beschreibung
id	string	Der ARM-Bezeichner für private Endpunkte.

PrivateEndpointConnection

Objekt

Liste der privaten Endpunktverbindungen.

Name	Typ	Beschreibung
id	string	Vollqualifizierte Ressourcen-ID für die Ressource. Ex - /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.privateEndpoint	PrivateEndpoint	Die Private Endpoint-Ressource für diese Verbindung.
properties.privateLinkServiceConnectionState	ConnectionState	Details zum Status der Verbindung.
properties.provisioningState	EndPointProvisioningState	Bereitstellungsstatus der privaten Endpunktverbindung.
systemData	systemData	Die Systemmetadaten, die sich auf diese Ressource beziehen.
type	string	Der Typ der Ressource. Z. B. "Microsoft.EventHub/Namespaces" oder "Microsoft.EventHub/Namespaces/EventHubs"

PrivateLinkConnectionStatus

Enumeration

Status der Verbindung.

Wert	Beschreibung
Approved
Disconnected
Pending
Rejected

PublicNetworkAccess

Enumeration

Dadurch wird ermittelt, ob Datenverkehr über das öffentliche Netzwerk zulässig ist. Standardmäßig ist sie aktiviert.

Wert	Beschreibung
Disabled
Enabled
SecuredByPerimeter

RelayNamespace

Objekt

Beschreibung einer Namespaceressource.

Name	Typ	Standardwert	Beschreibung
id	string		Ressourcen-ID.
location	string		Ressourcenspeicherort.
name	string		Ressourcenname.
properties.createdAt	string (date-time)		Der Zeitpunkt, zu dem der Namespace erstellt wurde.
properties.metricId	string		Bezeichner für Azure Insights-Metriken.
properties.privateEndpointConnections	PrivateEndpointConnection[]		Liste der privaten Endpunktverbindungen.
properties.provisioningState	string		Bereitstellungsstatus des Namespace.
properties.publicNetworkAccess	PublicNetworkAccess	Enabled	Dadurch wird ermittelt, ob Datenverkehr über das öffentliche Netzwerk zulässig ist. Standardmäßig ist sie aktiviert.
properties.serviceBusEndpoint	string		Endpunkt, den Sie zum Ausführen von ServiceBus-Vorgängen verwenden können.
properties.status	string		Status des Namespace.
properties.updatedAt	string (date-time)		Der Zeitpunkt, zu dem der Namespace aktualisiert wurde.
sku	Sku		SKU des Namespace.
systemData	systemData		Die Systemmetadaten, die sich auf diese Ressource beziehen.
tags	object		Ressourcentags.
type	string		Ressourcentyp.

Sku

Objekt

SKU des Namespace.

Name	Typ	Beschreibung
name	SkuName	Name dieser SKU.
tier	SkuTier	Die Ebene dieser SKU.

SkuName

Enumeration

Name dieser SKU.

Wert	Beschreibung
Standard

SkuTier

Enumeration

Die Ebene dieser SKU.

Wert	Beschreibung
Standard

systemData

Objekt

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string (date-time)	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string (date-time)	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.