Workspaces - Set Outbound Cloud Connection Rules

서비스:: Core

API 버전:: v1

작업 영역에 대한 아웃바운드 액세스 보호 클라우드 연결 규칙을 설정합니다. 이 API를 사용하면 작업 영역 관리자가 클라우드 연결 유형과 해당 작업 영역에서 허용되는 외부 엔드포인트/작업 영역을 제어하는 아웃바운드 네트워크 통신 규칙을 설정할 수 있습니다. 이 기능은 현재 미리 보기로 제공됩니다.

비고

이 API는 미리 보기 릴리스의 일부이며 평가 및 개발 목적으로만 제공됩니다. 피드백에 따라 변경 될 수 있으며 프로덕션 사용에는 권장되지 않습니다.

비고

아웃바운드 액세스 보호 규칙은 작업 영역의 네트워크 통신 정책에 outbound.publicAccessRules.defaultAction이 거부로 설정된 경우에만 적용됩니다. 작업 영역에서 OAP를 사용하도록 설정하지 않으면 아웃바운드 연결이 제한되지 않으므로 API가 실패합니다.

비고

이 API는 PUT 메서드를 사용하며 작업 영역에 대한 모든 아웃바운드 액세스 연결을 덮어씁니다. 요청 본문에 부분 정책이 제공되면 나머지 정책이 기본값으로 설정됩니다. 항상 먼저 가져오기를 실행하고 요청 본문에 전체 정책을 제공합니다.

Permissions

호출자에게는 관리자 작업 영역 역할이 있어야 합니다.

필요한 위임된 범위

작업 공간. 읽기쓰기. 전체

Microsoft Entra 지원 식별자

이 API는 이 섹션에 나열된 Microsoft ID 지원합니다.

아이덴티티	Support
사용자	Yes
서비스 주체 및 관리 ID	Yes

인터페이스

PUT https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/networking/communicationPolicy/outbound/connections

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
workspaceId	path	True	string (uuid)	업데이트할 작업 영역의 고유 식별자입니다.

요청 본문

Name	형식	Description
defaultAction	ConnectionAccessActionType	규칙 배열에 명시적으로 나열되지 않은 모든 클라우드 연결 형식에 대한 기본 동작을 정의합니다. "허용"으로 설정하면 지정되지 않은 모든 연결 형식이 기본적으로 허용됩니다. "거부"로 설정하면 명시적으로 허용되지 않는 한 지정되지 않은 모든 연결 형식이 기본적으로 차단됩니다. 이 설정은 전역 대체 정책 역할을 하며 알려진 연결과 신뢰할 수 있는 연결만 허용되어야 하는 환경에서 보안 기본 상태를 적용하는 데 중요합니다.
rules	OutboundConnectionRule[]	특정 클라우드 연결 형식에 대한 아웃바운드 액세스 동작을 정의하는 규칙 목록입니다. 각 규칙에는 지원되는 연결 유형에 따라 엔드포인트 기반 또는 작업 영역 기반 제한이 포함될 수 있습니다.

응답

Name	형식	Description
200 OK		요청이 성공적으로 완료되었습니다. 헤더 ETag: string
Other Status Codes	ErrorResponse	일반적인 오류 코드: UnknownError - 오류가 발생했습니다.

Name

형식

Description

200 OK

요청이 성공적으로 완료되었습니다.

헤더

ETag: string

Other Status Codes

ErrorResponse

일반적인 오류 코드:

UnknownError - 오류가 발생했습니다.

예제

Set workspace outbound access protection cloud connection rule for example

샘플 요청

HTTP

PUT https://api.fabric.microsoft.com/v1/workspaces/47482db6-4583-4672-86dd-999d0f8f4d7a/networking/communicationPolicy/outbound/connections

{
  "defaultAction": "Deny",
  "rules": [
    {
      "connectionType": "SQL",
      "defaultAction": "Deny",
      "allowedEndpoints": [
        {
          "hostNamePattern": "*.microsoft.com"
        }
      ]
    },
    {
      "connectionType": "LakeHouse",
      "defaultAction": "Deny",
      "allowedWorkspaces": [
        {
          "workspaceId": "91c5ae74-e82d-4dd3-bfeb-6b1814030123"
        }
      ]
    },
    {
      "connectionType": "Web",
      "defaultAction": "Allow"
    }
  ]
}

샘플 응답

상태 코드:: 200

ETag: 0f8fad5b-d9cb-469f-a165-70867728950e

정의

