Microsoft.ContainerRegistry registries/taskRuns 2019-06-01-preview
Bicep 資源定義
登錄/taskRuns 資源類型可以使用目標作業來部署:
- 資源群組 - 請參閱 資源群組部署命令
如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄。
資源格式
若要建立 Microsoft.ContainerRegistry/registries/taskRuns 資源,請將下列 Bicep 新增至您的範本。
resource symbolicname 'Microsoft.ContainerRegistry/registries/taskRuns@2019-06-01-preview' = {
name: 'string'
location: 'string'
parent: resourceSymbolicName
identity: {
principalId: 'string'
tenantId: 'string'
type: 'string'
userAssignedIdentities: {}
}
properties: {
forceUpdateTag: 'string'
runRequest: {
agentPoolName: 'string'
isArchiveEnabled: bool
logTemplate: 'string'
type: 'string'
// For remaining properties, see RunRequest objects
}
}
}
RunRequest 物件
設定 type 屬性以指定物件的類型。
針對 DockerBuildRequest,請使用:
type: 'DockerBuildRequest'
agentConfiguration: {
cpu: int
}
arguments: [
{
isSecret: bool
name: 'string'
value: 'string'
}
]
credentials: {
customRegistries: {}
sourceRegistry: {
loginMode: 'string'
}
}
dockerFilePath: 'string'
imageNames: [
'string'
]
isPushEnabled: bool
noCache: bool
platform: {
architecture: 'string'
os: 'string'
variant: 'string'
}
sourceLocation: 'string'
target: 'string'
timeout: int
針對 EncodedTaskRunRequest,請使用:
type: 'EncodedTaskRunRequest'
agentConfiguration: {
cpu: int
}
credentials: {
customRegistries: {}
sourceRegistry: {
loginMode: 'string'
}
}
encodedTaskContent: 'string'
encodedValuesContent: 'string'
platform: {
architecture: 'string'
os: 'string'
variant: 'string'
}
sourceLocation: 'string'
timeout: int
values: [
{
isSecret: bool
name: 'string'
value: 'string'
}
]
針對 FileTaskRunRequest,請使用:
type: 'FileTaskRunRequest'
agentConfiguration: {
cpu: int
}
credentials: {
customRegistries: {}
sourceRegistry: {
loginMode: 'string'
}
}
platform: {
architecture: 'string'
os: 'string'
variant: 'string'
}
sourceLocation: 'string'
taskFilePath: 'string'
timeout: int
values: [
{
isSecret: bool
name: 'string'
value: 'string'
}
]
valuesFilePath: 'string'
針對 TaskRunRequest,請使用:
type: 'TaskRunRequest'
overrideTaskStepProperties: {
arguments: [
{
isSecret: bool
name: 'string'
value: 'string'
}
]
contextPath: 'string'
file: 'string'
target: 'string'
updateTriggerToken: 'string'
values: [
{
isSecret: bool
name: 'string'
value: 'string'
}
]
}
taskId: 'string'
屬性值
registries/taskRuns
名稱 | 描述 | 值 |
---|---|---|
NAME | 資源名稱 瞭解如何在 Bicep中設定子資源的名稱和類型。 |
字串 (必要) |
location | 資源的位置 | 字串 |
父系 (parent) | 在 Bicep 中,您可以指定子資源的父資源。 只有在父資源之外宣告子資源時,才需要新增這個屬性。 如需詳細資訊,請參閱 父資源外部的子資源。 |
類型資源的符號名稱: 登錄 |
身分識別 | 資源的身分識別。 | IdentityProperties |
properties | 與工作執行相關聯的屬性,也就是執行的要求和結果 | TaskRunProperties |
IdentityProperties
名稱 | 描述 | 值 |
---|---|---|
principalId | 資源識別的主體識別碼。 | 字串 |
tenantId | 資源的租使用者識別碼。 | 字串 |
type | 識別類型。 | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' |
userAssignedIdentities | 與資源相關聯的使用者身分識別清單。 使用者身分識別 字典索引鍵參考將會是格式為 ARM 資源識別碼: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'。 |
object |
TaskRunProperties
名稱 | 描述 | 值 |
---|---|---|
forceUpdateTag | 即使執行要求組態未變更,仍應強制重新執行執行的方式 | 字串 |
runRequest | 執行的要求 (參數) | RunRequest |
RunRequest
名稱 | 描述 | 值 |
---|---|---|
agentPoolName | 執行的專用代理程式組件區。 | 字串 |
isArchiveEnabled | 值,指出是否啟用執行封存。 | bool |
logTemplate | 描述執行記錄成品之存放庫和標記資訊的範本。 | 字串 |
type | 設定物件類型 | DockerBuildRequest EncodedTaskRunRequest FileTaskRunRequest TaskRunRequest (必要) |
DockerBuildRequest
名稱 | 描述 | 值 |
---|---|---|
類型 | 執行要求的型別。 | 'DockerBuildRequest' (必要) |
agentConfiguration | 執行代理程式的機器組態。 | AgentProperties |
引數 | 執行執行時要使用的覆寫引數集合。 | Argument[] |
認證 | 屬性,描述叫用此執行時將使用的一組認證。 | 認證 |
dockerFilePath | 相對於來源位置的 Docker 檔案路徑。 | 字串 (必要) |
imageNames | 完整的映射名稱,包括存放庫和標記。 | string[] |
isPushEnabled | 這個屬性的值表示是否應該將建置的映射推送至登錄。 | bool |
noCache | 這個屬性的值會指出是否啟用映射快取。 | bool |
平台 | 執行必須對其執行的平臺屬性。 | PlatformProperties (必要) |
sourceLocation | URL (來源內容的絕對或相對) 。 它可以是 tar 或 git 存放庫的 URL。 如果是相對 URL,則應該從呼叫 listBuildSourceUploadUrl API 取得相對路徑。 |
字串 |
目標 | Docker 組建的目標建置階段名稱。 | 字串 |
timeout | 以秒為單位執行逾時。 | int |
AgentProperties
名稱 | 描述 | 值 |
---|---|---|
cpu | 針對執行所需的核心數目,CPU 組態。 | int |
引數
名稱 | 描述 | 值 |
---|---|---|
isSecret | 旗標,指出引數是否代表秘密,而且想要從組建記錄中移除。 | bool |
NAME | 引數的名稱。 | 字串 (必要) |
value | 引數的值。 | 字串 (必要) |
認證
名稱 | 描述 | 值 |
---|---|---|
customRegistries | 描述用來存取其他自訂登錄的認證參數。 金鑰 字典專案的登錄登入伺服器 (myregistry.azurecr.io) 和 專案的值將會是用來存取登錄的登錄認證。 |
object |
sourceRegistry | 描述用來存取來源登錄的認證參數。 | SourceRegistryCredentials |
SourceRegistryCredentials
名稱 | 描述 | 值 |
---|---|---|
loginMode | 決定來源登錄登入範圍的驗證模式。 來源登錄的認證 將會使用指定的範圍產生。 這些認證將用來登入 執行期間的來源登錄。 |
'Default' 'None' |
PlatformProperties
名稱 | 描述 | 值 |
---|---|---|
架構 | OS 架構。 | '386' 'amd64' 'arm' 'arm64' 'x86' |
os | 執行所需的作業系統類型。 | 'Linux' 'Windows' (必要) |
variant | CPU 的變體。 | 'v6' 'v7' 'v8' |
EncodedTaskRunRequest
名稱 | 描述 | 值 |
---|---|---|
類型 | 執行要求的型別。 | 'EncodedTaskRunRequest' (必要) |
agentConfiguration | 執行代理程式的機器組態。 | AgentProperties |
認證 | 屬性,描述叫用此執行時將使用的一組認證。 | 認證 |
encodedTaskContent | 範本/定義檔案內容的 Base64 編碼值。 | 字串 (必要) |
encodedValuesContent | 參數/值檔案內容的 Base64 編碼值。 | 字串 |
平台 | 執行必須對其執行的平臺屬性。 | PlatformProperties (必要) |
sourceLocation | URL (來源內容的絕對或相對) 。 它可以是 tar 或 git 存放庫的 URL。 如果是相對 URL,則應該從呼叫 listBuildSourceUploadUrl API 取得相對路徑。 |
字串 |
timeout | 以秒為單位執行逾時。 | int |
值 | 執行工作時可以傳遞之可覆寫值的集合。 | SetValue[] |
SetValue
名稱 | 描述 | 值 |
---|---|---|
isSecret | 指出值是否代表秘密的旗標。 | bool |
NAME | 可覆寫值的名稱。 | 字串 (必要) |
value | 可覆寫的值。 | 字串 (必要) |
FileTaskRunRequest
名稱 | 描述 | 值 |
---|---|---|
類型 | 執行要求的型別。 | 'FileTaskRunRequest' (必要) |
agentConfiguration | 執行代理程式的機器組態。 | AgentProperties |
認證 | 屬性,描述叫用此執行時將使用的一組認證。 | 認證 |
平台 | 執行必須對其執行的平臺屬性。 | PlatformProperties (必要) |
sourceLocation | URL (來源內容的絕對或相對) 。 它可以是 tar 或 git 存放庫的 URL。 如果是相對 URL,則應該從呼叫 listBuildSourceUploadUrl API 取得相對路徑。 |
字串 |
taskFilePath | 相對於來源的範本/定義檔案路徑。 | 字串 (必要) |
timeout | 以秒為單位執行逾時。 | int |
值 | 執行工作時可以傳遞之可覆寫值的集合。 | SetValue[] |
valuesFilePath | 相對於來源的值/參數檔案路徑。 | 字串 |
TaskRunRequest
名稱 | 描述 | 值 |
---|---|---|
類型 | 執行要求的型別。 | 'TaskRunRequest' (必要) |
overrideTaskStepProperties | 執行工作時可傳遞的可覆寫參數集。 | OverrideTaskStepProperties |
taskId | 執行必須排入佇列的工作資源識別碼。 | 字串 (必要) |
OverrideTaskStepProperties
名稱 | 描述 | 值 |
---|---|---|
引數 | 取得或設定在何時使用之覆寫引數的集合 執行建置步驟。 |
Argument[] |
coNtextPath | 執行必須排入佇列的來源內容。 | 字串 |
檔案 | 執行必須排入佇列的檔案。 | 字串 |
目標 | Docker 組建的目標建置階段名稱。 | 字串 |
updateTriggerToken | Base64 編碼的更新觸發程式權杖,將會附加基底映射觸發程式 Webhook。 | 字串 |
值 | 執行 Task 時可傳遞之可覆寫值的集合。 | SetValue[] |
ARM 範本資源定義
登錄/taskRuns 資源類型可以使用目標作業來部署:
- 資源群組 - 請參閱 資源群組部署命令
如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄。
資源格式
若要建立 Microsoft.ContainerRegistry/registries/taskRuns 資源,請將下列 JSON 新增至您的範本。
{
"type": "Microsoft.ContainerRegistry/registries/taskRuns",
"apiVersion": "2019-06-01-preview",
"name": "string",
"location": "string",
"identity": {
"principalId": "string",
"tenantId": "string",
"type": "string",
"userAssignedIdentities": {}
},
"properties": {
"forceUpdateTag": "string",
"runRequest": {
"agentPoolName": "string",
"isArchiveEnabled": "bool",
"logTemplate": "string",
"type": "string"
// For remaining properties, see RunRequest objects
}
}
}
RunRequest 物件
設定 type 屬性以指定物件的類型。
針對 DockerBuildRequest,請使用:
"type": "DockerBuildRequest",
"agentConfiguration": {
"cpu": "int"
},
"arguments": [
{
"isSecret": "bool",
"name": "string",
"value": "string"
}
],
"credentials": {
"customRegistries": {},
"sourceRegistry": {
"loginMode": "string"
}
},
"dockerFilePath": "string",
"imageNames": [ "string" ],
"isPushEnabled": "bool",
"noCache": "bool",
"platform": {
"architecture": "string",
"os": "string",
"variant": "string"
},
"sourceLocation": "string",
"target": "string",
"timeout": "int"
針對 EncodedTaskRunRequest,請使用:
"type": "EncodedTaskRunRequest",
"agentConfiguration": {
"cpu": "int"
},
"credentials": {
"customRegistries": {},
"sourceRegistry": {
"loginMode": "string"
}
},
"encodedTaskContent": "string",
"encodedValuesContent": "string",
"platform": {
"architecture": "string",
"os": "string",
"variant": "string"
},
"sourceLocation": "string",
"timeout": "int",
"values": [
{
"isSecret": "bool",
"name": "string",
"value": "string"
}
]
針對 FileTaskRunRequest,請使用:
"type": "FileTaskRunRequest",
"agentConfiguration": {
"cpu": "int"
},
"credentials": {
"customRegistries": {},
"sourceRegistry": {
"loginMode": "string"
}
},
"platform": {
"architecture": "string",
"os": "string",
"variant": "string"
},
"sourceLocation": "string",
"taskFilePath": "string",
"timeout": "int",
"values": [
{
"isSecret": "bool",
"name": "string",
"value": "string"
}
],
"valuesFilePath": "string"
針對 TaskRunRequest,請使用:
"type": "TaskRunRequest",
"overrideTaskStepProperties": {
"arguments": [
{
"isSecret": "bool",
"name": "string",
"value": "string"
}
],
"contextPath": "string",
"file": "string",
"target": "string",
"updateTriggerToken": "string",
"values": [
{
"isSecret": "bool",
"name": "string",
"value": "string"
}
]
},
"taskId": "string"
屬性值
registries/taskRuns
名稱 | 描述 | 值 |
---|---|---|
類型 | 資源類型 | 'Microsoft.ContainerRegistry/registries/taskRuns' |
apiVersion | 資源 API 版本 | '2019-06-01-preview' |
NAME | 資源名稱 請參閱如何在 JSON ARM 範本中設定子資源的名稱和類型。 |
字串 (必要) |
location | 資源的位置 | 字串 |
身分識別 | 資源的身分識別。 | IdentityProperties |
properties | 與工作執行相關聯的屬性,也就是執行的要求和結果 | TaskRunProperties |
IdentityProperties
名稱 | 描述 | 值 |
---|---|---|
principalId | 資源識別的主體識別碼。 | 字串 |
tenantId | 資源的租使用者識別碼。 | 字串 |
type | 識別類型。 | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' |
userAssignedIdentities | 與資源相關聯的使用者身分識別清單。 使用者身分識別 字典索引鍵參考將會是格式為 ARM 資源識別碼: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'。 |
object |
TaskRunProperties
名稱 | 描述 | 值 |
---|---|---|
forceUpdateTag | 即使執行要求組態未變更,仍應強制重新執行執行的方式 | 字串 |
runRequest | 執行的要求 (參數) | RunRequest |
RunRequest
名稱 | 描述 | 值 |
---|---|---|
agentPoolName | 執行的專用代理程式組件區。 | 字串 |
isArchiveEnabled | 值,指出是否啟用執行封存。 | bool |
logTemplate | 描述執行記錄成品之存放庫和標記資訊的範本。 | 字串 |
type | 設定物件類型 | DockerBuildRequest EncodedTaskRunRequest FileTaskRunRequest TaskRunRequest (必要) |
DockerBuildRequest
名稱 | 描述 | 值 |
---|---|---|
類型 | 執行要求的型別。 | 'DockerBuildRequest' (必要) |
agentConfiguration | 執行代理程式的機器組態。 | AgentProperties |
引數 | 執行執行時要使用的覆寫引數集合。 | Argument[] |
認證 | 屬性,描述叫用此執行時將使用的一組認證。 | 認證 |
dockerFilePath | 相對於來源位置的 Docker 檔案路徑。 | 需要字串 () |
imageNames | 完整的映射名稱,包括存放庫和標記。 | string[] |
isPushEnabled | 這個屬性的值表示是否應該將建置的映射推送至登錄。 | bool |
noCache | 這個屬性的值表示是否啟用映射快取。 | bool |
平台 | 執行所針對的平臺屬性。 | PlatformProperties (必要) |
sourceLocation | URL (來源內容的絕對或相對) 。 它可以是 tar 或 git 存放庫的 URL。 如果是相對 URL,應該從呼叫 listBuildSourceUploadUrl API 取得相對路徑。 |
字串 |
目標 | Docker 組建的目標建置階段名稱。 | 字串 |
timeout | 以秒為單位執行逾時。 | int |
AgentProperties
名稱 | 描述 | 值 |
---|---|---|
cpu | CPU 組態,以執行所需的核心數目來表示。 | int |
引數
名稱 | 描述 | 值 |
---|---|---|
isSecret | 旗標,指出引數是否代表秘密,而且想要從組建記錄中移除。 | bool |
NAME | 引數的名稱。 | 需要字串 () |
value | 引數的值。 | 需要字串 () |
認證
名稱 | 描述 | 值 |
---|---|---|
customRegistries | 描述用來存取其他自訂登錄的認證參數。 金鑰 字典專案的 會是登錄登入伺服器, (myregistry.azurecr.io) 和 專案的值將會是用來存取登錄的登錄認證。 |
object |
sourceRegistry | 描述用來存取來源登錄的認證參數。 | SourceRegistryCredentials |
SourceRegistryCredentials
名稱 | 描述 | 值 |
---|---|---|
loginMode | 決定來源登錄登入範圍的驗證模式。 來源登錄的認證 將會使用指定的範圍產生。 這些認證將用來登入 執行期間的來源登錄。 |
'Default' 'None' |
PlatformProperties
名稱 | 描述 | 值 |
---|---|---|
架構 | OS 架構。 | '386' 'amd64' 'arm' 'arm64' 'x86' |
os | 執行所需的作業系統類型。 | 'Linux' 需要 'Windows' () |
variant | CPU 的變體。 | 'v6' 'v7' 'v8' |
EncodedTaskRunRequest
名稱 | 描述 | 值 |
---|---|---|
類型 | 執行要求的型別。 | 'EncodedTaskRunRequest' (必要) |
agentConfiguration | 執行代理程式的機器組態。 | AgentProperties |
認證 | 屬性,描述叫用此執行時將使用的一組認證。 | 認證 |
encodedTaskContent | 範本/定義檔案內容的 Base64 編碼值。 | 需要字串 () |
encodedValuesContent | 參數/值檔案內容的 Base64 編碼值。 | 字串 |
平台 | 執行所針對的平臺屬性。 | PlatformProperties (必要) |
sourceLocation | URL (來源內容的絕對或相對) 。 它可以是 tar 或 git 存放庫的 URL。 如果是相對 URL,應該從呼叫 listBuildSourceUploadUrl API 取得相對路徑。 |
字串 |
timeout | 以秒為單位執行逾時。 | int |
值 | 執行工作時可傳遞之可覆寫值的集合。 | SetValue[] |
SetValue
名稱 | 描述 | 值 |
---|---|---|
isSecret | 旗標,指出值是否代表秘密。 | bool |
NAME | 可覆寫值的名稱。 | 需要字串 () |
value | 可覆寫的值。 | 需要字串 () |
FileTaskRunRequest
名稱 | 描述 | 值 |
---|---|---|
類型 | 執行要求的型別。 | 'FileTaskRunRequest' (必要) |
agentConfiguration | 執行代理程式的機器組態。 | AgentProperties |
認證 | 屬性,描述叫用此執行時將使用的一組認證。 | 認證 |
平台 | 執行所針對的平臺屬性。 | PlatformProperties (必要) |
sourceLocation | URL (來源內容的絕對或相對) 。 它可以是 tar 或 git 存放庫的 URL。 如果是相對 URL,應該從呼叫 listBuildSourceUploadUrl API 取得相對路徑。 |
字串 |
taskFilePath | 相對於來源的範本/定義檔案路徑。 | 需要字串 () |
timeout | 以秒為單位執行逾時。 | int |
值 | 執行工作時可傳遞之可覆寫值的集合。 | SetValue[] |
valuesFilePath | 相對於來源的值/參數檔案路徑。 | 字串 |
TaskRunRequest
名稱 | 描述 | 值 |
---|---|---|
類型 | 執行要求的型別。 | 'TaskRunRequest' (必要) |
overrideTaskStepProperties | 執行 Task 時可傳遞的可覆寫參數集。 | OverrideTaskStepProperties |
taskId | 執行必須排入佇列的工作資源識別碼。 | 需要字串 () |
OverrideTaskStepProperties
名稱 | 描述 | 值 |
---|---|---|
引數 | 取得或設定在何時要使用的覆寫引數集合 執行建置步驟。 |
Argument[] |
coNtextPath | 必須排入佇列執行的來源內容。 | 字串 |
檔案 | 執行必須排入佇列的檔案。 | 字串 |
目標 | Docker 組建的目標建置階段名稱。 | 字串 |
updateTriggerToken | 將附加基底映射觸發程式 Webhook 的 Base64 編碼更新觸發程式權杖。 | 字串 |
值 | 執行 Task 時可傳遞之可覆寫值的集合。 | SetValue[] |
Terraform (AzAPI 提供者) 資源定義
登錄/taskRuns 資源類型可以使用目標作業來部署:
- 資源群組
如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄檔。
資源格式
若要建立 Microsoft.ContainerRegistry/registries/taskRuns 資源,請將下列 Terraform 新增至範本。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.ContainerRegistry/registries/taskRuns@2019-06-01-preview"
name = "string"
location = "string"
parent_id = "string"
identity {
type = "string"
identity_ids = []
}
body = jsonencode({
properties = {
forceUpdateTag = "string"
runRequest = {
agentPoolName = "string"
isArchiveEnabled = bool
logTemplate = "string"
type = "string"
// For remaining properties, see RunRequest objects
}
}
})
}
RunRequest 物件
設定 type 屬性以指定物件的類型。
針對 DockerBuildRequest,請使用:
type = "DockerBuildRequest"
agentConfiguration = {
cpu = int
}
arguments = [
{
isSecret = bool
name = "string"
value = "string"
}
]
credentials = {
customRegistries = {}
sourceRegistry = {
loginMode = "string"
}
}
dockerFilePath = "string"
imageNames = [
"string"
]
isPushEnabled = bool
noCache = bool
platform = {
architecture = "string"
os = "string"
variant = "string"
}
sourceLocation = "string"
target = "string"
timeout = int
針對 EncodedTaskRunRequest,請使用:
type = "EncodedTaskRunRequest"
agentConfiguration = {
cpu = int
}
credentials = {
customRegistries = {}
sourceRegistry = {
loginMode = "string"
}
}
encodedTaskContent = "string"
encodedValuesContent = "string"
platform = {
architecture = "string"
os = "string"
variant = "string"
}
sourceLocation = "string"
timeout = int
values = [
{
isSecret = bool
name = "string"
value = "string"
}
]
針對 FileTaskRunRequest,請使用:
type = "FileTaskRunRequest"
agentConfiguration = {
cpu = int
}
credentials = {
customRegistries = {}
sourceRegistry = {
loginMode = "string"
}
}
platform = {
architecture = "string"
os = "string"
variant = "string"
}
sourceLocation = "string"
taskFilePath = "string"
timeout = int
values = [
{
isSecret = bool
name = "string"
value = "string"
}
]
valuesFilePath = "string"
針對 TaskRunRequest,請使用:
type = "TaskRunRequest"
overrideTaskStepProperties = {
arguments = [
{
isSecret = bool
name = "string"
value = "string"
}
]
contextPath = "string"
file = "string"
target = "string"
updateTriggerToken = "string"
values = [
{
isSecret = bool
name = "string"
value = "string"
}
]
}
taskId = "string"
屬性值
registries/taskRuns
名稱 | 描述 | 值 |
---|---|---|
類型 | 資源類型 | 「Microsoft.ContainerRegistry/registries/taskRuns@2019-06-01-preview」 |
NAME | 資源名稱 | 需要字串 () |
location | 資源的位置 | 字串 |
parent_id | 此資源父系之資源的識別碼。 | 類型資源的識別碼: 登錄 |
身分識別 | 資源的身分識別。 | IdentityProperties |
properties | 與工作執行相關聯的屬性,也就是執行的要求和結果 | TaskRunProperties |
IdentityProperties
名稱 | 描述 | 值 |
---|---|---|
類型 | 識別類型。 | 「SystemAssigned」 「SystemAssigned, UserAssigned」 「UserAssigned」 |
identity_ids | 與資源相關聯的使用者身分識別清單。 使用者身分識別 字典索引鍵參考的格式會是 ARM 資源識別碼: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'。 |
使用者身分識別識別碼的陣列。 |
TaskRunProperties
名稱 | 描述 | 值 |
---|---|---|
forceUpdateTag | 即使執行要求組態未變更,執行應該如何強制重新執行 | 字串 |
runRequest | 執行的要求 (參數) | RunRequest |
RunRequest
名稱 | 描述 | 值 |
---|---|---|
agentPoolName | 執行的專用代理程式組件區。 | 字串 |
isArchiveEnabled | 值,指出是否啟用執行封存。 | bool |
logTemplate | 描述執行記錄成品之存放庫和標記資訊的範本。 | 字串 |
type | 設定物件類型 | DockerBuildRequest EncodedTaskRunRequest FileTaskRunRequest TaskRunRequest (必要) |
DockerBuildRequest
名稱 | 描述 | 值 |
---|---|---|
類型 | 執行要求的型別。 | ) 所需的 「DockerBuildRequest」 ( |
agentConfiguration | 執行代理程式的機器組態。 | AgentProperties |
引數 | 執行執行時要使用的覆寫引數集合。 | Argument[] |
認證 | 屬性,描述叫用此執行時將使用的一組認證。 | 認證 |
dockerFilePath | 相對於來源位置的 Docker 檔案路徑。 | 字串 (必要) |
imageNames | 完整的映射名稱,包括存放庫和標記。 | string[] |
isPushEnabled | 這個屬性的值表示是否應該將建置的映射推送至登錄。 | bool |
noCache | 這個屬性的值會指出是否啟用映射快取。 | bool |
平台 | 執行必須對其執行的平臺屬性。 | PlatformProperties (必要) |
sourceLocation | URL (來源內容的絕對或相對) 。 它可以是 tar 或 git 存放庫的 URL。 如果是相對 URL,則應該從呼叫 listBuildSourceUploadUrl API 取得相對路徑。 |
字串 |
目標 | Docker 組建的目標建置階段名稱。 | 字串 |
timeout | 以秒為單位執行逾時。 | int |
AgentProperties
名稱 | 描述 | 值 |
---|---|---|
cpu | 針對執行所需的核心數目,CPU 組態。 | int |
引數
名稱 | 描述 | 值 |
---|---|---|
isSecret | 旗標,指出引數是否代表秘密,而且想要從組建記錄中移除。 | bool |
NAME | 引數的名稱。 | 字串 (必要) |
value | 引數的值。 | 字串 (必要) |
認證
名稱 | 描述 | 值 |
---|---|---|
customRegistries | 描述用來存取其他自訂登錄的認證參數。 金鑰 字典專案的登錄登入伺服器 (myregistry.azurecr.io) 和 專案的值將會是用來存取登錄的登錄認證。 |
object |
sourceRegistry | 描述用來存取來源登錄的認證參數。 | SourceRegistryCredentials |
SourceRegistryCredentials
名稱 | 描述 | 值 |
---|---|---|
loginMode | 決定來源登錄登入範圍的驗證模式。 來源登錄的認證 將會使用指定的範圍產生。 這些認證將用來登入 執行期間的來源登錄。 |
「Default」 "None" |
PlatformProperties
名稱 | 描述 | 值 |
---|---|---|
架構 | OS 架構。 | "386" 「amd64」 「arm」 「arm64」 「x86」 |
os | 執行所需的作業系統類型。 | "Linux" 「Windows」 (必要) |
variant | CPU 的變體。 | 「v6」 「v7」 「v8」 |
EncodedTaskRunRequest
名稱 | 描述 | 值 |
---|---|---|
類型 | 執行要求的型別。 | 「EncodedTaskRunRequest」 (必要) |
agentConfiguration | 執行代理程式的機器組態。 | AgentProperties |
認證 | 屬性,描述叫用此執行時將使用的一組認證。 | 認證 |
encodedTaskContent | 範本/定義檔案內容的 Base64 編碼值。 | 字串 (必要) |
encodedValuesContent | 參數/值檔案內容的 Base64 編碼值。 | 字串 |
平台 | 執行必須對其執行的平臺屬性。 | PlatformProperties (必要) |
sourceLocation | URL (來源內容的絕對或相對) 。 它可以是 tar 或 git 存放庫的 URL。 如果是相對 URL,則應該從呼叫 listBuildSourceUploadUrl API 取得相對路徑。 |
字串 |
timeout | 以秒為單位執行逾時。 | int |
值 | 執行工作時可以傳遞之可覆寫值的集合。 | SetValue[] |
SetValue
名稱 | 描述 | 值 |
---|---|---|
isSecret | 指出值是否代表秘密的旗標。 | bool |
NAME | 可覆寫值的名稱。 | 字串 (必要) |
value | 可覆寫的值。 | 字串 (必要) |
FileTaskRunRequest
名稱 | 描述 | 值 |
---|---|---|
類型 | 執行要求的型別。 | 「FileTaskRunRequest」 (必要) |
agentConfiguration | 執行代理程式的機器組態。 | AgentProperties |
認證 | 屬性,描述叫用此執行時將使用的一組認證。 | 認證 |
平台 | 執行必須對其執行的平臺屬性。 | PlatformProperties (必要) |
sourceLocation | URL (來源內容的絕對或相對) 。 它可以是 tar 或 git 存放庫的 URL。 如果是相對 URL,則應該從呼叫 listBuildSourceUploadUrl API 取得相對路徑。 |
字串 |
taskFilePath | 相對於來源的範本/定義檔案路徑。 | 字串 (必要) |
timeout | 以秒為單位執行逾時。 | int |
值 | 執行工作時可以傳遞之可覆寫值的集合。 | SetValue[] |
valuesFilePath | 相對於來源的值/參數檔案路徑。 | 字串 |
TaskRunRequest
名稱 | 描述 | 值 |
---|---|---|
類型 | 執行要求的型別。 | 「TaskRunRequest」 (必要) |
overrideTaskStepProperties | 執行工作時可傳遞的可覆寫參數集。 | OverrideTaskStepProperties |
taskId | 執行必須排入佇列的工作資源識別碼。 | 字串 (必要) |
OverrideTaskStepProperties
名稱 | 描述 | 值 |
---|---|---|
引數 | 取得或設定在何時使用之覆寫引數的集合 執行建置步驟。 |
Argument[] |
coNtextPath | 執行必須排入佇列的來源內容。 | 字串 |
檔案 | 執行必須排入佇列的檔案。 | 字串 |
目標 | Docker 組建的目標建置階段名稱。 | 字串 |
updateTriggerToken | Base64 編碼的更新觸發程式權杖,將會附加基底映射觸發程式 Webhook。 | 字串 |
值 | 執行 Task 時可傳遞之可覆寫值的集合。 | SetValue[] |
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應