REST Resource: projects.histories.executions.steps

{
  "stepId": string,
  "creationTime": {
    object (Timestamp)
  },
  "completionTime": {
    object (Timestamp)
  },
  "name": string,
  "description": string,
  "state": enum (State),
  "outcome": {
    object (Outcome)
  },
  "hasImages": boolean,
  "labels": {
    string: string,
    ...
  },
  "dimensionValue": {
    string: string,
    ...
  },
  "runDuration": {
    object (Duration)
  },
  "deviceUsageDuration": {
    object (Duration)
  },
  "multiStep": {
    object (MultiStep)
  },

  // Union field step can be only one of the following:
  "testExecutionStep": {
    object (TestExecutionStep)
  },
  "toolExecutionStep": {
    object (ToolExecutionStep)
  }
  // End of list of possible types for union field step.
}

string

이 단계에 대한 실행 내의 고유 식별자입니다.

호출자가 이 필드를 설정하거나 덮어쓴 경우 INVALID_ARGUMENT를 반환합니다.

• 응답: 항상 설정됨
• 생성/업데이트 요청 시: 설정하지 않음

object ( Timestamp )

단계가 생성된 시간입니다.

• 응답: 항상 설정됨
• 생성/업데이트 요청 시: 설정하지 않음

object ( Timestamp )

단계 상태가 완료로 설정된 시간입니다.

이 값은 상태가 COMPLETE로 전환될 때 자동으로 설정됩니다.

• 응답: 실행 상태가 COMPLETE인 경우 설정됩니다.
• 생성/업데이트 요청 시: 설정하지 않음

string

UI에 표시할 사람이 읽을 수 있는 짧은 이름입니다. 최대 100자입니다. 예: 클린 빌드

기존 단계와 이름 및 차원 값을 공유하는 경우 새 단계를 생성할 때 PRECONDITION_FAILED가 반환됩니다. 두 단계가 유사한 작업을 나타내지만 차원 값이 다른 경우 동일한 이름을 공유해야 합니다. 예를 들어 동일한 테스트 세트가 서로 다른 두 플랫폼에서 실행되는 경우 두 단계의 이름은 동일해야 합니다.

• 응답: 항상 설정됨
• 생성 요청 시: 항상 설정됨
• 업데이트 요청 시: 설정되지 않음

string

이 도구에 대한 설명 예: mvn clean package -D SkipTests=true

• 응답: 생성/업데이트 요청에 의해 설정된 경우 존재합니다.
• 생성/업데이트 요청 시: 선택 사항

enum ( State )

초기 상태는 IN_PROGRESS입니다. 유일한 합법적인 상태 전환은 * IN_PROGRESS -> COMPLETE입니다.

잘못된 전환이 요청되면 PRECONDITION_FAILED가 반환됩니다.

상태가 COMPLETE로 설정된 단계를 생성하는 것은 유효합니다. 상태는 한 번만 COMPLETE로 설정할 수 있습니다. 상태가 COMPLETE로 여러 번 설정된 경우 PRECONDITION_FAILED가 반환됩니다.

• 응답: 항상 설정됨
• 생성/업데이트 요청 시: 선택 사항

object ( Outcome )

결과 분류(예: SUCCESS 또는 FAILURE)

• 응답: 생성/업데이트 요청에 의해 설정된 경우 존재합니다.
• 생성/업데이트 요청 시: 선택 사항

boolean

이 단계의 출력이 Thumbnails.list를 사용하여 썸네일을 가져올 수 있는 이미지인지 여부입니다.

• 응답: 항상 설정됨
• 생성/업데이트 요청 시: 설정하지 않음

map (key: string, value: string)

단계와 연관된 임의의 사용자 제공 키/값 쌍입니다.

사용자는 키가 실수로 충돌하지 않도록 키 네임스페이스를 관리할 책임이 있습니다.

라벨 수가 100개를 초과하거나 키 또는 값의 길이가 100자를 초과하는 경우 INVALID_ARGUMENT가 반환됩니다.

• 응답: 항상 설정됨
• 생성 요청 시: 선택 사항
• 업데이트 요청 시: 선택 사항; 새로운 키/값 쌍이 맵에 추가되고 기존 키에 대한 새로운 값이 해당 키의 값을 업데이트합니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

