Freigeben über


Namespaces - Get

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

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

{
  "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

Details zum Status der Verbindung.

Name Typ Beschreibung
description

string

Beschreibung des Verbindungszustands.

status

PrivateLinkConnectionStatus

Status der Verbindung.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Wert Beschreibung
Application
Key
ManagedIdentity
User

EndPointProvisioningState

Bereitstellungsstatus der privaten Endpunktverbindung.

Wert Beschreibung
Canceled
Creating
Deleting
Failed
Succeeded
Updating

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name Typ Beschreibung
info

object

Die zusätzlichen Informationen.

type

string

Der zusätzliche Informationstyp.

ErrorDetail

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

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

PrivateEndpoint

Die Private Endpoint-Ressource für diese Verbindung.

Name Typ Beschreibung
id

string

Der ARM-Bezeichner für private Endpunkte.

PrivateEndpointConnection

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

Status der Verbindung.

Wert Beschreibung
Approved
Disconnected
Pending
Rejected

PublicNetworkAccess

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

Wert Beschreibung
Disabled
Enabled
SecuredByPerimeter

RelayNamespace

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

SKU des Namespace.

Name Typ Beschreibung
name

SkuName

Name dieser SKU.

tier

SkuTier

Die Ebene dieser SKU.

SkuName

Name dieser SKU.

Wert Beschreibung
Standard

SkuTier

Die Ebene dieser SKU.

Wert Beschreibung
Standard

systemData

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.