Changesets - Get Batched Changesets

Referenz

Dienst:: Tfvc

API-Version:: 7.1

Gibt Changesets für eine bestimmte Liste von Changeset-IDs zurück.

POST https://dev.azure.com/{organization}/_apis/tfvc/changesetsbatch?api-version=7.1

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
organization	path	True	string	Der Name der Azure DevOps-Organisation.
api-version	query	True	string	Version der zu verwendenden API. Dies sollte auf "7.1" festgelegt werden, um diese Version der API zu verwenden.

Anforderungstext

Name	Typ	Beschreibung
changesetIds	integer[] (int32)	Liste der Changeset-IDs.
commentLength	integer (int32)	Maximale Länge des Kommentars.
includeLinks	boolean	Gibt an, ob das feld "_links" in die flachen Verweise aufgenommen werden soll.

Antworten

Name	Typ	Beschreibung
200 OK	TfvcChangesetRef[]	Erfolgreicher Vorgang

Sicherheit

oauth2

Typ: oauth2
Ablauf: accessCode
Autorisierungs-URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token-URL: 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

Bereiche

Name	Beschreibung
vso.code	Gewährt die Möglichkeit, Quellcode und Metadaten zu Commits, Changesets, Verzweigungen und anderen Versionskontrollartefakten zu lesen. Gewährt außerdem die Möglichkeit, Code zu durchsuchen und über Dienst-Hooks über Versionssteuerungsereignisse benachrichtigt zu werden.

Beispiele

Returns the Tfvc changes for a given set of changes

Beispielanforderung

HTTP

POST https://dev.azure.com/{organization}/_apis/tfvc/changesetsbatch?api-version=7.1

{
  "changesetIds": [
    7,
    6
  ],
  "commentLength": 50,
  "includeLinks": true
}

Beispiel für eine Antwort

Statuscode:: 200

{
  "count": 2,
  "value": [
    {
      "changesetId": 7,
      "url": "https://codedev.ms/fabrikam/_apis/tfvc/changesets/7",
      "author": {
        "displayName": "Chuck Reinhart",
        "url": "https://vssps.codedev.ms/e/MSFT/_apis/Identities/8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d",
        "id": "8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d",
        "uniqueName": "fabrikamfiber3@hotmail.com",
        "imageUrl": "https://codedev.ms/fabrikam/_api/_common/identityImage?id=8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d"
      },
      "checkedInBy": {
        "displayName": "Chuck Reinhart",
        "url": "https://vssps.codedev.ms/e/MSFT/_apis/Identities/8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d",
        "id": "8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d",
        "uniqueName": "fabrikamfiber3@hotmail.com",
        "imageUrl": "https://codedev.ms/fabrikam/_api/_common/identityImage?id=8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d"
      },
      "createdDate": "2019-05-28T18:44:26.103Z",
      "comment": "Updated TestFile01.txt",
      "_links": {
        "self": {
          "href": "https://codedev.ms/fabrikam/_apis/tfvc/changesets/7"
        },
        "changes": {
          "href": "https://codedev.ms/fabrikam/_apis/tfvc/changesets/7/changes"
        },
        "workItems": {
          "href": "https://codedev.ms/fabrikam/_apis/tfvc/changesets/7/workItems"
        },
        "web": {
          "href": "https://codedev.ms/fabrikam/Project01/_versionControl/changeset/7"
        },
        "author": {
          "href": "https://vssps.codedev.ms/e/MSFT/_apis/Identities/8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d"
        },
        "checkedInBy": {
          "href": "https://vssps.codedev.ms/e/MSFT/_apis/Identities/8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d"
        }
      }
    },
    {
      "changesetId": 6,
      "url": "https://codedev.ms/fabrikam/_apis/tfvc/changesets/6",
      "author": {
        "displayName": "Chuck Reinhart",
        "url": "https://vssps.codedev.ms/e/MSFT/_apis/Identities/8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d",
        "id": "8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d",
        "uniqueName": "fabrikamfiber3@hotmail.com",
        "imageUrl": "https://codedev.ms/fabrikam/_api/_common/identityImage?id=8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d"
      },
      "checkedInBy": {
        "displayName": "Chuck Reinhart",
        "url": "https://vssps.codedev.ms/e/MSFT/_apis/Identities/8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d",
        "id": "8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d",
        "uniqueName": "fabrikamfiber3@hotmail.com",
        "imageUrl": "https://codedev.ms/fabrikam/_api/_common/identityImage?id=8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d"
      },
      "createdDate": "2019-05-24T17:44:05.243Z",
      "comment": "Branch ExampleFolder",
      "_links": {
        "self": {
          "href": "https://codedev.ms/fabrikam/_apis/tfvc/changesets/6"
        },
        "changes": {
          "href": "https://codedev.ms/fabrikam/_apis/tfvc/changesets/6/changes"
        },
        "workItems": {
          "href": "https://codedev.ms/fabrikam/_apis/tfvc/changesets/6/workItems"
        },
        "web": {
          "href": "https://codedev.ms/fabrikam/Project01/_versionControl/changeset/6"
        },
        "author": {
          "href": "https://vssps.codedev.ms/e/MSFT/_apis/Identities/8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d"
        },
        "checkedInBy": {
          "href": "https://vssps.codedev.ms/e/MSFT/_apis/Identities/8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d"
        }
      }
    }
  ]
}