map (key: string, value: string)

이 단계를 포함하는 실행에 차원 정의가 설정된 경우 이 필드를 통해 하위 항목이 차원 값을 지정할 수 있습니다.

키는 실행의 차원 정의와 정확히 일치해야 합니다.

예를 들어 실행 dimension_definition = ['attempt', 'device'] 있는 경우 단계에서는 해당 차원에 대한 값을 정의해야 합니다. dimensionValue = ['attempt': '1', 'device': 'Nexus 6']

단계가 행렬의 한 차원에 참여하지 않는 경우 해당 차원의 값은 빈 문자열이어야 합니다. 예를 들어 재시도를 지원하지 않는 실행기에 의해 테스트 중 하나가 실행되는 경우 해당 단계 dimensionValue = ['attempt': '', 'device': 'Nexus 6'] 있을 수 있습니다.

단계가 행렬의 차원에 참여하지 않는 경우 차원 값이 설정되지 않은 상태로 남아 있을 수 있습니다.

실행의 차원 정의에 키가 없으면 PRECONDITION_FAILED가 반환됩니다.

이 실행의 다른 단계에 이미 동일한 이름과 차원 값이 있지만 다른 데이터 필드가 다른 경우(예: 단계 필드가 다른 경우) PRECONDITION_FAILED가 반환됩니다.

차원 값이 설정되어 있고 실행 시 키 중 하나로 지정되지 않은 차원 정의가 있는 경우 PRECONDITION_FAILED가 반환됩니다.

• 응답: create로 설정된 경우 존재합니다.
• 생성 요청 시: 선택 사항
• 업데이트 요청 시: 설정되지 않음

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

object ( Duration )

이 단계를 실행하는 데 걸린 시간입니다.

설정되지 않은 경우 단계가 COMPLETE 상태로 설정될 때 CreationTime과 CompletionTime의 차이로 설정됩니다. 어떤 경우에는 이 값을 별도로 설정하는 것이 적절합니다. 예를 들어 단계가 생성되었지만 해당 작업이 실행되기 전에 몇 분 동안 대기열에 있는 경우 해당 단계에 대기열에 있는 데 소요된 시간을 포함하지 않는 것이 적절할 것입니다. runDuration.

이 필드가 이미 설정된 단계에서 runDuration을 설정하려고 하면 PRECONDITION_FAILED가 반환됩니다.

• 응답: 이전에 설정된 경우 존재합니다. COMPLETE 단계에 항상 존재
• 생성 요청 시: 선택 사항
• 업데이트 요청 시: 선택 사항

object ( Duration )

테스트를 수행하는 데 사용되는 장치 리소스의 양입니다.

이는 청구 목적으로 사용되는 장치 사용량으로, runDuration과 다릅니다. 예를 들어 인프라 오류에는 장치 사용량에 대한 비용이 청구되지 않습니다.

이 필드가 이미 설정된 단계에서 device_usage를 설정하려고 하면 PRECONDITION_FAILED가 반환됩니다.

• 응답: 이전에 설정된 경우 존재합니다.
• 생성 요청 시: 선택 사항
• 업데이트 요청 시: 선택 사항

object ( MultiStep )

여러 단계가 그룹과 동일한 구성으로 실행되는 경우의 세부정보입니다. 이러한 세부 정보를 사용하여 이 단계가 속한 그룹을 식별할 수 있습니다. 또한 모든 그룹 구성원을 색인화하는 그룹 '기본 단계'를 식별합니다.

• 응답: 이전에 설정된 경우 존재합니다.
• 생성 요청: 선택 사항에서 이 단계가 두 번 이상 수행된 경우 설정합니다.
• 업데이트 요청 시: 선택 사항

object ( TestExecutionStep )

테스트 실행기 실행

object ( ToolExecutionStep )

도구 실행(명시적으로 지원하지 않는 단계에 사용됨)

{
  "testSuiteOverviews": [
    {
      object (TestSuiteOverview)
    }
  ],
  "toolExecution": {
    object (ToolExecution)
  },
  "testIssues": [
    {
      object (TestIssue)
    }
  ],
  "testTiming": {
    object (TestTiming)
  }
}

