다음을 통해 공유

Microsoft.EventGrid 네임스페이스 2024-12-15-preview

  • 아티클

Bicep 리소스 정의

네임스페이스 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.EventGrid/네임스페이스 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.

resource symbolicname 'Microsoft.EventGrid/namespaces@2024-12-15-preview' = {
  identity: {
    principalId: 'string'
    tenantId: 'string'
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {
        clientId: 'string'
        principalId: 'string'
      }
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    inboundIpRules: [
      {
        action: 'string'
        ipMask: 'string'
      }
    ]
    isZoneRedundant: bool
    minimumTlsVersionAllowed: 'string'
    privateEndpointConnections: [
      {
        properties: {
          groupIds: [
            'string'
          ]
          privateEndpoint: {
            id: 'string'
          }
          privateLinkServiceConnectionState: {
            actionsRequired: 'string'
            description: 'string'
            status: 'string'
          }
          provisioningState: 'string'
        }
      }
    ]
    publicNetworkAccess: 'string'
    topicsConfiguration: {
      customDomains: [
        {
          certificateUrl: 'string'
          expectedTxtRecordName: 'string'
          expectedTxtRecordValue: 'string'
          fullyQualifiedDomainName: 'string'
          identity: {
            type: 'string'
            userAssignedIdentity: 'string'
          }
          validationState: 'string'
        }
      ]
    }
    topicSpacesConfiguration: {
      clientAuthentication: {
        alternativeAuthenticationNameSources: [
          'string'
        ]
        customJwtAuthentication: {
          encodedIssuerCertificates: [
            {
              encodedCertificate: 'string'
              kid: 'string'
            }
          ]
          issuerCertificates: [
            {
              certificateUrl: 'string'
              identity: {
                type: 'string'
                userAssignedIdentity: 'string'
              }
            }
          ]
          tokenIssuer: 'string'
        }
      }
      customDomains: [
        {
          certificateUrl: 'string'
          expectedTxtRecordName: 'string'
          expectedTxtRecordValue: 'string'
          fullyQualifiedDomainName: 'string'
          identity: {
            type: 'string'
            userAssignedIdentity: 'string'
          }
          validationState: 'string'
        }
      ]
      maximumClientSessionsPerAuthenticationName: int
      maximumSessionExpiryInHours: int
      routeTopicResourceId: 'string'
      routingEnrichments: {
        dynamic: [
          {
            key: 'string'
            value: 'string'
          }
        ]
        static: [
          {
            key: 'string'
            valueType: 'string'
            // For remaining properties, see StaticRoutingEnrichment objects
          }
        ]
      }
      routingIdentityInfo: {
        type: 'string'
        userAssignedIdentity: 'string'
      }
      state: 'string'
    }
  }
  sku: {
    capacity: int
    name: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

StaticRoutingEnrichment 개체

valueType 속성을 설정하여 개체 유형을 지정합니다.

문자열경우 다음을 사용합니다.

{
  value: 'string'
  valueType: 'String'
}

속성 값

ClientAuthenticationSettings

이름 묘사 값
alternativeAuthenticationNameSources 네임스페이스 리소스에 대한 클라이언트 인증 설정과 관련된 대체 인증 이름 원본입니다. 다음 중 어느 것을 포함하는 문자열 배열:
'ClientCertificateDns'
'ClientCertificateEmail'
'ClientCertificateIp'
'ClientCertificateSubject'
'ClientCertificateUri'
customJwtAuthentication 네임스페이스 리소스에 대한 사용자 지정 JWT 인증 설정입니다. CustomJwtAuthenticationSettings

ConnectionState

이름 묘사 값
actionsRequired 필요한 작업(있는 경우)입니다. 문자열
묘사 연결 상태에 대한 설명입니다. 문자열
상태 연결의 상태입니다. '승인됨'
'연결 끊김'
'보류 중'
'거부됨'

CustomDomainConfiguration

이름 묘사 값
certificateUrl 사용자 지정 도메인에 게시하는 데 사용되는 인증서의 URL입니다. 현재 Azure Key Vault에 저장된 인증서만 지원합니다. 인증서 URL은 둘 중 하나일 수 있지만
{key-vault-name}.vault.azure.net/certificates/{certificate-name}/{version-id}https:// 형식의 버전이 지정된 URL 또는 다음 형식의 확인되지 않은 URL(예:
https://contosovault.vault.azure.net/certificates/contosocert, 확인되지 않은 인증서 URL만 지원합니다(예: https://contosovault.vault.azure.net/certificates/contosocert).		 문자열
expectedTxtRecordName DNS TXT 레코드 이름이 필요합니다. Event Grid는 도메인에 대한 소유권을 증명하기 위해 사용자 지정 도메인 이름의 DNS 레코드 집합에서 이 이름의 TXT 레코드를 확인합니다.
이 TXT 레코드 아래의 값에는 예상된 TXT 레코드 값이 포함되어야 합니다.		 문자열
expectedTxtRecordValue DNS TXT 레코드 값이 필요합니다. Event Grid는 도메인에 대한 소유권을 증명하기 위해 사용자 지정 도메인 이름의 DNS 레코드 집합에서 이 값이 있는 TXT 레코드를 확인합니다. 문자열
fullyQualifiedDomainName 사용자 지정 도메인에 대한 FQDN(정규화된 도메인 이름)입니다. string(필수)
신원 사용자 지정 도메인의 인증서에 액세스하기 위한 ID 정보입니다. 이 ID 정보는 네임스페이스에 설정된 ID와 일치해야 합니다. CustomDomainIdentity
validationState 사용자 지정 도메인에 대한 유효성 검사 상태입니다. 읽기 전용 속성이며 처음에는 '보류 중'으로 설정되며 도메인 이름의 소유권이 성공적으로 유효성을 검사한 후에만 Event Grid에서 '승인됨'으로 업데이트됩니다. '승인됨'
'ErrorRetrievingDnsRecord'
'보류 중'

CustomDomainIdentity

이름 묘사 값
형 사용되는 관리 ID의 형식입니다. 'SystemAssigned' 또는 'UserAssigned'일 수 있습니다. 'SystemAssigned'
'UserAssigned'
userAssignedIdentity 리소스와 연결된 사용자 ID입니다. 문자열

CustomJwtAuthenticationManagedIdentity

이름 묘사 값
형 사용되는 관리 ID의 형식입니다. 'SystemAssigned' 또는 'UserAssigned'일 수 있습니다. 'SystemAssigned'
'UserAssigned'(필수)
userAssignedIdentity 리소스와 연결된 사용자 ID입니다. 문자열

CustomJwtAuthenticationSettings

이름 묘사 값
encodedIssuerCertificates 사용자 지정 인증에 사용되는 인코딩된 공용 인증서에 대한 정보입니다. EncodedIssuerCertificateInfo[]
issuerCertificates 토큰 유효성 검사에 사용되는 인증서에 대한 정보입니다. 현재 최대 2개의 인증서를 지원합니다. IssuerCertificateInfo[]
tokenIssuer 필요한 JWT 토큰 발급자입니다. 문자열

DynamicRoutingEnrichment

이름 묘사 값
열쇠 동적 라우팅 보강 키입니다. 문자열
값 동적 라우팅 보강 값입니다. 문자열

EncodedIssuerCertificateInfo

이름 묘사 값
encodedCertificate pem 형식의 인증서입니다. string(필수)
꼬마 인증서의 식별자입니다. string(필수)

IdentityInfo

이름 묘사 값
principalId 리소스 ID의 보안 주체 ID입니다. 문자열
tenantId 리소스의 테넌트 ID입니다. 문자열
형 사용되는 관리 ID의 형식입니다. 'SystemAssigned, UserAssigned' 형식에는 암시적으로 생성된 ID와 사용자 할당 ID 집합이 모두 포함됩니다. 'None' 형식은 모든 ID를 제거합니다. 'None'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities 리소스와 연결된 사용자 ID 목록입니다. 사용자 ID 사전 키 참조는 양식의 ARM 리소스 ID입니다.
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
이 속성은 현재 사용되지 않으며 향후 사용을 위해 예약되어 있습니다.		 IdentityInfoUserAssignedIdentities

IdentityInfoUserAssignedIdentities

이름 묘사 값

InboundIpRule

이름 묘사 값
행동 IpMask의 일치 또는 일치 여부에 따라 수행할 작업입니다. '허용'
ipMask CIDR 표기법의 IP 주소(예: 10.0.0.0/8). 문자열

IssuerCertificateInfo

이름 묘사 값
certificateUrl https://keyvaultname.vault.azure.net/certificates/certificateName/certificateVersion 형식의 Keyvault 인증서 URL입니다. string(필수)
신원 인증서에 액세스하는 데 사용할 ID입니다. CustomJwtAuthenticationManagedIdentity

Microsoft.EventGrid/namespaces

이름 묘사 값
신원 네임스페이스 리소스에 대한 ID 정보입니다. IdentityInfo
위치 리소스의 위치입니다. string(필수)
이름 리소스 이름 문자열

제약 조건:
최소 길이 = 3
최대 길이 = 3
패턴 = ^[a-zA-Z0-9-]*$(필수)
속성 네임스페이스 리소스의 속성입니다. NamespaceProperties
sku 사용 가능한 Sku 가격 책정 계층을 나타냅니다. NamespaceSku
태그 리소스 태그 태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.

NamespaceProperties

이름 묘사 값
inboundIpRules 모든 IP 대신 특정 IP의 트래픽을 제한하는 데 사용할 수 있습니다. 참고: PublicNetworkAccess를 사용하는 경우에만 고려됩니다. InboundIpRule[]
isZoneRedundant 선택적 속성이며 사용자가 네임스페이스 리소스가 영역 중복 기능을 지원하는지 여부를 지정할 수 있습니다. 이 경우
속성은 사용자가 명시적으로 지정하지 않으며 기본값은 다음 조건에 따라 달라집니다.
a. 가용성 영역 사용 지역의 경우 - 기본 속성 값은 true입니다.
b. 비가용성 영역 사용 지역의 경우 - 기본 속성 값은 false입니다.
지정한 후에는 이 속성을 업데이트할 수 없습니다.		 bool
minimumTlsVersionAllowed 이 네임스페이스에 게시할 수 있는 게시자의 최소 TLS 버전입니다. TLS 버전 1.2만 지원됩니다. '1.0'
'1.1'
'1.2'
privateEndpointConnections 프라이빗 엔드포인트 연결 목록입니다. PrivateEndpointConnection[]
publicNetworkAccess 이는 공용 네트워크를 통해 트래픽이 허용되는지 여부를 결정합니다. 기본적으로 사용하도록 설정됩니다.
<seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.PubSub.NamespaceProperties.InboundIpRules"/> 구성하여 특정 IP로 더 제한할 수 있습니다.		 '사용 안 함'
'Enabled'
'SecuredByPerimeter'
topicsConfiguration 네임스페이스 리소스에 대한 토픽 구성 정보 TopicsConfiguration
topicSpacesConfiguration 네임스페이스 리소스에 대한 토픽 공간 구성 정보 TopicSpacesConfiguration

NamespaceSku

이름 묘사 값
용량 네임스페이스의 용량을 정의하는 처리량 단위 수를 지정합니다. 속성 기본값은
1 처리량 단위 = 네임스페이스당 1MB/s 수신 및 2MB/s 송신을 나타내는 1입니다. 최소 용량은 1이고
허용되는 최대 용량은 20입니다.		 int
이름 SKU의 이름입니다. 'Standard'

PrivateEndpoint

이름 묘사 값
아이디 프라이빗 엔드포인트의 ARM 식별자입니다. 문자열

PrivateEndpointConnection

이름 묘사 값
속성 PrivateEndpointConnection의 속성입니다. PrivateEndpointConnectionProperties

PrivateEndpointConnectionProperties

이름 묘사 값
groupIds 프라이빗 링크 서비스 리소스의 GroupId입니다. string[]
privateEndpoint 이 연결에 대한 프라이빗 엔드포인트 리소스입니다. PrivateEndpoint
privateLinkServiceConnectionState 연결 상태에 대한 세부 정보입니다. ConnectionState
provisioningState 프라이빗 엔드포인트 연결의 프로비전 상태입니다. 'Canceled'
'만들기'
'삭제 중'
'실패'
'성공'
'업데이트 중'

RoutingEnrichments

이름 묘사 값
동적인 dynamicRoutingEnrichment[]
정적인 staticRoutingEnrichment[]

RoutingIdentityInfo

이름 묘사 값
형 토픽 공간 구성에 대한 라우팅 ID 유형입니다. 'None'
'SystemAssigned'
'UserAssigned'
userAssignedIdentity 문자열

StaticRoutingEnrichment

이름 묘사 값
열쇠 정적 라우팅 보강 키입니다. 문자열
valueType StaticStringRoutingEnrichment형식에 대해 'String'으로 설정합니다. 'String'(필수)

StaticStringRoutingEnrichment

이름 묘사 값
값 문자열 형식 라우팅 보강 값입니다. 문자열
valueType 정적 라우팅 보강 값 형식입니다. 예를 들어 이 속성 값은 'String'일 수 있습니다. 'String'(필수)

TopicsConfiguration

이름 묘사 값
customDomains 네임스페이스에 대한 사용자 지정 도메인 구성 목록입니다. customDomainConfiguration[]

TopicSpacesConfiguration

이름 묘사 값
clientAuthentication 토픽 공간 구성에 대한 클라이언트 인증 설정입니다. ClientAuthenticationSettings
customDomains 네임스페이스에 대한 사용자 지정 도메인 구성 목록입니다. customDomainConfiguration[]
maximumClientSessionsPerAuthenticationName 인증 이름당 최대 세션 수입니다. 속성 기본값은 1입니다.
허용되는 최소값은 1이고 허용되는 최대 값은 100입니다.		 int
maximumSessionExpiryInHours 최대 세션 만료 시간(시간)입니다. 속성 기본값은 1시간입니다.
최소 허용 값은 1시간이고 허용되는 최대 값은 8시간입니다.		 int
routeTopicResourceId 이벤트가 네임스페이스 아래의 TopicSpaces에서 라우팅되는 Event Grid 토픽에 대한 정규화된 Azure 리소스 ID입니다.
이 속성은 '/subscriptions/{subId}/resourcegroups/{resourceGroupName}/providers/microsoft 형식이어야 합니다. EventGrid/topics/{topicName}'.
이 항목은 네임스페이스가 있는 동일한 지역에 있어야 합니다.		 문자열
routingEnrichments 토픽 공간 구성에 대한 라우팅 보강 RoutingEnrichments
routingIdentityInfo 토픽 공간 구성에 대한 라우팅 ID 정보입니다. RoutingIdentityInfo
상태 네임스페이스에 토픽 공간 구성을 사용할 수 있는지 여부를 나타냅니다. 기본값은 사용 안 함입니다. '사용 안 함'
'Enabled'

TrackedResourceTags

이름 묘사 값

UserIdentityProperties

이름 묘사 값
clientId 사용자 할당 ID의 클라이언트 ID입니다. 문자열
principalId 사용자 할당 ID의 보안 주체 ID입니다. 문자열

ARM 템플릿 리소스 정의

네임스페이스 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.EventGrid/namespaces 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.

{
  "type": "Microsoft.EventGrid/namespaces",
  "apiVersion": "2024-12-15-preview",
  "name": "string",
  "identity": {
    "principalId": "string",
    "tenantId": "string",
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
        "clientId": "string",
        "principalId": "string"
      }
    }
  },
  "location": "string",
  "properties": {
    "inboundIpRules": [
      {
        "action": "string",
        "ipMask": "string"
      }
    ],
    "isZoneRedundant": "bool",
    "minimumTlsVersionAllowed": "string",
    "privateEndpointConnections": [
      {
        "properties": {
          "groupIds": [ "string" ],
          "privateEndpoint": {
            "id": "string"
          },
          "privateLinkServiceConnectionState": {
            "actionsRequired": "string",
            "description": "string",
            "status": "string"
          },
          "provisioningState": "string"
        }
      }
    ],
    "publicNetworkAccess": "string",
    "topicsConfiguration": {
      "customDomains": [
        {
          "certificateUrl": "string",
          "expectedTxtRecordName": "string",
          "expectedTxtRecordValue": "string",
          "fullyQualifiedDomainName": "string",
          "identity": {
            "type": "string",
            "userAssignedIdentity": "string"
          },
          "validationState": "string"
        }
      ]
    },
    "topicSpacesConfiguration": {
      "clientAuthentication": {
        "alternativeAuthenticationNameSources": [ "string" ],
        "customJwtAuthentication": {
          "encodedIssuerCertificates": [
            {
              "encodedCertificate": "string",
              "kid": "string"
            }
          ],
          "issuerCertificates": [
            {
              "certificateUrl": "string",
              "identity": {
                "type": "string",
                "userAssignedIdentity": "string"
              }
            }
          ],
          "tokenIssuer": "string"
        }
      },
      "customDomains": [
        {
          "certificateUrl": "string",
          "expectedTxtRecordName": "string",
          "expectedTxtRecordValue": "string",
          "fullyQualifiedDomainName": "string",
          "identity": {
            "type": "string",
            "userAssignedIdentity": "string"
          },
          "validationState": "string"
        }
      ],
      "maximumClientSessionsPerAuthenticationName": "int",
      "maximumSessionExpiryInHours": "int",
      "routeTopicResourceId": "string",
      "routingEnrichments": {
        "dynamic": [
          {
            "key": "string",
            "value": "string"
          }
        ],
        "static": [ {
          "key": "string",
          "valueType": "string"
          // For remaining properties, see StaticRoutingEnrichment objects
        } ]
      },
      "routingIdentityInfo": {
        "type": "string",
        "userAssignedIdentity": "string"
      },
      "state": "string"
    }
  },
  "sku": {
    "capacity": "int",
    "name": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

StaticRoutingEnrichment 개체

valueType 속성을 설정하여 개체 유형을 지정합니다.

문자열경우 다음을 사용합니다.

{
  "value": "string",
  "valueType": "String"
}

속성 값

ClientAuthenticationSettings

이름 묘사 값
alternativeAuthenticationNameSources 네임스페이스 리소스에 대한 클라이언트 인증 설정과 관련된 대체 인증 이름 원본입니다. 다음 중 어느 것을 포함하는 문자열 배열:
'ClientCertificateDns'
'ClientCertificateEmail'
'ClientCertificateIp'
'ClientCertificateSubject'
'ClientCertificateUri'
customJwtAuthentication 네임스페이스 리소스에 대한 사용자 지정 JWT 인증 설정입니다. CustomJwtAuthenticationSettings

ConnectionState

이름 묘사 값
actionsRequired 필요한 작업(있는 경우)입니다. 문자열
묘사 연결 상태에 대한 설명입니다. 문자열
상태 연결의 상태입니다. '승인됨'
'연결 끊김'
'보류 중'
'거부됨'

CustomDomainConfiguration

이름 묘사 값
certificateUrl 사용자 지정 도메인에 게시하는 데 사용되는 인증서의 URL입니다. 현재 Azure Key Vault에 저장된 인증서만 지원합니다. 인증서 URL은 둘 중 하나일 수 있지만
{key-vault-name}.vault.azure.net/certificates/{certificate-name}/{version-id}https:// 형식의 버전이 지정된 URL 또는 다음 형식의 확인되지 않은 URL(예:
https://contosovault.vault.azure.net/certificates/contosocert, 확인되지 않은 인증서 URL만 지원합니다(예: https://contosovault.vault.azure.net/certificates/contosocert).		 문자열
expectedTxtRecordName DNS TXT 레코드 이름이 필요합니다. Event Grid는 도메인에 대한 소유권을 증명하기 위해 사용자 지정 도메인 이름의 DNS 레코드 집합에서 이 이름의 TXT 레코드를 확인합니다.
이 TXT 레코드 아래의 값에는 예상된 TXT 레코드 값이 포함되어야 합니다.		 문자열
expectedTxtRecordValue DNS TXT 레코드 값이 필요합니다. Event Grid는 도메인에 대한 소유권을 증명하기 위해 사용자 지정 도메인 이름의 DNS 레코드 집합에서 이 값이 있는 TXT 레코드를 확인합니다. 문자열
fullyQualifiedDomainName 사용자 지정 도메인에 대한 FQDN(정규화된 도메인 이름)입니다. string(필수)
신원 사용자 지정 도메인의 인증서에 액세스하기 위한 ID 정보입니다. 이 ID 정보는 네임스페이스에 설정된 ID와 일치해야 합니다. CustomDomainIdentity
validationState 사용자 지정 도메인에 대한 유효성 검사 상태입니다. 읽기 전용 속성이며 처음에는 '보류 중'으로 설정되며 도메인 이름의 소유권이 성공적으로 유효성을 검사한 후에만 Event Grid에서 '승인됨'으로 업데이트됩니다. '승인됨'
'ErrorRetrievingDnsRecord'
'보류 중'

CustomDomainIdentity

이름 묘사 값
형 사용되는 관리 ID의 형식입니다. 'SystemAssigned' 또는 'UserAssigned'일 수 있습니다. 'SystemAssigned'
'UserAssigned'
userAssignedIdentity 리소스와 연결된 사용자 ID입니다. 문자열

CustomJwtAuthenticationManagedIdentity

이름 묘사 값
형 사용되는 관리 ID의 형식입니다. 'SystemAssigned' 또는 'UserAssigned'일 수 있습니다. 'SystemAssigned'
'UserAssigned'(필수)
userAssignedIdentity 리소스와 연결된 사용자 ID입니다. 문자열

CustomJwtAuthenticationSettings

이름 묘사 값
encodedIssuerCertificates 사용자 지정 인증에 사용되는 인코딩된 공용 인증서에 대한 정보입니다. EncodedIssuerCertificateInfo[]
issuerCertificates 토큰 유효성 검사에 사용되는 인증서에 대한 정보입니다. 현재 최대 2개의 인증서를 지원합니다. IssuerCertificateInfo[]
tokenIssuer 필요한 JWT 토큰 발급자입니다. 문자열

DynamicRoutingEnrichment

이름 묘사 값
열쇠 동적 라우팅 보강 키입니다. 문자열
값 동적 라우팅 보강 값입니다. 문자열

EncodedIssuerCertificateInfo

이름 묘사 값
encodedCertificate pem 형식의 인증서입니다. string(필수)
꼬마 인증서의 식별자입니다. string(필수)

IdentityInfo

이름 묘사 값
principalId 리소스 ID의 보안 주체 ID입니다. 문자열
tenantId 리소스의 테넌트 ID입니다. 문자열
형 사용되는 관리 ID의 형식입니다. 'SystemAssigned, UserAssigned' 형식에는 암시적으로 생성된 ID와 사용자 할당 ID 집합이 모두 포함됩니다. 'None' 형식은 모든 ID를 제거합니다. 'None'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities 리소스와 연결된 사용자 ID 목록입니다. 사용자 ID 사전 키 참조는 양식의 ARM 리소스 ID입니다.
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
이 속성은 현재 사용되지 않으며 향후 사용을 위해 예약되어 있습니다.		 IdentityInfoUserAssignedIdentities

IdentityInfoUserAssignedIdentities

이름 묘사 값

InboundIpRule

이름 묘사 값
행동 IpMask의 일치 또는 일치 여부에 따라 수행할 작업입니다. '허용'
ipMask CIDR 표기법의 IP 주소(예: 10.0.0.0/8). 문자열

IssuerCertificateInfo

이름 묘사 값
certificateUrl https://keyvaultname.vault.azure.net/certificates/certificateName/certificateVersion 형식의 Keyvault 인증서 URL입니다. string(필수)
신원 인증서에 액세스하는 데 사용할 ID입니다. CustomJwtAuthenticationManagedIdentity

Microsoft.EventGrid/namespaces

이름 묘사 값
apiVersion api 버전 '2024-12-15-preview'
신원 네임스페이스 리소스에 대한 ID 정보입니다. IdentityInfo
위치 리소스의 위치입니다. string(필수)
이름 리소스 이름 문자열

제약 조건:
최소 길이 = 3
최대 길이 = 3
패턴 = ^[a-zA-Z0-9-]*$(필수)
속성 네임스페이스 리소스의 속성입니다. NamespaceProperties
sku 사용 가능한 Sku 가격 책정 계층을 나타냅니다. NamespaceSku
태그 리소스 태그 태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.
형 리소스 종류 'Microsoft.EventGrid/namespaces'

NamespaceProperties

이름 묘사 값
inboundIpRules 모든 IP 대신 특정 IP의 트래픽을 제한하는 데 사용할 수 있습니다. 참고: PublicNetworkAccess를 사용하는 경우에만 고려됩니다. InboundIpRule[]
isZoneRedundant 선택적 속성이며 사용자가 네임스페이스 리소스가 영역 중복 기능을 지원하는지 여부를 지정할 수 있습니다. 이 경우
속성은 사용자가 명시적으로 지정하지 않으며 기본값은 다음 조건에 따라 달라집니다.
a. 가용성 영역 사용 지역의 경우 - 기본 속성 값은 true입니다.
b. 비가용성 영역 사용 지역의 경우 - 기본 속성 값은 false입니다.
지정한 후에는 이 속성을 업데이트할 수 없습니다.		 bool
minimumTlsVersionAllowed 이 네임스페이스에 게시할 수 있는 게시자의 최소 TLS 버전입니다. TLS 버전 1.2만 지원됩니다. '1.0'
'1.1'
'1.2'
privateEndpointConnections 프라이빗 엔드포인트 연결 목록입니다. PrivateEndpointConnection[]
publicNetworkAccess 이는 공용 네트워크를 통해 트래픽이 허용되는지 여부를 결정합니다. 기본적으로 사용하도록 설정됩니다.
<seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.PubSub.NamespaceProperties.InboundIpRules"/> 구성하여 특정 IP로 더 제한할 수 있습니다.		 '사용 안 함'
'Enabled'
'SecuredByPerimeter'
topicsConfiguration 네임스페이스 리소스에 대한 토픽 구성 정보 TopicsConfiguration
topicSpacesConfiguration 네임스페이스 리소스에 대한 토픽 공간 구성 정보 TopicSpacesConfiguration

NamespaceSku

이름 묘사 값
용량 네임스페이스의 용량을 정의하는 처리량 단위 수를 지정합니다. 속성 기본값은
1 처리량 단위 = 네임스페이스당 1MB/s 수신 및 2MB/s 송신을 나타내는 1입니다. 최소 용량은 1이고
허용되는 최대 용량은 20입니다.		 int
이름 SKU의 이름입니다. 'Standard'

PrivateEndpoint

이름 묘사 값
아이디 프라이빗 엔드포인트의 ARM 식별자입니다. 문자열

PrivateEndpointConnection

이름 묘사 값
속성 PrivateEndpointConnection의 속성입니다. PrivateEndpointConnectionProperties

PrivateEndpointConnectionProperties

이름 묘사 값
groupIds 프라이빗 링크 서비스 리소스의 GroupId입니다. string[]
privateEndpoint 이 연결에 대한 프라이빗 엔드포인트 리소스입니다. PrivateEndpoint
privateLinkServiceConnectionState 연결 상태에 대한 세부 정보입니다. ConnectionState
provisioningState 프라이빗 엔드포인트 연결의 프로비전 상태입니다. 'Canceled'
'만들기'
'삭제 중'
'실패'
'성공'
'업데이트 중'

RoutingEnrichments

이름 묘사 값
동적인 dynamicRoutingEnrichment[]
정적인 staticRoutingEnrichment[]

RoutingIdentityInfo

이름 묘사 값
형 토픽 공간 구성에 대한 라우팅 ID 유형입니다. 'None'
'SystemAssigned'
'UserAssigned'
userAssignedIdentity 문자열

StaticRoutingEnrichment

이름 묘사 값
열쇠 정적 라우팅 보강 키입니다. 문자열
valueType StaticStringRoutingEnrichment형식에 대해 'String'으로 설정합니다. 'String'(필수)

StaticStringRoutingEnrichment

이름 묘사 값
값 문자열 형식 라우팅 보강 값입니다. 문자열
valueType 정적 라우팅 보강 값 형식입니다. 예를 들어 이 속성 값은 'String'일 수 있습니다. 'String'(필수)

TopicsConfiguration

이름 묘사 값
customDomains 네임스페이스에 대한 사용자 지정 도메인 구성 목록입니다. customDomainConfiguration[]

TopicSpacesConfiguration

이름 묘사 값
clientAuthentication 토픽 공간 구성에 대한 클라이언트 인증 설정입니다. ClientAuthenticationSettings
customDomains 네임스페이스에 대한 사용자 지정 도메인 구성 목록입니다. customDomainConfiguration[]
maximumClientSessionsPerAuthenticationName 인증 이름당 최대 세션 수입니다. 속성 기본값은 1입니다.
허용되는 최소값은 1이고 허용되는 최대 값은 100입니다.		 int
maximumSessionExpiryInHours 최대 세션 만료 시간(시간)입니다. 속성 기본값은 1시간입니다.
최소 허용 값은 1시간이고 허용되는 최대 값은 8시간입니다.		 int
routeTopicResourceId 이벤트가 네임스페이스 아래의 TopicSpaces에서 라우팅되는 Event Grid 토픽에 대한 정규화된 Azure 리소스 ID입니다.
이 속성은 '/subscriptions/{subId}/resourcegroups/{resourceGroupName}/providers/microsoft 형식이어야 합니다. EventGrid/topics/{topicName}'.
이 항목은 네임스페이스가 있는 동일한 지역에 있어야 합니다.		 문자열
routingEnrichments 토픽 공간 구성에 대한 라우팅 보강 RoutingEnrichments
routingIdentityInfo 토픽 공간 구성에 대한 라우팅 ID 정보입니다. RoutingIdentityInfo
상태 네임스페이스에 토픽 공간 구성을 사용할 수 있는지 여부를 나타냅니다. 기본값은 사용 안 함입니다. '사용 안 함'
'Enabled'

TrackedResourceTags

이름 묘사 값

UserIdentityProperties

이름 묘사 값
clientId 사용자 할당 ID의 클라이언트 ID입니다. 문자열
principalId 사용자 할당 ID의 보안 주체 ID입니다. 문자열

Terraform(AzAPI 공급자) 리소스 정의

네임스페이스 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

  • 리소스 그룹

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.EventGrid/namespaces 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.EventGrid/namespaces@2024-12-15-preview"
  name = "string"
  identity = {
    principalId = "string"
    tenantId = "string"
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
        clientId = "string"
        principalId = "string"
      }
    }
  }
  location = "string"
  sku = {
    capacity = int
    name = "string"
  }
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      inboundIpRules = [
        {
          action = "string"
          ipMask = "string"
        }
      ]
      isZoneRedundant = bool
      minimumTlsVersionAllowed = "string"
      privateEndpointConnections = [
        {
          properties = {
            groupIds = [
              "string"
            ]
            privateEndpoint = {
              id = "string"
            }
            privateLinkServiceConnectionState = {
              actionsRequired = "string"
              description = "string"
              status = "string"
            }
            provisioningState = "string"
          }
        }
      ]
      publicNetworkAccess = "string"
      topicsConfiguration = {
        customDomains = [
          {
            certificateUrl = "string"
            expectedTxtRecordName = "string"
            expectedTxtRecordValue = "string"
            fullyQualifiedDomainName = "string"
            identity = {
              type = "string"
              userAssignedIdentity = "string"
            }
            validationState = "string"
          }
        ]
      }
      topicSpacesConfiguration = {
        clientAuthentication = {
          alternativeAuthenticationNameSources = [
            "string"
          ]
          customJwtAuthentication = {
            encodedIssuerCertificates = [
              {
                encodedCertificate = "string"
                kid = "string"
              }
            ]
            issuerCertificates = [
              {
                certificateUrl = "string"
                identity = {
                  type = "string"
                  userAssignedIdentity = "string"
                }
              }
            ]
            tokenIssuer = "string"
          }
        }
        customDomains = [
          {
            certificateUrl = "string"
            expectedTxtRecordName = "string"
            expectedTxtRecordValue = "string"
            fullyQualifiedDomainName = "string"
            identity = {
              type = "string"
              userAssignedIdentity = "string"
            }
            validationState = "string"
          }
        ]
        maximumClientSessionsPerAuthenticationName = int
        maximumSessionExpiryInHours = int
        routeTopicResourceId = "string"
        routingEnrichments = {
          dynamic = [
            {
              key = "string"
              value = "string"
            }
          ]
          static = [
            {
              key = "string"
              valueType = "string"
              // For remaining properties, see StaticRoutingEnrichment objects
            }
          ]
        }
        routingIdentityInfo = {
          type = "string"
          userAssignedIdentity = "string"
        }
        state = "string"
      }
    }
  })
}