Name	Description
ConnectionAccessActionType	아웃바운드 연결에 대한 액세스 제어 동작을 정의합니다. 이 열거형은 기본적으로 아웃바운드 통신을 허용하거나 거부할지 여부를 지정하기 위해 defaultAction 필드에 사용됩니다. 이 형식을 사용하면 아웃바운드 액세스를 전역 및 연결별로 제어할 수 있으므로 안전하고 예측 가능한 네트워크 통신 정책을 적용할 수 있습니다. 추가 연결 액세스 작업 유형은 시간이 지남에 따라 추가될 수 있습니다.
ConnectionRuleEndpointMetadata	특정 외부 도메인 또는 호스트에 대한 아웃바운드 통신을 허용하는 단일 엔드포인트 수준 예외 규칙을 나타냅니다. 이 개체는 지정된 connectionType에 대해 신뢰할 수 있는 엔드포인트에 대한 아웃바운드 액세스 권한을 명시적으로 부여하기 위해 연결 규칙의 allowedEndpoints 배열 내에서 사용됩니다. 엔드포인트 기반 필터링(예: SQL, MySQL, 웹 등)을 지원하는 연결 형식에만 적용됩니다.
ConnectionRuleWorkspaceMetadata	지정된 connectionType에 대해 특정 작업 영역에 대한 아웃바운드 통신을 허용하는 작업 영역 수준 예외 규칙을 나타냅니다. 이 개체는 연결 규칙의 allowedWorkspaces 배열 내에서 작업 영역 간 액세스 권한을 명시적으로 부여하는 데 사용됩니다. 이는 Lakehouse, Warehouse, FabricSql 및 PowerPlatformDataflows와 같은 작업 영역 기반 필터링을 지원하는 연결 형식에만 적용됩니다.
ErrorRelatedResource	오류 관련 리소스 세부 정보 개체입니다.
ErrorResponse	오류 응답입니다.
ErrorResponseDetails	오류 응답 세부 정보입니다.
OutboundConnectionRule	특정 클라우드 연결에 대한 아웃바운드 액세스 규칙을 정의합니다.
WorkspaceOutboundConnections	네트워킹 통신 정책의 일부로 작업 영역에 대해 구성된 아웃바운드 액세스 보호 클라우드 연결 규칙의 전체 집합을 나타냅니다. 이 개체는 아웃바운드 통신에 허용되거나 거부되는 외부 엔드포인트 및 작업 영역을 제어하는 연결 규칙을 정의합니다.

ConnectionAccessActionType

열거형

아웃바운드 연결에 대한 액세스 제어 동작을 정의합니다. 이 열거형은 기본적으로 아웃바운드 통신을 허용하거나 거부할지 여부를 지정하기 위해 defaultAction 필드에 사용됩니다. 이 형식을 사용하면 아웃바운드 액세스를 전역 및 연결별로 제어할 수 있으므로 안전하고 예측 가능한 네트워크 통신 정책을 적용할 수 있습니다. 추가 연결 액세스 작업 유형은 시간이 지남에 따라 추가될 수 있습니다.

값	Description
Allow	아웃바운드 연결을 허용합니다. 기본 작업으로 사용되는 경우 모든 클라우드 연결이 허용됩니다.
Deny	아웃바운드 연결을 차단합니다. 기본 작업으로 사용되는 경우 명시적으로 허용되지 않는 한 모든 클라우드 연결이 거부됩니다.

ConnectionRuleEndpointMetadata

Object

특정 외부 도메인 또는 호스트에 대한 아웃바운드 통신을 허용하는 단일 엔드포인트 수준 예외 규칙을 나타냅니다. 이 개체는 지정된 connectionType에 대해 신뢰할 수 있는 엔드포인트에 대한 아웃바운드 액세스 권한을 명시적으로 부여하기 위해 연결 규칙의 allowedEndpoints 배열 내에서 사용됩니다. 엔드포인트 기반 필터링(예: SQL, MySQL, 웹 등)을 지원하는 연결 형식에만 적용됩니다.

Name	형식	Description
hostNamePattern	string	허용되는 외부 엔드포인트를 정의하는 와일드카드 지원 패턴입니다. 예를 들어 *.microsoft.com, api.contoso.com 또는 data.partner.org 있습니다.

ConnectionRuleWorkspaceMetadata

Object

지정된 connectionType에 대해 특정 작업 영역에 대한 아웃바운드 통신을 허용하는 작업 영역 수준 예외 규칙을 나타냅니다. 이 개체는 연결 규칙의 allowedWorkspaces 배열 내에서 작업 영역 간 액세스 권한을 명시적으로 부여하는 데 사용됩니다. 이는 Lakehouse, Warehouse, FabricSql 및 PowerPlatformDataflows와 같은 작업 영역 기반 필터링을 지원하는 연결 형식에만 적용됩니다.

Name	형식	Description
workspaceId	string (uuid)	현재 작업 영역에서 연결할 수 있는 대상 작업 영역의 고유 식별자(GUID)입니다.

ErrorRelatedResource

Object

오류 관련 리소스 세부 정보 개체입니다.

Name	형식	Description
resourceId	string	오류와 관련된 리소스 ID입니다.
resourceType	string	오류와 관련된 리소스의 형식입니다.

ErrorResponse

Object

오류 응답입니다.

