Requests - Update Requests Request Id

Referência

Serviço:: Symbol

Versão da API:: 7.1

Atualize uma solicitação de símbolo por identificador de solicitação.

PATCH https://artifacts.dev.azure.com/{organization}/_apis/symbol/requests/{requestId}?api-version=7.1

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
organization	path	True	string	O nome da organização do Azure DevOps.
requestId	path	True	string	O identificador de solicitação de símbolo.
api-version	query	True	string	Versão da API a ser usada. Isso deve ser definido como '7.1' para usar essa versão da api.

Corpo da solicitação

Nome	Tipo	Description
createdBy	string (uuid)	A ID do usuário que criou este item. Opcional.
createdDate	string (date-time)	A hora da data em que esse item é criado. Opcional.
description	string	Uma descrição opcional voltada para o ser humano.
domainId	IDomainId	A ID de Domínio onde esta solicitação reside. Essa propriedade não deve ser nula.
expirationDate	string (date-time)	Uma data de validade opcional para a solicitação. A solicitação ficará inacessível e será excluída após a data, independentemente de seu status. Em um HTTP POST, se a data de validade for nula/ausente, o servidor atribuirá um dado de expiração padrão (30 dias, a menos que seja substituído no registro no nível da conta). No PATCH, se a data de validade for nula/ausente, o comportamento será não alterar qualquer que seja a data de validade atual da solicitação.
id	string	Um identificador para este item. Opcional.
isChunked	boolean	Indica se a solicitação deve ser a eliminação de partes
name	string	Um nome voltado para o ser humano para a solicitação. Obrigatório em POST, ignorado no PATCH.
size	integer (int64)	O tamanho total dessa solicitação.
status	RequestStatus	O status dessa solicitação.
storageETag	string	Uma ETag opaca usada para sincronizar com a versão armazenada no final do servidor. Opcional.
url	string	Um URI que pode ser usado para recuperar esse item em seu formato bruto. Opcional. Observe que isso é diferenciado de outras URIs presentes em um recurso derivado.

Respostas

Nome	Tipo	Description
200 OK	Request	Atualizou com êxito a solicitação de símbolo, conforme especificado pelo identificador de solicitação.
404 Not Found	Request	A solicitação de símbolo, conforme especificado pelo identificador de solicitação, não foi encontrada.
Other Status Codes	Request	A solicitação de símbolo, conforme especificado pelo identificador de solicitação, não pôde ser atualizada devido a um conflito no lado do servidor, para exmple, uma etag sem correspondência.

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.symbols_write	Concede a capacidade de ler e gravar símbolos.

Exemplos

Solicitação de exemplo

HTTP

PATCH https://artifacts.dev.azure.com/fabrikam/_apis/symbol/requests/9dc380b5c295c03188108014a73574987cdef9a4edce00b01c9ec2d05fa97c37?api-version=7.1

{
  "status": "sealed"
}

Resposta de exemplo

Código de status:: 200

{
  "description": "A sample request to demonstrate the Symbol Experience",
  "expirationDate": "2015-08-16T20:14:39",
  "name": "My Sample Request",
  "status": "sealed",
  "createdBy": "00030000CA16C4DA@Live.com",
  "createdDate": "2015-07-17T20:14:39",
  "id": "9dc380b5c295c03188108014a73574987cdef9a4edce00b01c9ec2d05fa97c37",
  "storageETag": "W/\"datetime'2015-07-17T20%3A15%3A24.7522129Z'\"",
  "url": "https://artifacts.dev.azure.com/fabrikam/_apis/Symbol/requests/9dc380b5c295c03188108014a73574987cdef9a4edce00b01c9ec2d05fa97c37"
}

Definições

Nome	Description
IDomainId
Request	Solicitação de símbolo.
RequestStatus	O status dessa solicitação.

IDomainId

Objeto

Request