StaticRoutingEnrichment 개체

valueType 속성을 설정하여 개체 유형을 지정합니다.

문자열경우 다음을 사용합니다.

{
  value = "string"
  valueType = "String"
}

속성 값

ClientAuthenticationSettings

이름 묘사 값
alternativeAuthenticationNameSources 네임스페이스 리소스에 대한 클라이언트 인증 설정과 관련된 대체 인증 이름 원본입니다. 다음 중 어느 것을 포함하는 문자열 배열:
'ClientCertificateDns'
'ClientCertificateEmail'
'ClientCertificateIp'
'ClientCertificateSubject'
'ClientCertificateUri'
customJwtAuthentication 네임스페이스 리소스에 대한 사용자 지정 JWT 인증 설정입니다. CustomJwtAuthenticationSettings

ConnectionState

이름 묘사 값
actionsRequired 필요한 작업(있는 경우)입니다. 문자열
묘사 연결 상태에 대한 설명입니다. 문자열
상태 연결의 상태입니다. '승인됨'
'연결 끊김'
'보류 중'
'거부됨'

CustomDomainConfiguration

이름 묘사 값
certificateUrl 사용자 지정 도메인에 게시하는 데 사용되는 인증서의 URL입니다. 현재 Azure Key Vault에 저장된 인증서만 지원합니다. 인증서 URL은 둘 중 하나일 수 있지만
{key-vault-name}.vault.azure.net/certificates/{certificate-name}/{version-id}https:// 형식의 버전이 지정된 URL 또는 다음 형식의 확인되지 않은 URL(예:
https://contosovault.vault.azure.net/certificates/contosocert, 확인되지 않은 인증서 URL만 지원합니다(예: https://contosovault.vault.azure.net/certificates/contosocert).		 문자열
expectedTxtRecordName DNS TXT 레코드 이름이 필요합니다. Event Grid는 도메인에 대한 소유권을 증명하기 위해 사용자 지정 도메인 이름의 DNS 레코드 집합에서 이 이름의 TXT 레코드를 확인합니다.
이 TXT 레코드 아래의 값에는 예상된 TXT 레코드 값이 포함되어야 합니다.		 문자열
expectedTxtRecordValue DNS TXT 레코드 값이 필요합니다. Event Grid는 도메인에 대한 소유권을 증명하기 위해 사용자 지정 도메인 이름의 DNS 레코드 집합에서 이 값이 있는 TXT 레코드를 확인합니다. 문자열
fullyQualifiedDomainName 사용자 지정 도메인에 대한 FQDN(정규화된 도메인 이름)입니다. string(필수)
신원 사용자 지정 도메인의 인증서에 액세스하기 위한 ID 정보입니다. 이 ID 정보는 네임스페이스에 설정된 ID와 일치해야 합니다. CustomDomainIdentity
validationState 사용자 지정 도메인에 대한 유효성 검사 상태입니다. 읽기 전용 속성이며 처음에는 '보류 중'으로 설정되며 도메인 이름의 소유권이 성공적으로 유효성을 검사한 후에만 Event Grid에서 '승인됨'으로 업데이트됩니다. '승인됨'
'ErrorRetrievingDnsRecord'
'보류 중'