Definitionen

Name	Beschreibung
IdentityRef
ReferenceLinks	Die Klasse, die eine Auflistung von REST-Referenzverknüpfungslinks darstellt.
TfvcChangesetRef	Metadaten für ein Changeset.
TfvcChangesetsRequestData	Anforderungstext für Get batched changesets.

IdentityRef

Objekt

Name	Typ	Beschreibung
_links	ReferenceLinks	Dieses Feld enthält null oder interessantere Links zum Thema Diagramm. Diese Links können aufgerufen werden, um zusätzliche Beziehungen oder ausführlichere Informationen zu diesem Diagrammbetreff zu erhalten.
descriptor	string	Der Deskriptor ist die primäre Möglichkeit, auf den Diagrammbetreff zu verweisen, während das System ausgeführt wird. In diesem Feld wird dasselbe Diagrammthema sowohl in Firmen als auch in Organisationen eindeutig identifiziert.
directoryAlias	string	Veraltet – Kann abgerufen werden, indem der Graph-Benutzer abgefragt wird, auf den im "Self"-Eintrag des IdentityRef -Wörterbuchs "_links" verwiesen wird
displayName	string	Dies ist der nicht eindeutige Anzeigename des Diagrammbetreffs. Um dieses Feld zu ändern, müssen Sie den Wert im Quellanbieter ändern.
id	string
imageUrl	string	Veraltet – Verfügbar im "Avatar"-Eintrag des IdentityRef-Wörterbuchs "_links"
inactive	boolean	Veraltet – Kann abgerufen werden, indem der Graph-Mitgliedschaftsstatus abgefragt wird, auf den im Eintrag "membershipState" des GraphUser-Wörterbuchs "_links" verwiesen wird.
isAadIdentity	boolean	Veraltet – Kann vom Betrefftyp des Deskriptors abgeleitet werden (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Veraltet – Kann vom Betrefftyp des Deskriptors abgeleitet werden (Descriptor.IsGroupType)
isDeletedInOrigin	boolean
profileUrl	string	Veraltet – nicht in den meisten bereits vorhandenen Implementierungen von ToIdentityRef verwendet
uniqueName	string	Veraltet – Verwenden Sie stattdessen "Domain+PrincipalName".
url	string	Diese URL ist die vollständige Route zur Quellressource dieses Graph-Betreffs.

ReferenceLinks

Objekt

Die Klasse, die eine Auflistung von REST-Referenzverknüpfungslinks darstellt.

Name	Typ	Beschreibung
links	object	Die schreibgeschützte Ansicht der Links. Da Referenzlinks schreibgeschützt sind, möchten wir sie nur als schreibgeschützt verfügbar machen.

TfvcChangesetRef

Objekt

Metadaten für ein Changeset.

Name	Typ	Beschreibung
_links	ReferenceLinks	Eine Sammlung von REST-Referenzverknüpfungslinks.
author	IdentityRef	Alias oder Anzeigename des Benutzers.
changesetId	integer (int32)	Changeset-ID.
checkedInBy	IdentityRef	Alias oder Anzeigename des Benutzers.
comment	string	Kommentieren Sie das Changeset.
commentTruncated	boolean	Wurde das Kommentarergebnis abgeschnitten?
createdDate	string (date-time)	Erstellungsdatum des Changeset.
url	string	URL zum Abrufen des Elements.

TfvcChangesetsRequestData

Objekt

Anforderungstext für Get batched changesets.

Name	Typ	Beschreibung
changesetIds	integer[] (int32)	Liste der Changeset-IDs.
commentLength	integer (int32)	Maximale Länge des Kommentars.
includeLinks	boolean	Gibt an, ob das feld "_links" in die flachen Verweise aufgenommen werden soll.

Freigeben über

Changesets - Get Batched Changesets

URI-Parameter

Anforderungstext

Antworten

Sicherheit

oauth2

Bereiche

Beispiele

Returns the Tfvc changes for a given set of changes

Beispielanforderung

Beispiel für eine Antwort

Definitionen

IdentityRef

ReferenceLinks

TfvcChangesetRef

TfvcChangesetsRequestData