Tasks - Get Details

Reference

Service:: Container Registry

API Version:: 2019-04-01

Returns a task with extended information that includes all secrets.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerRegistry/registries/{registryName}/tasks/{taskName}/listDetails?api-version=2019-04-01

URI Parameters

Name	In	Required	Type	Description
registryName	path	True	string	The name of the container registry. Regex pattern: `^[a-zA-Z0-9]*$`
resourceGroupName	path	True	string	The name of the resource group to which the container registry belongs.
subscriptionId	path	True	string	The Microsoft Azure subscription ID.
taskName	path	True	string	The name of the container registry task. Regex pattern: `^[a-zA-Z0-9-_]*$`
api-version	query	True	string	The client API version.

Responses

Name	Type	Description
200 OK	Task	The request was successful; the request was well-formed and received properly.
Other Status Codes		Error response describing why the operation failed. If the registry doesn't exist, 404 (Not found) is returned.

Security

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	impersonate your user account

Examples

Tasks_GetDetails

Sample request

HTTP

POST https://management.azure.com/subscriptions/4385cf00-2d3a-425a-832f-f4285b1c9dce/resourceGroups/myResourceGroup/providers/Microsoft.ContainerRegistry/registries/myRegistry/tasks/myTask/listDetails?api-version=2019-04-01

Sample response

Status code:: 200

{
  "properties": {
    "status": "Enabled",
    "platform": {
      "os": "Linux",
      "architecture": "amd64"
    },
    "agentConfiguration": {
      "cpu": 2
    },
    "step": {
      "type": "Docker",
      "imageNames": [
        "azurerest:testtag"
      ],
      "dockerFilePath": "src/DockerFile",
      "contextPath": "src",
      "isPushEnabled": true,
      "noCache": false,
      "arguments": [
        {
          "name": "mytestargument",
          "value": "mytestvalue",
          "isSecret": false
        },
        {
          "name": "mysecrettestargument",
          "value": "mysecrettestvalue",
          "isSecret": true
        }
      ]
    },
    "trigger": {
      "timerTriggers": [
        {
          "name": "myTimerTrigger",
          "status": "Enabled",
          "schedule": "30 9 * * 1-5"
        }
      ],
      "sourceTriggers": [
        {
          "name": "mySourceTrigger",
          "status": "Enabled",
          "sourceRepository": {
            "sourceControlType": "Github",
            "repositoryUrl": "https://github.com/Azure/azure-rest-api-specs",
            "branch": "master",
            "sourceControlAuthProperties": {
              "tokenType": "PAT",
              "token": "xxxxx"
            }
          },
          "sourceTriggerEvents": [
            "commit"
          ]
        }
      ],
      "baseImageTrigger": {
        "name": "myBaseImageTrigger",
        "status": "Enabled",
        "baseImageTriggerType": "Runtime"
      }
    },
    "credentials": {
      "customRegistries": {
        "myregistry.azure-test.io": {
          "userName": {
            "type": "Opaque",
            "value": "username"
          },
          "password": {
            "type": "Vaultsecret",
            "value": "https://myacbvault.vault.azure.net/secrets/username"
          },
          "identity": "[system]"
        }
      },
      "sourceRegistry": null
    }
  },
  "location": "eastus",
  "identity": {
    "principalId": "fa153151-b9fd-46f4-9088-5e6600f2689v",
    "tenantId": "f686d426-8d16-42db-81b7-abu4gm510ccd",
    "type": "SystemAssigned"
  },
  "tags": {
    "testkey": "value"
  }
}

Definitions