CustomDomainIdentity

이름 묘사 값
형 사용되는 관리 ID의 형식입니다. 'SystemAssigned' 또는 'UserAssigned'일 수 있습니다. 'SystemAssigned'
'UserAssigned'
userAssignedIdentity 리소스와 연결된 사용자 ID입니다. 문자열

CustomJwtAuthenticationManagedIdentity

이름 묘사 값
형 사용되는 관리 ID의 형식입니다. 'SystemAssigned' 또는 'UserAssigned'일 수 있습니다. 'SystemAssigned'
'UserAssigned'(필수)
userAssignedIdentity 리소스와 연결된 사용자 ID입니다. 문자열

CustomJwtAuthenticationSettings

이름 묘사 값
encodedIssuerCertificates 사용자 지정 인증에 사용되는 인코딩된 공용 인증서에 대한 정보입니다. EncodedIssuerCertificateInfo[]
issuerCertificates 토큰 유효성 검사에 사용되는 인증서에 대한 정보입니다. 현재 최대 2개의 인증서를 지원합니다. IssuerCertificateInfo[]
tokenIssuer 필요한 JWT 토큰 발급자입니다. 문자열

DynamicRoutingEnrichment

이름 묘사 값
열쇠 동적 라우팅 보강 키입니다. 문자열
값 동적 라우팅 보강 값입니다. 문자열

