Source Control - Update

參考

服務:: Automation

API 版本:: 2023-11-01

更新原始檔控制。

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/sourceControls/{sourceControlName}?api-version=2023-11-01

URI 參數

名稱	位於	必要	類型	Description
automationAccountName	path	True	string	自動化帳戶的名稱。
resourceGroupName	path	True	string	Azure 資源群組的名稱。 Regex 模式: `^[-\w\._]+$`
sourceControlName	path	True	string	原始檔控制名稱。
subscriptionId	path	True	string	取得用來唯一識別 Microsoft Azure 訂用帳戶的訂用帳戶認證。訂用帳戶識別碼會構成每個服務呼叫 URI 的一部分。
api-version	query	True	string	用戶端 API 版本。

要求本文

名稱	類型	Description
properties.autoSync	boolean	原始檔控制自動同步處理。預設值為 false。
properties.branch	string	原始檔控制的存放庫分支。
properties.description	string	原始檔控制的使用者描述。
properties.folderPath	string	原始檔控制的資料夾路徑。路徑必須是相對的。
properties.publishRunbook	boolean	原始檔控制自動發佈。預設值為 true。
properties.securityToken	SourceControlSecurityTokenProperties	原始檔控制存放庫的授權令牌。

回應

名稱	類型	Description
200 OK	SourceControl	確定
Other Status Codes	ErrorResponse	描述作業失敗原因的自動化錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱	Description
user_impersonation	模擬您的用戶帳戶

範例

Update a source control

範例要求

HTTP

PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg/providers/Microsoft.Automation/automationAccounts/sampleAccount9/sourceControls/sampleSourceControl?api-version=2023-11-01

{
  "properties": {
    "branch": "master",
    "folderPath": "/folderOne/folderTwo",
    "autoSync": true,
    "publishRunbook": true,
    "securityToken": {
      "accessToken": "******",
      "tokenType": "PersonalAccessToken"
    },
    "description": "my description"
  }
}

範例回覆

狀態碼:: 200

{
  "id": "/subscriptions/subid/resourceGroups/rg/providers/Microsoft.Automation/automationAccounts/sampleAccount9/sourcecontrols/sampleSourceControl",
  "name": "sampleSourceControl",
  "properties": {
    "creationTime": "2017-03-28T22:59:00.937+00:00",
    "lastModifiedTime": "2017-03-28T22:59:00.937+00:00",
    "repoUrl": "https://sampleUser.visualstudio.com/myProject/_git/myRepository",
    "branch": "master",
    "folderPath": "/folderOne/folderTwo",
    "autoSync": true,
    "publishRunbook": true,
    "sourceType": "VsoGit",
    "description": "my description"
  }
}

定義

名稱	Description
ErrorResponse	作業失敗的錯誤回應
SourceControl	原始檔控制的定義。
SourceControlSecurityTokenProperties
SourceControlUpdateParameters	提供給更新原始檔控制作業的參數。
sourceType	來源類型。必須是其中一個 VsoGit、VsoTfvc、GitHub。
tokenType	Token 類型。必須是 PersonalAccessToken 或 Oauth。

ErrorResponse

作業失敗的錯誤回應

名稱	類型	Description
code	string	錯誤碼
message	string	指出作業失敗原因的錯誤訊息。

SourceControl

原始檔控制的定義。

名稱	類型	Description
id	string	資源的完整資源標識碼
name	string	資源的名稱
properties.autoSync	boolean	原始檔控制自動同步處理。預設值為 false。
properties.branch	string	原始檔控制的存放庫分支。將分支納入為 VsoTfvc 的空字串。
properties.creationTime	string	建立時間。
properties.description	string	描述。
properties.folderPath	string	原始檔控制的資料夾路徑。
properties.lastModifiedTime	string	上次修改的時間。
properties.publishRunbook	boolean	原始檔控制自動發佈。預設值為 true。
properties.repoUrl	string	原始檔控制的存放庫 URL。
properties.sourceType	sourceType	來源類型。必須是其中一個 VsoGit、VsoTfvc、GitHub。
type	string	資源類型。

SourceControlSecurityTokenProperties

名稱	類型	Description
accessToken	string	存取權杖。
refreshToken	string	重新整理權杖。
tokenType	tokenType	Token 類型。必須是 PersonalAccessToken 或 Oauth。

SourceControlUpdateParameters

提供給更新原始檔控制作業的參數。

名稱	類型	Description
properties.autoSync	boolean	原始檔控制自動同步處理。預設值為 false。
properties.branch	string	原始檔控制的存放庫分支。
properties.description	string	原始檔控制的使用者描述。
properties.folderPath	string	原始檔控制的資料夾路徑。路徑必須是相對的。
properties.publishRunbook	boolean	原始檔控制自動發佈。預設值為 true。
properties.securityToken	SourceControlSecurityTokenProperties	原始檔控制存放庫的授權令牌。

sourceType

來源類型。必須是其中一個 VsoGit、VsoTfvc、GitHub。

名稱	類型	Description
GitHub	string
VsoGit	string
VsoTfvc	string

tokenType

Token 類型。必須是 PersonalAccessToken 或 Oauth。

名稱	類型	Description
Oauth	string
PersonalAccessToken	string

共用方式為