Name	Description
AgentProperties	The properties that determine the run agent configuration.
Architecture	The OS architecture.
Argument	The properties of a run argument.
AuthInfo	The authorization properties for accessing the source code repository.
BaseImageDependency	Properties that describe a base image dependency.
BaseImageDependencyType	The type of the base image dependency.
BaseImageTrigger	The trigger based on base image dependency.
BaseImageTriggerType	The type of the auto trigger for base image dependency updates.
Credentials	The parameters that describes a set of credentials that will be used when a run is invoked.
CustomRegistryCredentials	Describes the credentials that will be used to access a custom registry during a run.
DockerBuildStep	The Docker build step.
EncodedTaskStep	The properties of a encoded task step.
FileTaskStep	The properties of a task step.
IdentityProperties	Managed identity for the resource.
OS	The operating system type required for the run.
PlatformProperties	The platform properties against which the run has to happen.
ProvisioningState	The provisioning state of a run.
ResourceIdentityType	The identity type.
SecretObject	Describes the properties of a secret object value.
SecretObjectType	The type of the secret object which determines how the value of the secret object has to be interpreted.
SetValue	The properties of a overridable value that can be passed to a task template.
SourceControlType	The type of source control service.
SourceProperties	The properties of the source code repository.
SourceRegistryCredentials	Describes the credential parameters for accessing the source registry.
SourceRegistryLoginMode	The authentication mode which determines the source registry login scope. The credentials for the source registry will be generated using the given scope. These credentials will be used to login to the source registry during the run.
SourceTrigger	The properties of a source based trigger.
SourceTriggerEvent	The source event corresponding to the trigger.
Task	The task that has the ARM resource and task properties. The task will have all information to schedule a run against it.
TaskStatus	The current status of task.
TimerTrigger	The properties of a timer trigger.
TokenType	The type of Auth token.
TriggerProperties	The properties of a trigger.
TriggerStatus	The current status of trigger.
UserIdentityProperties
Variant	Variant of the CPU.

AgentProperties

Object

The properties that determine the run agent configuration.

Name	Type	Description
cpu	integer	The CPU configuration in terms of number of cores required for the run.

Architecture

Enumeration

The OS architecture.

Value	Description
amd64
arm
x86

Argument

Object

The properties of a run argument.

Name	Type	Default value	Description
isSecret	boolean	False	Flag to indicate whether the argument represents a secret and want to be removed from build logs.
name	string		The name of the argument.
value	string		The value of the argument.

AuthInfo

Object

The authorization properties for accessing the source code repository.

Name	Type	Description
expiresIn	integer	Time in seconds that the token remains valid
refreshToken	string	The refresh token used to refresh the access token.
scope	string	The scope of the access token.
token	string	The access token used to access the source control provider.
tokenType	TokenType	The type of Auth token.

BaseImageDependency

Object

Properties that describe a base image dependency.

Name	Type	Description
digest	string	The sha256-based digest of the image manifest.
registry	string	The registry login server.
repository	string	The repository name.
tag	string	The tag name.
type	BaseImageDependencyType	The type of the base image dependency.

BaseImageDependencyType

Enumeration

The type of the base image dependency.

Value	Description
BuildTime
RunTime

BaseImageTrigger

Object

The trigger based on base image dependency.

Name	Type	Default value	Description
baseImageTriggerType	BaseImageTriggerType		The type of the auto trigger for base image dependency updates.
name	string		The name of the trigger.
status	TriggerStatus	Enabled	The current status of trigger.

BaseImageTriggerType

Enumeration

The type of the auto trigger for base image dependency updates.

Value	Description
All
Runtime

Credentials

Object

The parameters that describes a set of credentials that will be used when a run is invoked.

Name	Type	Description
customRegistries	<string, CustomRegistryCredentials>	Describes the credential parameters for accessing other custom registries. The key for the dictionary item will be the registry login server (myregistry.azurecr.io) and the value of the item will be the registry credentials for accessing the registry.
sourceRegistry	SourceRegistryCredentials	Describes the credential parameters for accessing the source registry.

CustomRegistryCredentials

Object

Describes the credentials that will be used to access a custom registry during a run.

Name	Type	Description
identity	string	Indicates the managed identity assigned to the custom credential. If a user-assigned identity this value is the Client ID. If a system-assigned identity, the value will be `system`. In the case of a system-assigned identity, the Client ID will be determined by the runner. This identity may be used to authenticate to key vault to retrieve credentials or it may be the only source of authentication used for accessing the registry.
password	SecretObject	The password for logging into the custom registry. The password is a secret object that allows multiple ways of providing the value for it.
userName	SecretObject	The username for logging into the custom registry.