EncodedIssuerCertificateInfo

이름 묘사 값
encodedCertificate pem 형식의 인증서입니다. string(필수)
꼬마 인증서의 식별자입니다. string(필수)

IdentityInfo

이름 묘사 값
principalId 리소스 ID의 보안 주체 ID입니다. 문자열
tenantId 리소스의 테넌트 ID입니다. 문자열
형 사용되는 관리 ID의 형식입니다. 'SystemAssigned, UserAssigned' 형식에는 암시적으로 생성된 ID와 사용자 할당 ID 집합이 모두 포함됩니다. 'None' 형식은 모든 ID를 제거합니다. 'None'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities 리소스와 연결된 사용자 ID 목록입니다. 사용자 ID 사전 키 참조는 양식의 ARM 리소스 ID입니다.
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
이 속성은 현재 사용되지 않으며 향후 사용을 위해 예약되어 있습니다.		 IdentityInfoUserAssignedIdentities

IdentityInfoUserAssignedIdentities

이름 묘사 값

InboundIpRule

이름 묘사 값
행동 IpMask의 일치 또는 일치 여부에 따라 수행할 작업입니다. '허용'
ipMask CIDR 표기법의 IP 주소(예: 10.0.0.0/8). 문자열

IssuerCertificateInfo

이름 묘사 값
certificateUrl https://keyvaultname.vault.azure.net/certificates/certificateName/certificateVersion 형식의 Keyvault 인증서 URL입니다. string(필수)
신원 인증서에 액세스하는 데 사용할 ID입니다. CustomJwtAuthenticationManagedIdentity

