Megosztás a következőn keresztül:

Namespaces - Create Or Update

  • Referencia
Szolgáltatás:
Event Hubs
API-verzió:
2024-01-01

Létrehoz vagy frissít egy névteret. A létrehozás után a névtér erőforrásjegyzéke nem módosítható. Ez a művelet idempotens.

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

URI-paraméterek

Name In Kötelező Típus Description
namespaceName
 path True

string

A névtér neve

Reguláris kifejezési minta: ^[a-zA-Z][a-zA-Z0-9-]{6,50}[a-zA-Z0-9]$
resourceGroupName
 path True

string

Az azure-előfizetésben található erőforráscsoport neve.
subscriptionId
 path True

string

Az előfizetés hitelesítő adatai, amelyek egyedileg azonosítják a Microsoft Azure-előfizetést. Az előfizetés-azonosító az URI részét képezi minden szolgáltatáshíváshoz.
api-version
 query True

string

Ügyfél API-verziója.

Kérelem törzse

Name Típus Description
parameters

EHNamespace

Névtérerőforrás létrehozásának paraméterei.

Válaszok

Name Típus Description
200 OK

EHNamespace

A névtér létrehozása sikerült.
201 Created

EHNamespace

A névtér létrehozási kérése elfogadva.
202 Accepted

A névtér létrehozási vagy frissítési kérése elfogadva.
Other Status Codes

ErrorResponse

Az EventHub hibaválasza, amely leírja, hogy a művelet miért nem sikerült.

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name Description
user_impersonation felhasználói fiók megszemélyesítése

Példák

NamespaceCreate

Mintakérelem

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

Mintaválasz

Állapotkód:
200 
{
  "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/"
  }
}
Állapotkód:
201 
{
  "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/"
  }
}
Állapotkód:
202

Definíciók

Name Description
ConnectionState

A kapcsolat állapotának részletei.
createdByType

Az erőforrást létrehozó identitás típusa.
EHNamespace

Egyetlen névtérelem a List vagy a Get műveletben
EndPointProvisioningState

A privát végponti kapcsolat kiépítési állapota.
ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.
ErrorDetail

A hiba részletei.
ErrorResponse

A hibaválasz azt jelzi, hogy az Event Hub szolgáltatás nem tudja feldolgozni a bejövő kérést. Ennek okát a hibaüzenet adja meg.
keySource

A keySource for Encryption lehetséges értékének számbavétele
KeyVaultProperties

A KeyVault tulajdonságai
ManagedServiceIdentityType

A felügyeltszolgáltatás-identitás típusa.
PrivateEndpoint

A kapcsolat privát végponti erőforrása.
PrivateEndpointConnection

A privát végponti kapcsolatok listája.
PrivateLinkConnectionStatus

A kapcsolat állapota.
PublicNetworkAccess

Ez határozza meg, hogy a forgalom engedélyezett-e a nyilvános hálózaton keresztül. Alapértelmezés szerint engedélyezve van.
Sku

A termékváltozat-erőforrás tulajdonságai
SkuName

A termékváltozat neve.
SkuTier

Az adott termékváltozat számlázási szintje.
systemData

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
TlsVersion

A fürt minimális TLS-verziója, például "1.2"
UserAssignedIdentity

Felismert szótárérték.

ConnectionState

A kapcsolat állapotának részletei.

Name Típus Description
description

string

A kapcsolat állapotának leírása.
status

PrivateLinkConnectionStatus

A kapcsolat állapota.

createdByType

Az erőforrást létrehozó identitás típusa.

Name Típus Description
Application

string

Key

string

ManagedIdentity

string

User

string

EHNamespace

Egyetlen névtérelem a List vagy a Get műveletben

Name Típus Alapértelmezett érték Description
id

string

Az erőforrás teljes erőforrás-azonosítója. Például : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity.principalId

string

ObjectId a KeyVaultból
identity.tenantId

string

TenantId a KeyVaultból
identity.type

ManagedServiceIdentityType

A felügyeltszolgáltatás-identitás típusa.
identity.userAssignedIdentities

<string,  UserAssignedIdentity>

A felhasználó által hozzárendelt identitások tulajdonságai
location

string

Erőforrás helye.
name

string

Az erőforrás neve
properties.alternateName

string

Másodlagos név, amely akkor van megadva, ha az alias és a névtér neve megegyezik.
properties.clusterArmId

string

A névtér fürt ARM-azonosítója.
properties.createdAt

string

A névtér létrehozásának időpontja.
properties.disableLocalAuth

boolean

Ez a tulajdonság letiltja az SAS-hitelesítést az Event Hubs-névtérben.
properties.encryption.keySource

keySource

Microsoft.KeyVault

A keySource for Encryption lehetséges értékének számbavétele
properties.encryption.keyVaultProperties

KeyVaultProperties[]

A KeyVault tulajdonságai
properties.encryption.requireInfrastructureEncryption

boolean

Infrastruktúra-titkosítás engedélyezése (dupla titkosítás)
properties.isAutoInflateEnabled

boolean

Az az érték, amely azt jelzi, hogy az Automatikus feltöltés engedélyezve van-e az EventHub-névtérben.
properties.kafkaEnabled

boolean

Érték, amely azt jelzi, hogy a Kafka engedélyezve van-e az EventHub-névtérben.
properties.maximumThroughputUnits

integer

Ha az AutoInflate engedélyezve van, az átviteli egységek felső korlátjának 0–20 átviteli egységen belül kell lennie. ( '0' ha AutoInflateEnabled = true)
properties.metricId

string