DockerBuildStep

Object

The Docker build step.

Name	Type	Default value	Description
arguments	Argument[]		The collection of override arguments to be used when executing this build step.
baseImageDependencies	BaseImageDependency[]		List of base image dependencies for a step.
contextAccessToken	string		The token (git PAT or SAS token of storage account blob) associated with the context for a step.
contextPath	string		The URL(absolute or relative) of the source context for the task step.
dockerFilePath	string		The Docker file path relative to the source context.
imageNames	string[]		The fully qualified image names including the repository and tag.
isPushEnabled	boolean	True	The value of this property indicates whether the image built should be pushed to the registry or not.
noCache	boolean	False	The value of this property indicates whether the image cache is enabled or not.
target	string		The name of the target build stage for the docker build.
type	string: Docker		The type of the step.

EncodedTaskStep

Object

The properties of a encoded task step.

Name	Type	Description
baseImageDependencies	BaseImageDependency[]	List of base image dependencies for a step.
contextAccessToken	string	The token (git PAT or SAS token of storage account blob) associated with the context for a step.
contextPath	string	The URL(absolute or relative) of the source context for the task step.
encodedTaskContent	string	Base64 encoded value of the template/definition file content.
encodedValuesContent	string	Base64 encoded value of the parameters/values file content.
type	string: EncodedTask	The type of the step.
values	SetValue[]	The collection of overridable values that can be passed when running a task.

FileTaskStep

Object

The properties of a task step.

Name	Type	Description
baseImageDependencies	BaseImageDependency[]	List of base image dependencies for a step.
contextAccessToken	string	The token (git PAT or SAS token of storage account blob) associated with the context for a step.
contextPath	string	The URL(absolute or relative) of the source context for the task step.
taskFilePath	string	The task template/definition file path relative to the source context.
type	string: FileTask	The type of the step.
values	SetValue[]	The collection of overridable values that can be passed when running a task.
valuesFilePath	string	The task values/parameters file path relative to the source context.

IdentityProperties

Object

Managed identity for the resource.

Name	Type	Description
principalId	string	The principal ID of resource identity.
tenantId	string	The tenant ID of resource.
type	ResourceIdentityType	The identity type.
userAssignedIdentities	<string, UserIdentityProperties>	The list of user identities associated with the resource. The user identity dictionary key references will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

OS

Enumeration

The operating system type required for the run.

Value	Description
Linux
Windows

PlatformProperties

Object

The platform properties against which the run has to happen.

Name	Type	Description
architecture	Architecture	The OS architecture.
os	OS	The operating system type required for the run.
variant	Variant	Variant of the CPU.

ProvisioningState

Enumeration

The provisioning state of a run.

Value	Description
Canceled
Creating
Deleting
Failed
Succeeded
Updating

ResourceIdentityType

Enumeration

The identity type.

Value	Description
None
SystemAssigned
SystemAssigned, UserAssigned
UserAssigned

SecretObject

Object

Describes the properties of a secret object value.

Name	Type	Description
type	SecretObjectType	The type of the secret object which determines how the value of the secret object has to be interpreted.
value	string	The value of the secret. The format of this value will be determined based on the type of the secret object. If the type is Opaque, the value will be used as is without any modification.

SecretObjectType

Enumeration

The type of the secret object which determines how the value of the secret object has to be interpreted.

Value	Description
Opaque
Vaultsecret

SetValue

Object

The properties of a overridable value that can be passed to a task template.

Name	Type	Default value	Description
isSecret	boolean	False	Flag to indicate whether the value represents a secret or not.
name	string		The name of the overridable value.
value	string		The overridable value.

SourceControlType

Enumeration

The type of source control service.

Value	Description
Github
VisualStudioTeamService

SourceProperties

Object

The properties of the source code repository.

Name	Type	Description
branch	string	The branch name of the source code.
repositoryUrl	string	The full URL to the source code repository
sourceControlAuthProperties	AuthInfo	The authorization properties for accessing the source code repository and to set up webhooks for notifications.
sourceControlType	SourceControlType	The type of source control service.

