다음을 통해 공유

Browser Sessions - Get

서비스:
Azure App Testing
API 버전:
2026-04-01-preview

지정된 세션과 작업 공간 ID에 대해 브라우저 세션을 설정하세요. Entra ID에서 제공하는 전달자 JWT 액세스 토큰이 필요합니다.

GET {endpoint}/playwrightworkspaces/{workspaceId}/browser-sessions/{sessionId}?api-version=2026-04-01-preview

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
endpoint
 path True

string (uri)

극작가 서비스 API 엔드포인트(프로토콜 및 호스트 이름)는 https://{region}.api.playwright.microsoft.com 형식으로 지정됩니다. 지역은 Azure Playwright 작업 영역 위치에 해당합니다. 이 값은 아래의 dataplaneUriAzure Playwright 작업 영역 속성에서 찾을 수 있습니다.
sessionId
 path True

string

minLength: 3
maxLength: 36
pattern: [A-Za-z0-9]+(-[A-Za-z0-9]+)+

브라우저 세션 ID는 GUID 형식으로 제공됩니다.
workspaceId
 path True

string

minLength: 3
maxLength: 36
pattern: [A-Za-z0-9]+(-[A-Za-z0-9]+)+

GUID 형식의 작업 영역 ID입니다.
api-version
 query True

string

minLength: 1

이 작업에 사용할 API 버전입니다.

요청 헤더

Name 필수 형식 Description
x-ms-client-request-id

string (uuid)

요청에 대한 불투명하고 전역적으로 고유한 클라이언트 생성 문자열 식별자입니다.
x-ms-useragent

string

표준 'User-Agent' 헤더를 명시적으로 설정할 수 없을 때, 예를 들어 Playwright Client를 사용할 때와 같이 추가 클라이언트 정보를 지정할 수 있는 선택적 헤더가 있습니다. 값은 표준 'User-Agent' 헤더 형식을 따라야 합니다.

응답

Name 형식 Description
200 OK

BrowserSession

요청이 성공했습니다.

헤더

x-ms-client-request-id: string
Other Status Codes

Azure.Core.Foundations.ErrorResponse

예기치 않은 오류 응답입니다.

헤더

x-ms-error-code: string

보안

OAuth2Auth

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
https://playwright.microsoft.com/.default

예제

BrowserSessions_Get

샘플 요청

GET {endpoint}/playwrightworkspaces/00000000-0000-0000-0000-000000000000/browser-sessions/00000000-0000-0000-0000-000000000000?api-version=2026-04-01-preview

샘플 응답

상태 코드:
200 
{
  "id": "00000000-0000-0000-0000-000000000000",
  "displayName": "<BrowserSession_Timestamp>",
  "creatorId": "string",
  "source": {
    "id": "00000000-0000-0000-0000-000000000000",
    "type": "PlaywrightWorkspacesTestRun"
  },
  "startTime": "2025-06-06T11:43:28.954Z",
  "endTime": "2025-06-06T11:43:28.954Z",
  "durationInMilliseconds": 0,
  "status": "Created",
  "browserType": "Chromium",
  "operatingSystem": "Windows"
}

정의

Name Description
Azure.Core.Foundations.Error

오류 개체입니다.
Azure.Core.Foundations.ErrorResponse

오류 세부 정보가 포함된 응답입니다.
Azure.Core.Foundations.InnerError

오류에 대한 보다 구체적인 정보를 포함하는 개체입니다. Azure REST API 지침에 따라 - https://aka.ms/AzureRestApiGuidelines#handling-errors.
BrowserSession

추적 목적으로 사용되는 브라우저 세션 모델.
BrowserSessionSource

브라우저 세션 소스 정보.
BrowserSessionSourceType

브라우저 세션 소스 유형입니다.
BrowserSessionStatus

브라우저 세션 상태.
BrowserType

원격 스크립트 실행을 위해 설정할 수 있는 브라우저 유형.
OS

원격 스크립트 실행을 위해 구성된 운영체제.

Azure.Core.Foundations.Error

Object

오류 개체입니다.

Name 형식 Description
code

string

서버에서 정의한 오류 코드 집합 중 하나입니다.
details

Azure.Core.Foundations.Error[]

이 보고된 오류로 이어진 특정 오류에 대한 세부 정보 배열입니다.
innererror

Azure.Core.Foundations.InnerError

오류에 대한 현재 개체보다 더 구체적인 정보를 포함하는 개체입니다.
message

string

사람이 읽을 수 있는 오류 표현입니다.
target

string

오류의 대상입니다.

Azure.Core.Foundations.ErrorResponse

Object

오류 세부 정보가 포함된 응답입니다.

Name 형식 Description
error

Azure.Core.Foundations.Error

오류 개체입니다.

Azure.Core.Foundations.InnerError

Object

오류에 대한 보다 구체적인 정보를 포함하는 개체입니다. Azure REST API 지침에 따라 - https://aka.ms/AzureRestApiGuidelines#handling-errors.

Name 형식 Description
code

string

서버에서 정의한 오류 코드 집합 중 하나입니다.
innererror

Azure.Core.Foundations.InnerError

내부 오류입니다.

BrowserSession

Object

추적 목적으로 사용되는 브라우저 세션 모델.

Name 형식 Description
browserType

BrowserType

브라우저 세션 브라우저 유형입니다.
creatorId

string

브라우저 세션 생성자의 ID입니다.
displayName

string

minLength: 1
maxLength: 200

브라우저 세션 표시 이름.
durationInMilliseconds

integer (int64)

브라우저 세션 시간은 밀리초 단위입니다.
endTime

string (date-time)

브라우저 세션 종료 시간은 UTC입니다.
id

string

minLength: 3
maxLength: 36
pattern: [A-Za-z0-9]+(-[A-Za-z0-9]+)+

브라우저 세션 ID는 GUID 형식으로 제공됩니다.
operatingSystem

OS

브라우저 세션 운영체제.
source

BrowserSessionSource

브라우저 세션 소스 정보.
startTime

string (date-time)

브라우저 세션 시작 시간은 UTC입니다.
status

BrowserSessionStatus

브라우저 세션 상태.

BrowserSessionSource

Object

브라우저 세션 소스 정보.

Name 형식 Default value Description
id

string

브라우저 세션 소스 ID는 테스트 런의 runId와 동일합니다.
type

BrowserSessionSourceType

Others

브라우저 세션 소스 유형입니다.

BrowserSessionSourceType

열거형

브라우저 세션 소스 유형입니다.

값 Description
PlaywrightWorkspacesTestRun

브라우저 세션 소스는 Playwright Workspaces 테스트 런입니다.
BrowserAutomationTool

브라우저 세션 소스는 브라우저 자동화 도구입니다.
Others

브라우저 세션 소스는 다른 유형의 것들입니다.

BrowserSessionStatus

열거형

브라우저 세션 상태.

값 Description
Created

브라우저 세션이 생성됩니다.
Active

브라우저 세션은 현재 활성 상태입니다.
Completed

브라우저 세션이 완료되었습니다.
Failed

브라우저 세션이 실패했습니다.

BrowserType

열거형

원격 스크립트 실행을 위해 설정할 수 있는 브라우저 유형.

값 Description
Chromium

크롬 브라우저 타입.
Firefox

파이어폭스 브라우저 타입.
Webkit

WebKit 브라우저 타입.

OS

열거형

원격 스크립트 실행을 위해 구성된 운영체제.

값 Description
Linux

Linux 운영 체제.
Windows

Windows 운영 체제.