Microsoft.EventGrid/namespaces

이름 묘사 값
신원 네임스페이스 리소스에 대한 ID 정보입니다. IdentityInfo
위치 리소스의 위치입니다. string(필수)
이름 리소스 이름 문자열

제약 조건:
최소 길이 = 3
최대 길이 = 3
패턴 = ^[a-zA-Z0-9-]*$(필수)
속성 네임스페이스 리소스의 속성입니다. NamespaceProperties
sku 사용 가능한 Sku 가격 책정 계층을 나타냅니다. NamespaceSku
태그 리소스 태그 태그 이름 및 값의 사전입니다.
형 리소스 종류 "Microsoft.EventGrid/namespaces@2024-12-15-preview"

NamespaceProperties

이름 묘사 값
inboundIpRules 모든 IP 대신 특정 IP의 트래픽을 제한하는 데 사용할 수 있습니다. 참고: PublicNetworkAccess를 사용하는 경우에만 고려됩니다. InboundIpRule[]
isZoneRedundant 선택적 속성이며 사용자가 네임스페이스 리소스가 영역 중복 기능을 지원하는지 여부를 지정할 수 있습니다. 이 경우
속성은 사용자가 명시적으로 지정하지 않으며 기본값은 다음 조건에 따라 달라집니다.
a. 가용성 영역 사용 지역의 경우 - 기본 속성 값은 true입니다.
b. 비가용성 영역 사용 지역의 경우 - 기본 속성 값은 false입니다.
지정한 후에는 이 속성을 업데이트할 수 없습니다.		 bool
minimumTlsVersionAllowed 이 네임스페이스에 게시할 수 있는 게시자의 최소 TLS 버전입니다. TLS 버전 1.2만 지원됩니다. '1.0'
'1.1'
'1.2'
privateEndpointConnections 프라이빗 엔드포인트 연결 목록입니다. PrivateEndpointConnection[]
publicNetworkAccess 이는 공용 네트워크를 통해 트래픽이 허용되는지 여부를 결정합니다. 기본적으로 사용하도록 설정됩니다.
<seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.PubSub.NamespaceProperties.InboundIpRules"/> 구성하여 특정 IP로 더 제한할 수 있습니다.		 '사용 안 함'
'Enabled'
'SecuredByPerimeter'
topicsConfiguration 네임스페이스 리소스에 대한 토픽 구성 정보 TopicsConfiguration
topicSpacesConfiguration 네임스페이스 리소스에 대한 토픽 공간 구성 정보 TopicSpacesConfiguration

