Namespaces - Create Or Update
Crea o actualiza un espacio de nombres. Una vez creado, el manifiesto de recursos de este espacio de nombres es inmutable. Esta operación es idempotente.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventHub/namespaces/{namespaceName}?api-version=2024-01-01
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
namespace
|
path | True |
string |
Nombre del espacio de nombres Patrón de Regex: |
resource
|
path | True |
string |
Nombre del grupo de recursos dentro de la suscripción de Azure. |
subscription
|
path | True |
string |
Credenciales de suscripción que identifican de forma única una suscripción de Microsoft Azure. El identificador de suscripción forma parte del URI para cada llamada al servicio. |
api-version
|
query | True |
string |
Versión de la API de cliente. |
Cuerpo de la solicitud
Nombre | Tipo | Description |
---|---|---|
parameters |
Parámetros para crear un recurso de espacio de nombres. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Espacio de nombres creado correctamente. |
|
201 Created |
Solicitud de creación del espacio de nombres aceptada. |
|
202 Accepted |
Se ha aceptado la solicitud de creación o actualización del espacio de nombres. |
|
Other Status Codes |
Respuesta de error del centro de eventos que describe por qué se produjo un error en la operación. |
Seguridad
azure_auth
Flujo OAuth2 de Azure Active Directory
Tipo:
oauth2
Flujo:
implicit
Dirección URL de autorización:
https://login.microsoftonline.com/common/oauth2/authorize
Ámbitos
Nombre | Description |
---|---|
user_impersonation | suplantación de su cuenta de usuario |
Ejemplos
NamespaceCreate
Solicitud de ejemplo
PUT https://management.azure.com/subscriptions/SampleSubscription/resourceGroups/ResurceGroupSample/providers/Microsoft.EventHub/namespaces/NamespaceSample?api-version=2024-01-01
{
"location": "East US",
"identity": {
"type": "SystemAssigned, UserAssigned",
"userAssignedIdentities": {
"/subscriptions/SampleSubscription/resourceGroups/ResurceGroupSample/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ud1": {},
"/subscriptions/SampleSubscription/resourceGroups/ResurceGroupSample/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ud2": {}
}
},
"properties": {
"encryption": {
"keyVaultProperties": [
{
"keyName": "Samplekey",
"keyVaultUri": "https://aprao-keyvault-user.vault-int.azure-int.net/",
"identity": {
"userAssignedIdentity": "/subscriptions/SampleSubscription/resourceGroups/ResurceGroupSample/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ud1"
}
}
],
"keySource": "Microsoft.KeyVault"
},
"clusterArmId": "/subscriptions/SampleSubscription/resourceGroups/ResurceGroupSample/providers/Microsoft.EventHub/clusters/enc-test"
}
}
Respuesta de muestra
{
"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": {
"zoneRedundant": false,
"isAutoInflateEnabled": false,
"disableLocalAuth": false,
"maximumThroughputUnits": 0,
"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
},
"clusterArmId": "/subscriptions/SampleSubscription/resourceGroups/ResurceGroupSample/providers/Microsoft.EventHub/clusters/enc-test",
"kafkaEnabled": false,
"provisioningState": "Succeeded",
"metricId": "MetricGUID:NamespaceSample",
"createdAt": "2021-02-16T22:36:06.107Z",
"updatedAt": "2021-02-16T22:37:42.29Z",
"serviceBusEndpoint": "https://NamespaceSample.servicebus.windows-int.net:443/"
}
}
{
"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": {
"zoneRedundant": false,
"isAutoInflateEnabled": false,
"disableLocalAuth": false,
"maximumThroughputUnits": 0,
"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
},
"clusterArmId": "/subscriptions/SampleSubscription/resourceGroups/ResurceGroupSample/providers/Microsoft.EventHub/clusters/enc-test",
"kafkaEnabled": false,
"provisioningState": "Succeeded",
"metricId": "MetricGUID:NamespaceSample",
"createdAt": "2021-02-16T22:36:06.107Z",
"updatedAt": "2021-02-16T22:37:42.29Z",
"serviceBusEndpoint": "https://NamespaceSample.servicebus.windows-int.net:443/"
}
}
Definiciones
Nombre | Description |
---|---|
Connection |
Detalles sobre el estado de la conexión. |
created |
Tipo de identidad que creó el recurso. |
EHNamespace |
Elemento de espacio de nombres único en la operación List or Get |
End |
Estado de aprovisionamiento de la conexión de punto de conexión privado. |
Error |
Información adicional sobre el error de administración de recursos. |
Error |
Detalle del error. |
Error |
La respuesta de error indica que el servicio Event Hubs no puede procesar la solicitud entrante. El motivo se proporciona en el mensaje de error. |
key |
Enumera el valor posible de keySource para el cifrado. |
Key |
Propiedades de KeyVault |
Managed |
Tipo de identidad de servicio administrada. |
Private |
Recurso de punto de conexión privado para esta conexión. |
Private |
Lista de conexiones de punto de conexión privado. |
Private |
Estado de la conexión. |
Public |
Esto determina si se permite el tráfico a través de la red pública. De forma predeterminada, está habilitado. |
Sku |
Propiedades del recurso de SKU |
Sku |
Nombre de esta SKU. |
Sku |
El nivel de facturación de esta SKU determinada. |
system |
Metadatos relacionados con la creación y la última modificación del recurso. |
Tls |
Versión mínima de TLS para que el clúster admita, por ejemplo, "1.2". |
User |
Valor de diccionario reconocido. |
ConnectionState
Detalles sobre el estado de la conexión.
Nombre | Tipo | Description |
---|---|---|
description |
string |
Descripción del estado de conexión. |
status |
Estado de la conexión. |
createdByType
Tipo de identidad que creó el recurso.
Nombre | Tipo | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
EHNamespace
Elemento de espacio de nombres único en la operación List or Get
Nombre | Tipo | Valor predeterminado | Description |
---|---|---|---|
id |
string |
Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
|
identity.principalId |
string |
ObjectId de KeyVault |
|
identity.tenantId |
string |
TenantId de KeyVault |
|
identity.type |
Tipo de identidad de servicio administrada. |
||
identity.userAssignedIdentities |
<string,
User |
Propiedades de identidades asignadas por el usuario |
|
location |
string |
Ubicación del recurso |
|
name |
string |
Nombre del recurso. |
|
properties.alternateName |
string |
Nombre alternativo especificado cuando los nombres de alias y espacios de nombres son iguales. |
|
properties.clusterArmId |
string |
Id. de ARM del clúster del espacio de nombres. |
|
properties.createdAt |
string |
Hora en que se creó el espacio de nombres. |
|
properties.disableLocalAuth |
boolean |
Esta propiedad deshabilita la autenticación de SAS para el espacio de nombres de Event Hubs. |
|
properties.encryption.keySource | Microsoft.KeyVault |
Enumera el valor posible de keySource para el cifrado. |
|
properties.encryption.keyVaultProperties |
Propiedades de KeyVault |
||
properties.encryption.requireInfrastructureEncryption |
boolean |
Habilitación del cifrado de infraestructura (cifrado doble) |
|
properties.isAutoInflateEnabled |
boolean |
Valor que indica si AutoInflate está habilitado para el espacio de nombres del centro de eventos. |
|
properties.kafkaEnabled |
boolean |
Valor que indica si Kafka está habilitado para el espacio de nombres del centro de eventos. |
|
properties.maximumThroughputUnits |
integer |
Límite superior de unidades de rendimiento cuando AutoInflate está habilitado, el valor debe estar comprendido entre 0 y 20 unidades de rendimiento. ( '0' si AutoInflateEnabled = true) |
|
properties.metricId |
string |
Identificador de las métricas de Azure Insights. |
|
properties.minimumTlsVersion |
Versión mínima de TLS para que el clúster admita, por ejemplo, "1.2". |
||
properties.privateEndpointConnections |
Lista de conexiones de punto de conexión privado. |
||
properties.provisioningState |
string |
Estado de aprovisionamiento del espacio de nombres. |
|
properties.publicNetworkAccess | Enabled |
Esto determina si se permite el tráfico a través de la red pública. De forma predeterminada, está habilitado. |
|
properties.serviceBusEndpoint |
string |
Punto de conexión que puede usar para realizar operaciones de Service Bus. |
|
properties.status |
string |
Estado del espacio de nombres. |
|
properties.updatedAt |
string |
Hora en que se actualizó el espacio de nombres. |
|
properties.zoneRedundant |
boolean |
Al habilitar esta propiedad, se crea un espacio de nombres de Event Hubs estándar en regiones compatibles con zonas de disponibilidad. |
|
sku |
Propiedades del recurso de SKU |
||
systemData |
Metadatos del sistema relacionados con este recurso. |
||
tags |
object |
Etiquetas del recurso. |
|
type |
string |
Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts" |
EndPointProvisioningState
Estado de aprovisionamiento de la conexión de punto de conexión privado.
Nombre | Tipo | Description |
---|---|---|
Canceled |
string |
|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
ErrorAdditionalInfo
Información adicional sobre el error de administración de recursos.
Nombre | Tipo | Description |
---|---|---|
info |
object |
Información adicional. |
type |
string |
Tipo de información adicional. |
ErrorDetail
Detalle del error.
Nombre | Tipo | Description |
---|---|---|
additionalInfo |
Información adicional del error. |
|
code |
string |
Código de error. |
details |
Los detalles del error. |
|
message |
string |
El mensaje de error. |
target |
string |
Destino del error. |
ErrorResponse
La respuesta de error indica que el servicio Event Hubs no puede procesar la solicitud entrante. El motivo se proporciona en el mensaje de error.
Nombre | Tipo | Description |
---|---|---|
error |
Objeto de error. |
keySource
Enumera el valor posible de keySource para el cifrado.
Nombre | Tipo | Description |
---|---|---|
Microsoft.KeyVault |
string |
KeyVaultProperties
Propiedades de KeyVault
Nombre | Tipo | Description |
---|---|---|
identity.userAssignedIdentity |
string |
Identificador de ARM de la identidad de usuario seleccionada para el cifrado |
keyName |
string |
Nombre de la clave de KeyVault |
keyVaultUri |
string |
Uri de KeyVault |
keyVersion |
string |
Versión de la clave |
ManagedServiceIdentityType
Tipo de identidad de servicio administrada.
Nombre | Tipo | Description |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
SystemAssigned, UserAssigned |
string |
|
UserAssigned |
string |
PrivateEndpoint
Recurso de punto de conexión privado para esta conexión.
Nombre | Tipo | Description |
---|---|---|
id |
string |
Identificador de ARM para punto de conexión privado. |
PrivateEndpointConnection
Lista de conexiones de punto de conexión privado.
Nombre | Tipo | Description |
---|---|---|
id |
string |
Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
location |
string |
Ubicación geográfica donde reside el recurso |
name |
string |
Nombre del recurso. |
properties.privateEndpoint |
Recurso de punto de conexión privado para esta conexión. |
|
properties.privateLinkServiceConnectionState |
Detalles sobre el estado de la conexión. |
|
properties.provisioningState |
Estado de aprovisionamiento de la conexión de punto de conexión privado. |
|
systemData |
Metadatos del sistema relacionados con este recurso. |
|
type |
string |
Tipo de recurso. Por ejemplo, "Microsoft.EventHub/Namespaces" o "Microsoft.EventHub/Namespaces/EventHubs" |
PrivateLinkConnectionStatus
Estado de la conexión.
Nombre | Tipo | Description |
---|---|---|
Approved |
string |
|
Disconnected |
string |
|
Pending |
string |
|
Rejected |
string |
PublicNetworkAccess
Esto determina si se permite el tráfico a través de la red pública. De forma predeterminada, está habilitado.
Nombre | Tipo | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
|
SecuredByPerimeter |
string |
Sku
Propiedades del recurso de SKU
Nombre | Tipo | Description |
---|---|---|
capacity |
integer |
Las unidades de rendimiento de Event Hubs para los niveles Básico o Estándar, donde el valor debe ser de 0 a 20 unidades de rendimiento. Las unidades Premium de Event Hubs para el nivel Premium, donde el valor debe ser de 0 a 10 unidades premium. |
name |
Nombre de esta SKU. |
|
tier |
El nivel de facturación de esta SKU determinada. |
SkuName
Nombre de esta SKU.
Nombre | Tipo | Description |
---|---|---|
Basic |
string |
|
Premium |
string |
|
Standard |
string |
SkuTier
El nivel de facturación de esta SKU determinada.
Nombre | Tipo | Description |
---|---|---|
Basic |
string |
|
Premium |
string |
|
Standard |
string |
systemData
Metadatos relacionados con la creación y la última modificación del recurso.
Nombre | Tipo | Description |
---|---|---|
createdAt |
string |
Marca de tiempo de creación de recursos (UTC). |
createdBy |
string |
Identidad que creó el recurso. |
createdByType |
Tipo de identidad que creó el recurso. |
|
lastModifiedAt |
string |
Tipo de identidad que modificó por última vez el recurso. |
lastModifiedBy |
string |
Identidad que modificó por última vez el recurso. |
lastModifiedByType |
Tipo de identidad que modificó por última vez el recurso. |
TlsVersion
Versión mínima de TLS para que el clúster admita, por ejemplo, "1.2".
Nombre | Tipo | Description |
---|---|---|
1.0 |
string |
|
1.1 |
string |
|
1.2 |
string |
UserAssignedIdentity
Valor de diccionario reconocido.
Nombre | Tipo | Description |
---|---|---|
clientId |
string |
Identificador de cliente de la identidad asignada por el usuario |
principalId |
string |
Identificador de entidad de seguridad de la identidad asignada por el usuario |