object ( TestSuiteOverview )

테스트 스위트 개요 내용 목록입니다. 이는 서버별로 xUnit XML 로그에서 구문 분석하거나 사용자가 직접 업로드할 수 있습니다. 이 참조는 테스트 도구 모음이 완전히 구문 분석되거나 업로드된 경우에만 호출되어야 합니다.

단계당 허용되는 최대 테스트 모음 개요 수는 1000개입니다.

• 응답: 항상 설정됨
• 생성 요청 시: 선택 사항
• 업데이트 요청 시: 절대 사용하지 않음(대신 게시XunitXmlFiles 사용자 정의 메소드 사용)

object ( ToolExecution )

테스트 실행기의 실행을 나타냅니다.

이 도구의 종료 코드는 테스트 통과 여부를 결정하는 데 사용됩니다.

• 응답: 항상 설정됨
• 생성/업데이트 요청 시: 선택 사항

object ( TestIssue )

테스트 실행 중에 관찰된 문제입니다.

예를 들어, 테스트 중에 테스트 중인 모바일 앱이 충돌한 경우 오류 메시지와 스택 추적 내용을 여기에 기록하여 디버깅을 지원할 수 있습니다.

• 응답: 생성 또는 업데이트로 설정된 경우 존재합니다.
• 생성/업데이트 요청 시: 선택 사항

object ( TestTiming )

테스트 실행의 타이밍 분석입니다.

• 응답: 생성 또는 업데이트로 설정된 경우 존재합니다.
• 생성/업데이트 요청 시: 선택 사항

{
  "commandLineArguments": [
    string
  ],
  "toolLogs": [
    {
      object (FileReference)
    }
  ],
  "exitCode": {
    object (ToolExitCode)
  },
  "toolOutputs": [
    {
      object (ToolOutputReference)
    }
  ]
}

string

프로그램 이름(C 프로그램의 argv와 동일)을 포함하는 전체 토큰화된 명령줄입니다.

• 응답: 생성 요청에 의해 설정된 경우 존재합니다.
• 생성 요청 시: 선택 사항
• 업데이트 요청 시: 설정되지 않음

object ( FileReference )

일반 텍스트 로그에 대한 참조는 도구 실행을 출력합니다.

도구가 실행되는 동안 로그의 실시간 보기에 액세스할 수 있도록 도구가 종료되기 전에 이 필드를 설정할 수 있습니다.

단계당 허용되는 최대 도구 로그 수는 1000개입니다.

• 응답: 생성/업데이트 요청에 의해 설정된 경우 존재합니다.
• 생성 요청 시: 선택 사항
• 업데이트 요청: 선택사항, 제공된 모든 값은 기존 목록에 추가됩니다.

object ( ToolExitCode )

도구 실행 종료 코드입니다. 이 필드는 도구가 종료되면 설정됩니다.

• 응답: 생성/업데이트 요청에 의해 설정된 경우 존재합니다.
• 생성 요청 시: 선택 사항
• 업데이트 요청: 선택 사항에서, 종료 코드가 이미 설정된 경우 FAILED_PRECONDITION 오류가 반환됩니다.

object ( ToolOutputReference )

도구 실행으로 출력되는 모든 형식의 불투명 파일에 대한 참조입니다.

단계당 허용되는 최대 도구 출력 수는 1000입니다.

• 응답: 생성/업데이트 요청에 의해 설정된 경우 존재합니다.
• 생성 요청 시: 선택 사항
• 업데이트 요청: 선택사항, 제공된 모든 값은 기존 목록에 추가됩니다.

{
  "number": integer
}

integer

도구 실행 종료 코드입니다. 값이 0이면 실행이 성공했음을 의미합니다.

• 응답: 항상 설정됨
• 생성/업데이트 요청 시: 항상 설정됨

{
  "errorMessage": string,
  "stackTrace": {
    object (StackTrace)
  },
  "warning": {
    object (Any)
  },
  "severity": enum (Severity),
  "type": enum (Type),
  "category": enum (Category)
}

string

문제를 설명하는 사람이 읽을 수 있는 간단한 메시지입니다. 필수의.

object ( StackTrace )

