Test Plan Recycle Bin - List

Referência

Serviço:: Test Plan

Versão da API:: 7.2-preview.1

Obter uma lista de planos de teste excluídos

GET https://dev.azure.com/{organization}/{project}/_apis/testplan/recycleBin/testplan?api-version=7.2-preview.1

Com parâmetros opcionais:

GET https://dev.azure.com/{organization}/{project}/_apis/testplan/recycleBin/testplan?continuationToken={continuationToken}&api-version=7.2-preview.1

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
organization	path	True	string	O nome da organização do Azure DevOps.
project	path	True	string	ID do projeto ou nome do projeto
api-version	query	True	string	Versão da API a ser usada. Isso deve ser definido como '7.2-preview.1' para usar essa versão da api.
continuationToken	query		string	Se a lista de planos retornados não estiver concluída, um token de continuação para consultar o próximo lote de planos será incluído no cabeçalho de resposta como "x-ms-continuationtoken". Omita esse parâmetro para obter o primeiro lote de planos de teste.

Respostas

Nome	Tipo	Description
200 OK	TestPlan[]	operação bem-sucedida

Segurança

oauth2

Tipo: oauth2
Flow: accessCode
URL de Autorização: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL do Token: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Escopos

Nome	Description
vso.test	Concede a capacidade de ler planos de teste, casos, resultados e outros artefatos relacionados ao gerenciamento de testes.

Exemplos

Get Deleted Test Plans

Solicitação de exemplo

HTTP

GET https://dev.azure.com/fabrikam/{project}/_apis/testplan/recycleBin/testplan?api-version=7.2-preview.1

Resposta de exemplo

Código de status:: 200

transfer-Encoding: chunked

{
  "value": [
    {
      "id": 5,
      "project": {
        "id": "afb62ab2-bd74-41c2-991e-40bbb9c8ca91",
        "name": "sampleProject",
        "state": "unchanged",
        "visibility": "unchanged",
        "lastUpdateTime": "0001-01-01T00:00:00"
      },
      "updatedDate": "2024-08-14T13:27:55.213Z",
      "updatedBy": {
        "displayName": "Fabrikam Fiber",
        "url": "https://dev.azure.com/A81dd05d6-1ccc-41b7-8c1c-d69d153ecc49/_apis/Identities/9c694866-b1b9-6531-98e8-7a05990c5154",
        "_links": {
          "avatar": {
            "href": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0"
          }
        },
        "id": "9c694866-b1b9-6531-98e8-7a05990c5154",
        "uniqueName": "fabrikamfiber1@microsoft.com",
        "imageUrl": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0",
        "descriptor": "msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0"
      },
      "rootSuite": {
        "id": 6,
        "name": "Plan 1"
      },
      "_links": {
        "_self": {
          "href": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/5"
        },
        "clientUrl": {
          "href": "mtms://fabrikam.visualstudio.com:443/p:sampleProject/Testing/testplan/connect?id=5"
        },
        "rootSuite": {
          "href": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/5/Suites/6"
        },
        "build": {
          "href": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/build/Builds/3"
        }
      },
      "revision": 0,
      "name": "Plan 1",
      "areaPath": "sampleProject\\Team1",
      "startDate": "2024-08-14T13:01:38.143Z",
      "endDate": "2024-08-21T13:01:38.143Z",
      "iteration": "p1",
      "owner": {
        "displayName": "Fabrikam Fiber",
        "url": "https://dev.azure.com/A81dd05d6-1ccc-41b7-8c1c-d69d153ecc49/_apis/Identities/9c694866-b1b9-6531-98e8-7a05990c5154",
        "_links": {
          "avatar": {
            "href": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0"
          }
        },
        "id": "9c694866-b1b9-6531-98e8-7a05990c5154",
        "uniqueName": "fabrikamfiber1@microsoft.com",
        "imageUrl": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0",
        "descriptor": "msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0"
      },
      "state": "Active",
      "testOutcomeSettings": {
        "syncOutcomeAcrossSuites": false
      }
    },
    {
      "id": 9,
      "project": {
        "id": "afb62ab2-bd74-41c2-991e-40bbb9c8ca91",
        "name": "sampleProject",
        "state": "unchanged",
        "visibility": "unchanged",
        "lastUpdateTime": "0001-01-01T00:00:00"
      },
      "updatedDate": "2024-08-14T13:27:55.213Z",
      "updatedBy": {
        "displayName": "Fabrikam Fiber",
        "url": "https://dev.azure.com/A81dd05d6-1ccc-41b7-8c1c-d69d153ecc49/_apis/Identities/9c694866-b1b9-6531-98e8-7a05990c5154",
        "_links": {
          "avatar": {
            "href": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0"
          }
        },
        "id": "9c694866-b1b9-6531-98e8-7a05990c5154",
        "uniqueName": "fabrikamfiber1@microsoft.com",
        "imageUrl": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0",
        "descriptor": "msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0"
      },
      "rootSuite": {
        "id": 10,
        "name": "Plan 2"
      },
      "_links": {
        "_self": {
          "href": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/9"
        },
        "clientUrl": {
          "href": "mtms://fabrikam.visualstudio.com:443/p:sampleProject/Testing/testplan/connect?id=9"
        },
        "rootSuite": {
          "href": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/9/Suites/10"
        },
        "build": {
          "href": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/build/Builds/3"
        }
      },
      "revision": 0,
      "name": "Plan 2",
      "areaPath": "sampleProject\\Team1",
      "startDate": "2024-08-14T13:01:38.143Z",
      "endDate": "2024-08-21T13:01:38.143Z",
      "iteration": "p1",
      "owner": {
        "displayName": "Fabrikam Fiber",
        "url": "https://dev.azure.com/A81dd05d6-1ccc-41b7-8c1c-d69d153ecc49/_apis/Identities/9c694866-b1b9-6531-98e8-7a05990c5154",
        "_links": {
          "avatar": {
            "href": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0"
          }
        },
        "id": "9c694866-b1b9-6531-98e8-7a05990c5154",
        "uniqueName": "fabrikamfiber1@microsoft.com",
        "imageUrl": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0",
        "descriptor": "msa.OWM2OTQ4NjYtYjFiOS03NTMxLTk4ZTgtN2EwNTk5MGM1MTU0"
      },
      "state": "Active",
      "testOutcomeSettings": {
        "syncOutcomeAcrossSuites": false
      }
    }
  ],
  "count": 2
}