NamespaceSku

이름 묘사 값
용량 네임스페이스의 용량을 정의하는 처리량 단위 수를 지정합니다. 속성 기본값은
1 처리량 단위 = 네임스페이스당 1MB/s 수신 및 2MB/s 송신을 나타내는 1입니다. 최소 용량은 1이고
허용되는 최대 용량은 20입니다.		 int
이름 SKU의 이름입니다. 'Standard'

PrivateEndpoint

이름 묘사 값
아이디 프라이빗 엔드포인트의 ARM 식별자입니다. 문자열

PrivateEndpointConnection

이름 묘사 값
속성 PrivateEndpointConnection의 속성입니다. PrivateEndpointConnectionProperties

PrivateEndpointConnectionProperties

이름 묘사 값
groupIds 프라이빗 링크 서비스 리소스의 GroupId입니다. string[]
privateEndpoint 이 연결에 대한 프라이빗 엔드포인트 리소스입니다. PrivateEndpoint
privateLinkServiceConnectionState 연결 상태에 대한 세부 정보입니다. ConnectionState
provisioningState 프라이빗 엔드포인트 연결의 프로비전 상태입니다. 'Canceled'
'만들기'
'삭제 중'
'실패'
'성공'
'업데이트 중'

RoutingEnrichments

이름 묘사 값
동적인 dynamicRoutingEnrichment[]
정적인 staticRoutingEnrichment[]

