Accounts - List

Service:

Accounts

API Version:

6.0

Ottenere un elenco di account per un proprietario specifico o un membro specifico. È necessario uno dei parametri seguenti: ownerId, memberId.

GET https://app.vssps.visualstudio.com/_apis/accounts?api-version=6.0

With optional parameters:

GET https://app.vssps.visualstudio.com/_apis/accounts?ownerId={ownerId}&memberId={memberId}&properties={properties}&api-version=6.0

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
api-version	query	True	string	Versione dell'API da usare. Deve essere impostato su '6.0' per usare questa versione dell'API.
memberId	query		string uuid	ID per un membro degli account.
ownerId	query		string uuid	ID per il proprietario degli account.
properties	query		string

Risposte

Nome	Tipo	Descrizione
200 OK	Account[]	operazione riuscita

Sicurezza

oauth2

Type: oauth2
Flow: accessCode
Authorization 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

Scopes

Nome	Descrizione
vso.profile	Concede la possibilità di leggere il profilo, gli account, le raccolte, i progetti, i team e altri artefatti dell'organizzazione di primo livello.

Esempio

By member

By owner

By member

Sample Request

HTTP

GET https://app.vssps.visualstudio.com/_apis/accounts?memberId=d6245f20-2af8-44f4-9451-8107cb2767db&api-version=6.0

Sample Response

Status code:

200

{
  "count": 2,
  "value": [
    {
      "accountId": "6affcbef-fe5d-44c6-8a29-439b79aaa118",
      "accountUri": "https://vssps.dev.azure.com/Fabrikam-Fiber-Inc/",
      "accountName": "Fabrikam-Fiber-Inc",
      "properties": {}
    },
    {
      "accountId": "bf83696f-383b-4980-95b5-1f1127640a8a",
      "accountUri": "https://vssps.dev.azure.com/NormalPaulk/",
      "accountName": "NormalPaulk",
      "properties": {}
    }
  ]
}

By owner

Sample Request

HTTP

GET https://app.vssps.visualstudio.com/_apis/accounts?ownerId=d6245f20-2af8-44f4-9451-8107cb2767db&api-version=6.0

Sample Response

Status code:

200

{
  "count": 1,
  "value": [
    {
      "accountId": "bf83696f-383b-4980-95b5-1f1127640a8a",
      "accountUri": "https://NormalPaulk.vssps.visualstudio.com:443/",
      "accountName": "NormalPaulk",
      "properties": {}
    }
  ]
}

Definizioni

Nome	Descrizione
Account
AccountStatus	Stato dell'account corrente
AccountType	Tipo di account: Personale, Organizzazione
PropertiesCollection	La classe rappresenta un contenitore di proprietà come raccolta di coppie chiave-valore. I valori di tutti i tipi primitivi (qualsiasi tipo con un TypeCode != TypeCode.Object) ad eccezione DBNull di vengono accettati. I valori di tipo Byte[], Int32, Double, DateType e String mantengono il tipo, le altre primitive vengono riattivate come String. Byte[] previsto come stringa con codifica Base64.

Account

Nome	Tipo	Descrizione
accountId	string	Identificatore per un account
accountName	string	Nome di un account
accountOwner	string	Proprietario dell'account
accountStatus	AccountStatus	Stato dell'account corrente
accountType	AccountType	Tipo di account: Personale, Organizzazione
accountUri	string	URI per un account
createdBy	string	Chi ha creato l'account
createdDate	string	Data di creazione dell'account
hasMoved	boolean
lastUpdatedBy	string	Identità dell'ultima persona per aggiornare l'account
lastUpdatedDate	string	Data dell'ultimo aggiornamento dell'account
namespaceId	string	Spazio dei nomi per un account
newCollectionId	string
organizationName	string	Organizzazione che ha creato l'account
properties	PropertiesCollection	Proprietà estese
statusReason	string	Motivo dello stato corrente

AccountStatus

Stato dell'account corrente

Nome	Tipo	Descrizione
deleted	string	Questo account fa parte del batch di eliminazione e pianificato per l'eliminazione.
disabled	string	Questo account di hosting è disabilitato.
enabled	string	Questo account di hosting è attivo e assegnato a un cliente.
moved	string	Questo account non viene masterato in locale e viene spostato fisicamente.
none	string

AccountType

Tipo di account: Personale, Organizzazione

Nome	Tipo	Descrizione
organization	string
personal	string

PropertiesCollection

La classe rappresenta un contenitore di proprietà come raccolta di coppie chiave-valore. I valori di tutti i tipi primitivi (qualsiasi tipo con un TypeCode != TypeCode.Object) ad eccezione DBNull di vengono accettati. I valori di tipo Byte[], Int32, Double, DateType e String mantengono il tipo, le altre primitive vengono riattivate come String. Byte[] previsto come stringa con codifica Base64.

Nome	Tipo	Descrizione
count	integer	Conteggio delle proprietà nell'insieme.
item	object
keys	string[]	Set di chiavi nell'insieme.
values	string[]	Set di valori nell'insieme.