Definições

Nome	Description
BuildDefinitionReference	O recurso de referência de definição de build
IdentityRef
ProjectState	Estado do projeto.
ProjectVisibility	Visibilidade do projeto.
ReferenceLinks	A classe para representar uma coleção de links de referência REST.
ReleaseEnvironmentDefinitionReference	Referência ao recurso de ambiente de lançamento.
TeamProjectReference	Representa uma referência superficial a um TeamProject.
TestOutcomeSettings	Configurações de resultado do teste
TestPlan	O recurso de plano de teste.
TestSuiteReference	O recurso de referência do conjunto de testes.
YamlReleaseReference	Referência ao recurso de versão yaml.

BuildDefinitionReference

Objeto

O recurso de referência de definição de build

Nome	Tipo	Description
id	integer (int32)	ID da definição de build
name	string	Nome da definição de build

IdentityRef

Objeto

Nome	Tipo	Description
_links	ReferenceLinks	Este campo contém zero ou mais links interessantes sobre o assunto do grafo. Esses links podem ser invocados para obter relações adicionais ou informações mais detalhadas sobre esse assunto do grafo.
descriptor	string	O descritor é a principal maneira de referenciar o assunto do grafo enquanto o sistema está em execução. Esse campo identificará exclusivamente o mesmo assunto de grafo em contas e organizações.
directoryAlias	string	Preterido – pode ser recuperado consultando o usuário do Graph referenciado na entrada "self" do dicionário "_links" identityRef
displayName	string	Esse é o nome de exibição não exclusivo do assunto do grafo. Para alterar esse campo, você deve alterar seu valor no provedor de origem.
id	string
imageUrl	string	Preterido – Disponível na entrada "avatar" do dicionário "_links" do IdentityRef
inactive	boolean	Preterido – pode ser recuperado consultando o estado de associação do Graph referenciado na entrada "membershipState" do dicionário "_links" do GraphUser
isAadIdentity	boolean	Preterido – pode ser adiado do tipo de assunto do descritor (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Preterido – pode ser inferido do tipo de assunto do descritor (Descriptor.IsGroupType)
isDeletedInOrigin	boolean
profileUrl	string	Preterido - não em uso na maioria das implementações pré-existentes de ToIdentityRef
uniqueName	string	Preterido – use Domain+PrincipalName em vez disso
url	string	Essa URL é a rota completa para o recurso de origem desta entidade de grafo.

ProjectState

Enumeração

Estado do projeto.

Valor	Description
all	Todos os projetos, independentemente do estado, exceto Excluídos.
createPending	O projeto foi enfileirado para criação, mas o processo ainda não foi iniciado.
deleted	O projeto foi excluído.
deleting	O Project está em processo de exclusão.
new	O Project está em processo de criação.
unchanged	O projeto não foi alterado.
wellFormed	O Project é completamente criado e pronto para uso.

ProjectVisibility

Enumeração

Visibilidade do projeto.

Valor	Description
private	O projeto só é visível para usuários com acesso explícito.
public	O projeto é visível para todos.

ReferenceLinks

Objeto

A classe para representar uma coleção de links de referência REST.

Nome	Tipo	Description
links	object	A exibição somente leitura dos links. Como os links de referência são somente leitura, só queremos expô-los como somente leitura.

ReleaseEnvironmentDefinitionReference

Objeto

Referência ao recurso de ambiente de lançamento.

Nome	Tipo	Description
definitionId	integer (int32)	ID da definição de versão que contém a definição de ambiente de versão.
environmentDefinitionId	integer (int32)	ID da definição do ambiente de versão.

TeamProjectReference

Objeto

Representa uma referência superficial a um TeamProject.

Nome	Tipo	Description
abbreviation	string	Abreviação do projeto.
defaultTeamImageUrl	string	Url para imagem de identidade de equipe padrão.
description	string	A descrição do projeto (se houver).
id	string (uuid)	Identificador de projeto.
lastUpdateTime	string (date-time)	Hora da última atualização do projeto.
name	string	Nome do projeto.
revision	integer (int64)	Revisão do projeto.
state	ProjectState	Estado do projeto.
url	string	Url para a versão completa do objeto.
visibility	ProjectVisibility	Visibilidade do projeto.

TestOutcomeSettings

Objeto

Configurações de resultado do teste

Nome	Tipo	Description
syncOutcomeAcrossSuites	boolean	Valor para configurar como os resultados do teste para os mesmos testes entre conjuntos são mostrados

TestPlan

Objeto

O recurso de plano de teste.

Nome	Tipo	Description
_links	ReferenceLinks	Links relevantes
areaPath	string	Área do plano de teste.
buildDefinition	BuildDefinitionReference	A Definição de Build que gera um build associado a este plano de teste.
buildId	integer (int32)	Compilação a ser testada.
description	string	Descrição do plano de teste.
endDate	string (date-time)	Data de término do plano de teste.
id	integer (int32)	ID do plano de teste.
iteration	string	Caminho de iteração do plano de teste.
name	string	Nome do plano de teste.
owner	IdentityRef	Proprietário do plano de teste.
previousBuildId	integer (int32)	ID de build anterior associada ao plano de teste
project	TeamProjectReference	Projeto que contém o plano de teste.
releaseEnvironmentDefinition	ReleaseEnvironmentDefinitionReference	Ambiente de versão a ser usado para implantar o build e executar testes automatizados desse plano de teste.
revision	integer (int32)	Revisão do plano de teste.
rootSuite	TestSuiteReference	Conjunto de testes raiz do plano de teste.
startDate	string (date-time)	Data de início do plano de teste.
state	string	Estado do plano de teste.
testOutcomeSettings	TestOutcomeSettings	Valor para configurar como os mesmos testes em conjuntos de testes em um plano de teste precisam se comportar
updatedBy	IdentityRef	Referência de identidade para a última atualização do plano de teste
updatedDate	string (date-time)	Data atualizada do plano de teste
yamlReleaseReference	YamlReleaseReference	A Referência de Versão do Yaml associada a este plano de teste.

TestSuiteReference

Objeto

O recurso de referência do conjunto de testes.

Nome	Tipo	Description
id	integer (int32)	ID do conjunto de testes.
name	string	Nome do conjunto de testes.

YamlReleaseReference

Objeto

Referência ao recurso de versão yaml.

Nome	Tipo	Description
definitionId	integer (int32)	ID da definição de versão do yaml
stagesToSkip	string	Estágios a serem ignoradas durante a enfileiramento da versão yaml.

Partilhar via

Test Plan Recycle Bin - List

Parâmetros de URI

Respostas

Segurança

oauth2

Escopos

Exemplos

Get Deleted Test Plans

Solicitação de exemplo

Resposta de exemplo

Definições

BuildDefinitionReference

IdentityRef

ProjectState

ProjectVisibility

ReferenceLinks

ReleaseEnvironmentDefinitionReference

TeamProjectReference

TestOutcomeSettings

TestPlan

TestSuiteReference

YamlReleaseReference