Az Azure Insights-metrikák azonosítója.
properties.minimumTlsVersion

TlsVersion

A fürt minimális TLS-verziója, például "1.2"
properties.privateEndpointConnections

PrivateEndpointConnection[]

A privát végponti kapcsolatok listája.
properties.provisioningState

string

A névtér kiépítési állapota.
properties.publicNetworkAccess

PublicNetworkAccess

Enabled

Ez határozza meg, hogy a forgalom engedélyezett-e a nyilvános hálózaton keresztül. Alapértelmezés szerint engedélyezve van.
properties.serviceBusEndpoint

string

A Service Bus-műveletek végrehajtásához használható végpont.
properties.status

string

A névtér állapota.
properties.updatedAt

string

A névtér frissítésének időpontja.
properties.zoneRedundant

boolean

A tulajdonság engedélyezése standard Event Hubs-névteret hoz létre a támogatott rendelkezésre állási zónákban.
sku

Sku

A termékváltozat-erőforrás tulajdonságai
systemData

systemData

Az erőforráshoz kapcsolódó rendszer metaadatai.
tags

object

Erőforráscímkék.
type

string

Az erőforrás típusa. Például"Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts"

EndPointProvisioningState

A privát végponti kapcsolat kiépítési állapota.

Name Típus Description
Canceled

string

Creating

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

Name Típus Description
info

object

A további információk.
type

string

A további adattípus.

ErrorDetail

A hiba részletei.

Name Típus Description
additionalInfo

ErrorAdditionalInfo[]

A hiba további információi.
code

string

A hibakód.
details

ErrorDetail[]

A hiba részletei.
message

string

A hibaüzenet.
target

string

A hiba célja.

ErrorResponse

A hibaválasz azt jelzi, hogy az Event Hub szolgáltatás nem tudja feldolgozni a bejövő kérést. Ennek okát a hibaüzenet adja meg.

Name Típus Description
error

ErrorDetail

A hibaobjektum.

keySource

A keySource for Encryption lehetséges értékének számbavétele

Name Típus Description
Microsoft.KeyVault

string

KeyVaultProperties

A KeyVault tulajdonságai

Name Típus Description
identity.userAssignedIdentity

string

A titkosításhoz kiválasztott felhasználói identitás ARM-azonosítója
keyName

string

A KeyVault kulcsának neve
keyVaultUri

string

A KeyVault URI-ja
keyVersion

string

Kulcs verziója

ManagedServiceIdentityType

A felügyeltszolgáltatás-identitás típusa.

Name Típus Description
None

string

SystemAssigned

string

SystemAssigned, UserAssigned

string

UserAssigned

string

PrivateEndpoint

A kapcsolat privát végponti erőforrása.

Name Típus Description
id

string

A privát végpont ARM-azonosítója.

PrivateEndpointConnection

A privát végponti kapcsolatok listája.

Name Típus Description
id

string

Az erőforrás teljes erőforrás-azonosítója. Például : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location

string

A földrajzi hely, ahol az erőforrás él
name

string

Az erőforrás neve
properties.privateEndpoint

PrivateEndpoint

A kapcsolat privát végponti erőforrása.
properties.privateLinkServiceConnectionState

ConnectionState

A kapcsolat állapotának részletei.
properties.provisioningState

EndPointProvisioningState

A privát végponti kapcsolat kiépítési állapota.
systemData

systemData

Az erőforráshoz kapcsolódó rendszer metaadatai.
type

string

Az erőforrás típusa. Pl. "Microsoft.EventHub/Namespaces" vagy "Microsoft.EventHub/Namespaces/EventHubs"

PrivateLinkConnectionStatus

A kapcsolat állapota.

Name Típus Description
Approved

string

Disconnected

string

Pending

string

Rejected

string

PublicNetworkAccess

Ez határozza meg, hogy a forgalom engedélyezett-e a nyilvános hálózaton keresztül. Alapértelmezés szerint engedélyezve van.

Name Típus Description
Disabled

string

Enabled

string

SecuredByPerimeter

string

Sku

A termékváltozat-erőforrás tulajdonságai

Name Típus Description
capacity

integer

Az Event Hubs átviteli egységei alapszintű vagy standard szinten, ahol az értéknek 0 és 20 átviteli egység között kell lennie. Az Event Hubs prémium szintű egységei, ahol az értéknek 0 és 10 prémium egység között kell lennie.
name

SkuName

A termékváltozat neve.
tier

SkuTier

Az adott termékváltozat számlázási szintje.

SkuName

A termékváltozat neve.

Name Típus Description
Basic

string

Premium

string

Standard

string

SkuTier

Az adott termékváltozat számlázási szintje.

Name Típus Description
Basic

string

Premium

string

Standard

string

systemData

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Name Típus Description
createdAt

string

Az erőforrás-létrehozás időbélyege (UTC).
createdBy

string

Az erőforrást létrehozó identitás.
createdByType

createdByType

Az erőforrást létrehozó identitás típusa.
lastModifiedAt

string

Az erőforrást legutóbb módosító identitás típusa.
lastModifiedBy

string

Az erőforrást utoljára módosító identitás.
lastModifiedByType

createdByType

Az erőforrást legutóbb módosító identitás típusa.

TlsVersion

A fürt minimális TLS-verziója, például "1.2"

Name Típus Description
1.0

string

1.1

string

1.2

string

UserAssignedIdentity

Felismert szótárérték.

Name Típus Description
clientId

string

A felhasználó által hozzárendelt identitás ügyfél-azonosítója
principalId

string

A felhasználó által hozzárendelt identitás egyszerű azonosítója