특정 경고 내의 스택 추적 필드를 위해 더 이상 사용되지 않습니다.

object ( Any )

문제에 대한 추가 세부정보가 포함된 경고 메시지입니다. 항상 com.google.devtools.toolresults.v1.warnings의 메시지여야 합니다.

enum ( Severity )

문제의 심각도. 필수의.

enum ( Type )

문제 유형. 필수의.

enum ( Category )

문제 카테고리. 필수의.

{
  "typeUrl": string,
  "value": string
}

string

직렬화된 프로토콜 버퍼 메시지의 유형을 고유하게 식별하는 URL/리소스 이름입니다. 이 문자열에는 "/" 문자가 하나 이상 포함되어야 합니다. URL 경로의 마지막 세그먼트는 유형의 정규화된 이름을 나타내야 합니다( path/google.protobuf.Duration 에서처럼). 이름은 표준 형식이어야 합니다(예: "."으로 시작하는 것은 허용되지 않음).

실제로 팀은 일반적으로 Any의 컨텍스트에서 사용할 것으로 예상되는 모든 유형을 바이너리로 미리 컴파일합니다. 그러나 http , https 체계를 사용하거나 체계 없음을 사용하는 URL의 경우 선택적으로 다음과 같이 유형 URL을 메시지 정의에 매핑하는 유형 서버를 설정할 수 있습니다.

• 구성표가 제공되지 않으면 https 로 간주됩니다.
• URL의 HTTP GET은 바이너리 형식의 google.protobuf.Type 값을 생성하거나 오류를 생성해야 합니다.
• 애플리케이션은 URL을 기반으로 조회 결과를 캐시하거나 조회를 피하기 위해 바이너리로 미리 컴파일할 수 있습니다. 따라서 유형 변경 시 바이너리 호환성이 유지되어야 합니다. (버전이 지정된 유형 이름을 사용하여 주요 변경 사항을 관리하세요.)

참고: 이 기능은 현재 공식 protobuf 릴리스에서는 사용할 수 없으며 type.googleapis.com으로 시작하는 유형 URL에는 사용되지 않습니다.

http , https 이외의 체계(또는 빈 체계)는 구현별 의미 체계와 함께 사용될 수 있습니다.

string ( bytes format)

위에 지정된 유형의 유효한 직렬화된 프로토콜 버퍼여야 합니다.

base64로 인코딩된 문자열입니다.

{
  "testProcessDuration": {
    object (Duration)
  }
}

object ( Duration )

테스트 프로세스를 실행하는 데 걸린 시간입니다.

• 응답: 이전에 설정된 경우 존재합니다.
• 생성/업데이트 요청 시: 선택 사항

{
  "toolExecution": {
    object (ToolExecution)
  }
}

object ( ToolExecution )

도구 실행.

• 응답: 생성/업데이트 요청에 의해 설정된 경우 존재합니다.
• 생성/업데이트 요청 시: 선택 사항

{
  "primaryStepId": string,
  "multistepNumber": integer,
  "primaryStep": {
    object (PrimaryStep)
  }
}

string

이 단계일 수 있는 기본(원래) 단계의 단계 ID입니다.

integer

각 단계에 고유한 int가 제공됩니다. 범위는 0(포함)부터 총 단계 수(제외)까지입니다. 기본 단계는 0입니다.

object ( PrimaryStep )

기본(원래) 단계인 경우 표시됩니다.

{
  "rollUp": enum (OutcomeSummary),
  "individualOutcome": [
    {
      object (IndividualOutcome)
    }
  ]
}

enum ( OutcomeSummary )

그룹과 동일한 구성으로 실행된 여러 단계의 롤업 테스트 상태입니다.

object ( IndividualOutcome )

각 개별 단계의 단계 ID 및 결과입니다.

{
  "stepId": string,
  "outcomeSummary": enum (OutcomeSummary),
  "multistepNumber": integer,
  "runDuration": {
    object (Duration)
  }
}

string

enum ( OutcomeSummary )

integer

각 단계에 고유한 int가 제공됩니다. 범위는 0(포함)부터 총 단계 수(제외)까지입니다. 기본 단계는 0입니다.

object ( Duration )

이 단계를 실행하는 데 걸린 시간입니다.