SourceRegistryCredentials

Object

Describes the credential parameters for accessing the source registry.

Name	Type	Description
loginMode	SourceRegistryLoginMode	The authentication mode which determines the source registry login scope. The credentials for the source registry will be generated using the given scope. These credentials will be used to login to the source registry during the run.

SourceRegistryLoginMode

Enumeration

The authentication mode which determines the source registry login scope. The credentials for the source registry will be generated using the given scope. These credentials will be used to login to the source registry during the run.

Value	Description
Default
None

SourceTrigger

Object

The properties of a source based trigger.

Name	Type	Default value	Description
name	string		The name of the trigger.
sourceRepository	SourceProperties		The properties that describes the source(code) for the task.
sourceTriggerEvents	SourceTriggerEvent[]		The source event corresponding to the trigger.
status	TriggerStatus	Enabled	The current status of trigger.

SourceTriggerEvent

Enumeration

The source event corresponding to the trigger.

Value	Description
commit
pullrequest

Task

Object

The task that has the ARM resource and task properties. The task will have all information to schedule a run against it.

Name	Type	Default value	Description
id	string		The resource ID.
identity	IdentityProperties		Identity for the resource.
location	string		The location of the resource. This cannot be changed after the resource is created.
name	string		The name of the resource.
properties.agentConfiguration	AgentProperties		The machine configuration of the run agent.
properties.creationDate	string		The creation date of task.
properties.credentials	Credentials		The properties that describes a set of credentials that will be used when this run is invoked.
properties.platform	PlatformProperties		The platform properties against which the run has to happen.
properties.provisioningState	ProvisioningState		The provisioning state of the task.
properties.status	TaskStatus		The current status of task.
properties.step	TaskStepProperties: DockerBuildStep EncodedTaskStep FileTaskStep		The properties of a task step.
properties.timeout	integer	3600	Run timeout in seconds.
properties.trigger	TriggerProperties		The properties that describe all triggers for the task.
tags	object		The tags of the resource.
type	string		The type of the resource.

TaskStatus

Enumeration

The current status of task.

Value	Description
Disabled
Enabled

TimerTrigger

Object

The properties of a timer trigger.

Name	Type	Default value	Description
name	string		The name of the trigger.
schedule	string		The CRON expression for the task schedule
status	TriggerStatus	Enabled	The current status of trigger.

TokenType

Enumeration

The type of Auth token.

Value	Description
OAuth
PAT

TriggerProperties

Object

The properties of a trigger.

Name	Type	Description
baseImageTrigger	BaseImageTrigger	The trigger based on base image dependencies.
sourceTriggers	SourceTrigger[]	The collection of triggers based on source code repository.
timerTriggers	TimerTrigger[]	The collection of timer triggers.

TriggerStatus

Enumeration

The current status of trigger.

Value	Description
Disabled
Enabled

UserIdentityProperties

Object

Name	Type	Description
clientId	string	The client id of user assigned identity.
principalId	string	The principal id of user assigned identity.

Variant

Enumeration

Variant of the CPU.

Value	Description
v6
v7
v8

Condividi tramite

Tasks - Get Details

URI Parameters

Responses

Security

azure_auth

Scopes

Examples

Tasks_GetDetails

Sample request

Sample response

Definitions

AgentProperties

Architecture

Argument

AuthInfo

BaseImageDependency

BaseImageDependencyType

BaseImageTrigger

BaseImageTriggerType

Credentials

CustomRegistryCredentials

DockerBuildStep

EncodedTaskStep

FileTaskStep

IdentityProperties

OS

PlatformProperties

ProvisioningState

ResourceIdentityType

SecretObject

SecretObjectType

SetValue

SourceControlType

SourceProperties

SourceRegistryCredentials

SourceRegistryLoginMode

SourceTrigger

SourceTriggerEvent

Task

TaskStatus

TimerTrigger

TokenType

TriggerProperties

TriggerStatus

UserIdentityProperties

Variant

Risorse aggiuntive