RoutingIdentityInfo

이름 묘사 값
형 토픽 공간 구성에 대한 라우팅 ID 유형입니다. 'None'
'SystemAssigned'
'UserAssigned'
userAssignedIdentity 문자열

StaticRoutingEnrichment

이름 묘사 값
열쇠 정적 라우팅 보강 키입니다. 문자열
valueType StaticStringRoutingEnrichment형식에 대해 'String'으로 설정합니다. 'String'(필수)

StaticStringRoutingEnrichment

이름 묘사 값
값 문자열 형식 라우팅 보강 값입니다. 문자열
valueType 정적 라우팅 보강 값 형식입니다. 예를 들어 이 속성 값은 'String'일 수 있습니다. 'String'(필수)

TopicsConfiguration

이름 묘사 값
customDomains 네임스페이스에 대한 사용자 지정 도메인 구성 목록입니다. customDomainConfiguration[]

TopicSpacesConfiguration

이름 묘사 값
clientAuthentication 토픽 공간 구성에 대한 클라이언트 인증 설정입니다. ClientAuthenticationSettings
customDomains 네임스페이스에 대한 사용자 지정 도메인 구성 목록입니다. customDomainConfiguration[]
maximumClientSessionsPerAuthenticationName 인증 이름당 최대 세션 수입니다. 속성 기본값은 1입니다.
허용되는 최소값은 1이고 허용되는 최대 값은 100입니다.		 int
maximumSessionExpiryInHours 최대 세션 만료 시간(시간)입니다. 속성 기본값은 1시간입니다.
최소 허용 값은 1시간이고 허용되는 최대 값은 8시간입니다.		 int
routeTopicResourceId 이벤트가 네임스페이스 아래의 TopicSpaces에서 라우팅되는 Event Grid 토픽에 대한 정규화된 Azure 리소스 ID입니다.
이 속성은 '/subscriptions/{subId}/resourcegroups/{resourceGroupName}/providers/microsoft 형식이어야 합니다. EventGrid/topics/{topicName}'.
이 항목은 네임스페이스가 있는 동일한 지역에 있어야 합니다.		 문자열
routingEnrichments 토픽 공간 구성에 대한 라우팅 보강 RoutingEnrichments
routingIdentityInfo 토픽 공간 구성에 대한 라우팅 ID 정보입니다. RoutingIdentityInfo
상태 네임스페이스에 토픽 공간 구성을 사용할 수 있는지 여부를 나타냅니다. 기본값은 사용 안 함입니다. '사용 안 함'
'Enabled'

TrackedResourceTags

이름 묘사 값

UserIdentityProperties

이름 묘사 값
clientId 사용자 할당 ID의 클라이언트 ID입니다. 문자열
principalId 사용자 할당 ID의 보안 주체 ID입니다. 문자열