Namespaces - Get
Obtém a descrição do espaço de nomes especificado.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventHub/namespaces/{namespaceName}?api-version=2024-01-01
Parâmetros do URI
Name | Em | Necessário | Tipo | Description |
---|---|---|---|---|
namespace
|
path | True |
string |
O nome do Espaço de Nomes Padrão Regex: |
resource
|
path | True |
string |
Nome do grupo de recursos na subscrição do Azure. |
subscription
|
path | True |
string |
Credenciais de subscrição que identificam exclusivamente uma subscrição do Microsoft Azure. O ID da subscrição faz parte do URI para cada chamada de serviço. |
api-version
|
query | True |
string |
Versão da API de Cliente. |
Respostas
Name | Tipo | Description |
---|---|---|
200 OK |
O espaço de nomes foi devolvido com êxito. |
|
Other Status Codes |
Resposta de erro do Eventhub que descreve o motivo pela qual a operação falhou. |
Segurança
azure_auth
Fluxo OAuth2 do Azure Active Directory
Tipo:
oauth2
Fluxo:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Âmbitos
Name | Description |
---|---|
user_impersonation | representar a sua conta de utilizador |
Exemplos
NameSpaceGet
Pedido de amostra
Resposta da amostra
{
"sku": {
"name": "Standard",
"tier": "Standard",
"capacity": 1
},
"id": "/subscriptions/SampleSubscription/resourceGroups/ResurceGroupSample/providers/Microsoft.EventHub/namespaces/NamespaceSample",
"name": "NamespaceSample",
"type": "Microsoft.EventHub/Namespaces",
"location": "East US",
"tags": {},
"identity": {
"principalId": "PrincipalIdGUID",
"tenantId": "TenantIdGUID",
"type": "SystemAssigned, UserAssigned",
"userAssignedIdentities": {
"/subscriptions/SampleSubscription/resourceGroups/ResurceGroupSample/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ud1": {
"clientId": "ClientIdGUID",
"principalId": "PrincipalIdGUID"
},
"/subscriptions/SampleSubscription/resourceGroups/ResurceGroupSample/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ud2": {
"clientId": "6a35400f-6ccb-4817-8f1a-ce19ea4523bc",
"principalId": "ce2d5953-5c15-40ca-9d51-cc3f4a63b0f5"
}
}
},
"properties": {
"isAutoInflateEnabled": false,
"disableLocalAuth": false,
"maximumThroughputUnits": 0,
"zoneRedundant": false,
"minimumTlsVersion": "1.2",
"encryption": {
"keySource": "Microsoft.KeyVault",
"keyVaultProperties": [
{
"keyName": "Samplekey",
"keyVaultUri": "https://sample-keyvault-user.vault-int.azure-int.net",
"keyVersion": "",
"identity": {
"userAssignedIdentity": "/subscriptions/SampleSubscription/resourceGroups/ResurceGroupSample/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ud1"
}
}
],
"requireInfrastructureEncryption": false
},
"privateEndpointConnections": [
{
"id": "/subscriptions/SampleSubscription/resourceGroups/ResurceGroupSample/providers/Microsoft.EventHub/namespaces/NamespaceSample/privateEndpointConnections/privateEndpointConnectionName",
"name": "privateEndpointConnectionName",
"type": "Microsoft.EventHub/Namespaces/PrivateEndpointConnections",
"properties": {
"provisioningState": "Succeeded",
"privateEndpoint": {
"id": "/subscriptions/SampleSubscription/resourceGroups/ResurceGroupSample/providers/Microsoft.Network/privateEndpoints/NamespaceSample"
},
"privateLinkServiceConnectionState": {
"status": "Approved",
"description": "Auto-Approved"
}
}
}
],
"provisioningState": "Succeeded",
"clusterArmId": "/subscriptions/SampleSubscription/resourceGroups/ResurceGroupSample/providers/Microsoft.EventHub/clusters/enc-test",
"metricId": "MetricGUID:NamespaceSample",
"createdAt": "2021-01-30T00:28:38.963Z",
"updatedAt": "2021-01-30T00:30:55.143Z",
"serviceBusEndpoint": "https://NamespaceSample.servicebus.windows-int.net:443"
}
}
Definições
Name | Description |
---|---|
Connection |
Detalhes sobre o estado da ligação. |
created |
O tipo de identidade que criou o recurso. |
EHNamespace |
Item de Espaço de Nomes Único na Lista ou Em Operação Obter |
End |
Estado de aprovisionamento da Ligação de Ponto Final Privado. |
Error |
Informações adicionais sobre o erro de gestão de recursos. |
Error |
O detalhe do erro. |
Error |
A resposta de erro indica que o serviço Hub de Eventos não consegue processar o pedido recebido. O motivo é fornecido na mensagem de erro. |
key |
Enumera o valor possível de keySource para Encriptação |
Key |
Propriedades do KeyVault |
Managed |
Tipo de identidade de serviço gerida. |
Private |
O recurso de Ponto Final Privado para esta Ligação. |
Private |
Lista de ligações de pontos finais privados. |
Private |
Estado da ligação. |
Public |
Isto determina se o tráfego é permitido através da rede pública. Por predefinição, está ativada. |
Sku |
Propriedades do recurso de SKU |
Sku |
Nome deste SKU. |
Sku |
O escalão de faturação deste SKU específico. |
system |
Metadados relativos à criação e última modificação do recurso. |
Tls |
A versão mínima do TLS para o cluster suportar, por exemplo, "1.2" |
User |
Valor do Dicionário Reconhecido. |
ConnectionState
Detalhes sobre o estado da ligação.
Name | Tipo | Description |
---|---|---|
description |
string |
Descrição do estado da ligação. |
status |
Estado da ligação. |
createdByType
O tipo de identidade que criou o recurso.
Name | Tipo | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
EHNamespace
Item de Espaço de Nomes Único na Lista ou Em Operação Obter
Name | Tipo | Default value | Description |
---|---|---|---|
id |
string |
ID de recurso completamente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
|
identity.principalId |
string |
ObjectId do KeyVault |
|
identity.tenantId |
string |
TenantId do KeyVault |
|
identity.type |
Tipo de identidade de serviço gerida. |
||
identity.userAssignedIdentities |
<string,
User |
Propriedades das Identidades Atribuídas pelo Utilizador |
|
location |
string |
Localização do recurso. |
|
name |
string |
O nome do recurso |
|
properties.alternateName |
string |
Nome alternativo especificado quando os nomes de alias e espaço de nomes são iguais. |
|
properties.clusterArmId |
string |
ID arm do cluster do Espaço de Nomes. |
|
properties.createdAt |
string |
A hora em que o Espaço de Nomes foi criado. |
|
properties.disableLocalAuth |
boolean |
Esta propriedade desativa a autenticação SAS para o espaço de nomes dos Hubs de Eventos. |
|
properties.encryption.keySource | Microsoft.KeyVault |
Enumera o valor possível de keySource para Encriptação |
|
properties.encryption.keyVaultProperties |
Propriedades do KeyVault |
||
properties.encryption.requireInfrastructureEncryption |
boolean |
Ativar a Encriptação de Infraestrutura (Encriptação Dupla) |
|
properties.isAutoInflateEnabled |
boolean |
Valor que indica se o AutoInflate está ativado para o espaço de nomes do eventhub. |
|
properties.kafkaEnabled |
boolean |
Valor que indica se o Kafka está ativado para o espaço de nomes do eventhub. |
|
properties.maximumThroughputUnits |
integer |
Limite superior de unidades de débito quando o AutoInflate está ativado, o valor deve estar dentro de 0 a 20 unidades de débito. ( "0" se AutoInflateEnabled = true) |
|
properties.metricId |
string |
Identificador das métricas do Azure Insights. |
|
properties.minimumTlsVersion |
A versão mínima do TLS para o cluster suportar, por exemplo, "1.2" |
||
properties.privateEndpointConnections |
Lista de ligações de pontos finais privados. |
||
properties.provisioningState |
string |
Estado de aprovisionamento do Espaço de Nomes. |
|
properties.publicNetworkAccess | Enabled |
Isto determina se o tráfego é permitido através da rede pública. Por predefinição, está ativada. |
|
properties.serviceBusEndpoint |
string |
Ponto final que pode utilizar para realizar operações do Service Bus. |
|
properties.status |
string |
Estado do Espaço de Nomes. |
|
properties.updatedAt |
string |
A hora em que o Espaço de Nomes foi atualizado. |
|
properties.zoneRedundant |
boolean |
Ativar esta propriedade cria um Espaço de Nomes dos Hubs de Eventos Standard em regiões com zonas de disponibilidade suportadas. |
|
sku |
Propriedades do recurso de SKU |
||
systemData |
Os metadados do sistema relacionados com este recurso. |
||
tags |
object |
Etiquetas de recursos. |
|
type |
string |
O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts" |
EndPointProvisioningState
Estado de aprovisionamento da Ligação de Ponto Final Privado.
Name | Tipo | Description |
---|---|---|
Canceled |
string |
|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
ErrorAdditionalInfo
Informações adicionais sobre o erro de gestão de recursos.
Name | Tipo | Description |
---|---|---|
info |
object |
As informações adicionais. |
type |
string |
O tipo de informações adicionais. |
ErrorDetail
O detalhe do erro.
Name | Tipo | Description |
---|---|---|
additionalInfo |
As informações adicionais do erro. |
|
code |
string |
O código de erro. |
details |
Os detalhes do erro. |
|
message |
string |
A mensagem de erro. |
target |
string |
O destino do erro. |
ErrorResponse
A resposta de erro indica que o serviço Hub de Eventos não consegue processar o pedido recebido. O motivo é fornecido na mensagem de erro.
Name | Tipo | Description |
---|---|---|
error |
O objeto de erro. |
keySource
Enumera o valor possível de keySource para Encriptação
Name | Tipo | Description |
---|---|---|
Microsoft.KeyVault |
string |
KeyVaultProperties
Propriedades do KeyVault
Name | Tipo | Description |
---|---|---|
identity.userAssignedIdentity |
string |
ID arm da Identidade do utilizador selecionado para encriptação |
keyName |
string |
Nome da Chave do KeyVault |
keyVaultUri |
string |
Uri de KeyVault |
keyVersion |
string |
Versão da Chave |
ManagedServiceIdentityType
Tipo de identidade de serviço gerida.
Name | Tipo | Description |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
SystemAssigned, UserAssigned |
string |
|
UserAssigned |
string |
PrivateEndpoint
O recurso de Ponto Final Privado para esta Ligação.
Name | Tipo | Description |
---|---|---|
id |
string |
O identificador arm do Ponto Final Privado. |
PrivateEndpointConnection
Lista de ligações de pontos finais privados.
Name | Tipo | Description |
---|---|---|
id |
string |
ID de recurso completamente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
location |
string |
A localização geográfica onde reside o recurso |
name |
string |
O nome do recurso |
properties.privateEndpoint |
O recurso de Ponto Final Privado para esta Ligação. |
|
properties.privateLinkServiceConnectionState |
Detalhes sobre o estado da ligação. |
|
properties.provisioningState |
Estado de aprovisionamento da Ligação de Ponto Final Privado. |
|
systemData |
Os metadados do sistema relacionados com este recurso. |
|
type |
string |
O tipo do recurso. Por exemplo, "Microsoft.EventHub/Namespaces" ou "Microsoft.EventHub/Namespaces/EventHubs" |
PrivateLinkConnectionStatus
Estado da ligação.
Name | Tipo | Description |
---|---|---|
Approved |
string |
|
Disconnected |
string |
|
Pending |
string |
|
Rejected |
string |
PublicNetworkAccess
Isto determina se o tráfego é permitido através da rede pública. Por predefinição, está ativada.
Name | Tipo | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
|
SecuredByPerimeter |
string |
Sku
Propriedades do recurso de SKU
Name | Tipo | Description |
---|---|---|
capacity |
integer |
As unidades de débito dos Hubs de Eventos para os escalões Básico ou Standard, em que o valor deve ser de 0 a 20 unidades de débito. As unidades premium dos Hubs de Eventos para o escalão Premium, em que o valor deve ser de 0 a 10 unidades premium. |
name |
Nome deste SKU. |
|
tier |
O escalão de faturação deste SKU específico. |
SkuName
Nome deste SKU.
Name | Tipo | Description |
---|---|---|
Basic |
string |
|
Premium |
string |
|
Standard |
string |
SkuTier
O escalão de faturação deste SKU específico.
Name | Tipo | Description |
---|---|---|
Basic |
string |
|
Premium |
string |
|
Standard |
string |
systemData
Metadados relativos à criação e última modificação do recurso.
Name | Tipo | Description |
---|---|---|
createdAt |
string |
O carimbo de data/hora da criação de recursos (UTC). |
createdBy |
string |
A identidade que criou o recurso. |
createdByType |
O tipo de identidade que criou o recurso. |
|
lastModifiedAt |
string |
O tipo de identidade que modificou o recurso pela última vez. |
lastModifiedBy |
string |
A identidade que modificou o recurso pela última vez. |
lastModifiedByType |
O tipo de identidade que modificou o recurso pela última vez. |
TlsVersion
A versão mínima do TLS para o cluster suportar, por exemplo, "1.2"
Name | Tipo | Description |
---|---|---|
1.0 |
string |
|
1.1 |
string |
|
1.2 |
string |
UserAssignedIdentity
Valor do Dicionário Reconhecido.
Name | Tipo | Description |
---|---|---|
clientId |
string |
ID de cliente da identidade atribuída pelo utilizador |
principalId |
string |
ID principal da identidade atribuída pelo utilizador |