Pats - Create

Service:

Tokens

API Version:

7.1-preview.1

為要求的使用者建立新的個人存取權杖 (PAT) 。

POST https://vssps.dev.azure.com/{organization}/_apis/tokens/pats?api-version=7.1-preview.1

URI 參數

名稱	位於	必要	類型	Description
organization	path	True	string	Azure DevOps 組織的名稱。
api-version	query	True	string	要使用的 API 版本。 這應該設定為 '7.1-preview.1' 以使用此版本的 API。

要求本文

名稱	類型	Description
allOrgs	boolean	True 是表示 如果此個人存取權杖 (PAT) 適用于所有使用者的可存取組織。 False，否則為 (例如，如果權杖適用于特定組織)
displayName	string	權杖名稱
scope	string	用來存取 Azure DevOps 資源的權杖範圍
validTo	string	權杖到期日

回應

名稱	類型	Description
200 OK	PatTokenResult	成功的作業

安全性

accessToken

個人存取權杖。 針對使用者名稱和權杖使用任何值作為密碼。

Type: basic

範例

Create a new personal access token

Sample Request

HTTP

POST https://vssps.dev.azure.com/{organization}/_apis/tokens/pats?api-version=7.1-preview.1

{
  "displayName": "new_token",
  "scope": "app_token",
  "validTo": "2020-12-01T23:46:23.319Z",
  "allOrgs": false
}

Sample Response

Status code:

200

{
  "patToken": {
    "displayName": "new_token",
    "validTo": "2020-12-01T23:46:23.32Z",
    "scope": "app_token",
    "targetAccounts": [
      "38aaa865-2c70-4bf7-a308-0c6539c38c1a"
    ],
    "validFrom": "2020-11-02T22:56:52.1033333Z",
    "authorizationId": "4ab5764f-4193-4f1d-b995-64144880b7d7",
    "token": "dip55dwf4vpitomw63jzvomefmi2jluguprzwwqwuc6xq4fhocwq"
  },
  "patTokenError": "none"
}

定義

名稱	Description
PatToken	代表用於存取 Azure DevOps 資源的個人存取權杖 (PAT)
PatTokenCreateRequest	封裝建立新個人存取權杖的要求參數， (PAT)
PatTokenResult	包含產生的個人存取權杖 (PAT) ，如果作業期間發生任何) ，則為錯誤 (
SessionTokenError	如果發生任何) ，就會 (錯誤

PatToken

代表用於存取 Azure DevOps 資源的個人存取權杖 (PAT)

名稱	類型	Description
authorizationId	string	唯一 GUID 識別碼
displayName	string	權杖名稱
scope	string	用來存取 Azure DevOps 資源的權杖範圍
targetAccounts	string[]	權杖有效的組織;如果權杖適用于所有使用者的可存取組織，則為 null
token	string	建立時產生的唯一權杖字串
validFrom	string	權杖建立日期
validTo	string	權杖到期日

PatTokenCreateRequest

封裝建立新個人存取權杖的要求參數， (PAT)

名稱	類型	Description
allOrgs	boolean	True 是表示 如果此個人存取權杖 (PAT) 適用于所有使用者的可存取組織。 False，否則為 (例如，如果權杖適用于特定組織)
displayName	string	權杖名稱
scope	string	用來存取 Azure DevOps 資源的權杖範圍
validTo	string	權杖到期日

PatTokenResult

包含產生的個人存取權杖 (PAT) ，如果作業期間發生任何) ，則為錯誤 (

名稱	類型	Description
patToken	PatToken	PAT) 產生的個人存取權杖 (
patTokenError	SessionTokenError	如果發生任何) ，就會 (錯誤

SessionTokenError

如果發生任何) ，就會 (錯誤

名稱	類型	Description
accessDenied	string
authorizationNotFound	string
deploymentHostNotSupported	string
displayNameRequired	string
duplicateHash	string
failedToIssueAccessToken	string
failedToReadTenantPolicy	string
failedToUpdateAccessToken	string
fullScopePatPolicyViolation	string
globalPatPolicyViolation	string
hostAuthorizationNotFound	string
invalidAudience	string
invalidAuthorizationId	string
invalidClient	string
invalidClientId	string
invalidClientType	string
invalidDisplayName	string
invalidScope	string
invalidSource	string
invalidSourceIP	string
invalidSubject	string
invalidTargetAccounts	string
invalidToken	string
invalidTokenType	string
invalidUserId	string
invalidUserType	string
invalidValidTo	string
none	string
patLifespanPolicyViolation	string
sourceNotSupported	string
sshPolicyDisabled	string
tokenNotFound	string
userIdRequired	string