Name	형식	Description
errorCode	string	오류 조건에 대한 정보를 제공하여 서비스와 사용자 간의 표준화된 통신을 허용하는 특정 식별자입니다.
message	string	사용자가 읽을 수 있는 오류 표현입니다.
moreDetails	ErrorResponseDetails[]	추가 오류 세부 정보 목록입니다.
relatedResource	ErrorRelatedResource	오류 관련 리소스 세부 정보입니다.
requestId	string	오류와 연결된 요청의 ID입니다.

ErrorResponseDetails

Object

오류 응답 세부 정보입니다.

Name	형식	Description
errorCode	string	오류 조건에 대한 정보를 제공하여 서비스와 사용자 간의 표준화된 통신을 허용하는 특정 식별자입니다.
message	string	사용자가 읽을 수 있는 오류 표현입니다.
relatedResource	ErrorRelatedResource	오류 관련 리소스 세부 정보입니다.

OutboundConnectionRule

Object

특정 클라우드 연결에 대한 아웃바운드 액세스 규칙을 정의합니다.

Name	형식	Description
allowedEndpoints	ConnectionRuleEndpointMetadata[]	connectionType에 대해 명시적으로 허용된 외부 엔드포인트 목록을 정의합니다. 배열의 각 항목은 작업 영역에서 아웃바운드 통신에 허용되는 호스트 이름 패턴을 나타냅니다. 이 필드는 엔드포인트 기반 필터링(예: SQL, MySQL, 웹 등)을 지원하는 연결 형식에만 적용됩니다. 연결 형식에 대해 defaultAction을 "거부"로 설정하면 여기에 나열된 엔드포인트만 허용됩니다. 다른 모든 항목이 차단됩니다.
allowedWorkspaces	ConnectionRuleWorkspaceMetadata[]	지정된 fabric connectionType에 대한 아웃바운드 통신에 명시적으로 허용되는 작업 영역 ID 목록을 지정합니다. 이 필드는 Lakehouse, Warehouse, FabricSql 및 PowerPlatformDataflows로 제한되는 작업 영역 기반 필터링을 지원하는 패브릭 연결 형식에만 적용됩니다. 연결 형식에 대해 defaultAction을 "거부"로 설정하면 허용된Workspaces에 나열된 작업 영역만 아웃바운드 액세스에 대해 허용됩니다. 다른 모든 항목이 차단됩니다.
connectionType	string	규칙이 적용되는 클라우드 연결 유형을 지정합니다. 다른 규칙 속성(예: allowedEndpoints 또는 allowedWorkspaces)의 동작 및 적용 가능성은 연결 형식의 기능에 따라 달라질 수 있습니다.
defaultAction	ConnectionAccessActionType	connectionType에 대한 기본 아웃바운드 액세스 동작을 정의합니다. 이 필드는 allowedEndpoints 또는 allowedWorkspaces에서 추가로 구체화하지 않는 한 이 형식의 연결이 기본적으로 허용되거나 차단되는지 여부를 결정합니다. "허용"으로 설정된 경우: 보다 구체적인 규칙에 의해 명시적으로 거부되지 않는 한 이 형식의 모든 연결이 허용됩니다. 이 필드는 각 연결 형식에 대한 세분화된 제어를 제공하고 defaultAction으로 정의된 전역 대체 동작을 보완합니다.

WorkspaceOutboundConnections

Object

네트워킹 통신 정책의 일부로 작업 영역에 대해 구성된 아웃바운드 액세스 보호 클라우드 연결 규칙의 전체 집합을 나타냅니다. 이 개체는 아웃바운드 통신에 허용되거나 거부되는 외부 엔드포인트 및 작업 영역을 제어하는 연결 규칙을 정의합니다.

Name	형식	Description
defaultAction	ConnectionAccessActionType	규칙 배열에 명시적으로 나열되지 않은 모든 클라우드 연결 형식에 대한 기본 동작을 정의합니다. "허용"으로 설정하면 지정되지 않은 모든 연결 형식이 기본적으로 허용됩니다. "거부"로 설정하면 명시적으로 허용되지 않는 한 지정되지 않은 모든 연결 형식이 기본적으로 차단됩니다. 이 설정은 전역 대체 정책 역할을 하며 알려진 연결과 신뢰할 수 있는 연결만 허용되어야 하는 환경에서 보안 기본 상태를 적용하는 데 중요합니다.
rules	OutboundConnectionRule[]	특정 클라우드 연결 형식에 대한 아웃바운드 액세스 동작을 정의하는 규칙 목록입니다. 각 규칙에는 지원되는 연결 유형에 따라 엔드포인트 기반 또는 작업 영역 기반 제한이 포함될 수 있습니다.

다음을 통해 공유

Workspaces - Set Outbound Cloud Connection Rules

Permissions

필요한 위임된 범위

Microsoft Entra 지원 식별자

인터페이스

URI 매개 변수

요청 본문

응답

예제

Set workspace outbound access protection cloud connection rule for example

샘플 요청

샘플 응답

정의

ConnectionAccessActionType

ConnectionRuleEndpointMetadata

ConnectionRuleWorkspaceMetadata

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

OutboundConnectionRule

WorkspaceOutboundConnections